Устройства¶

Получение информации о всех устройствах¶

Описание¶

Этот запрос используется для получения информации о всех устройствах

Запрос¶

GET /api/peer/search/

Важно

По умолчанию установлено ограничение на получение информации об устройствах: не более 50 значений

Чтобы обойти ограничение, необходимо указать параметр limit: например /api/peer/search/?limit=3000

Ответ

{
    "items":
    [
        {
            "server_id": "string",
            "hostname": "string",
            "username": "string",
            "domain": "string",
            "platform": "string",
            "uname": "string",
            "version": "string",
            "addr": "string",
            "uuid": "string"
        }
    ]
}

Пример¶

curl --header 'Authorization: Token [TOKEN]' --location 'https://[SERVER_ADDR]/api/peer/search/?limit=3000'

Получение информации о устройстве¶

Описание¶

Этот запрос используется для получения информации о устройстве по имени хоста. Нужно передать желаемое значение в параметре hostname для получения информации

Важно

Параметр hostname должен содержать имя хоста. В ответе вернется информация о устройстве

Запрос¶

GET /api/peer/search/?hostname=[HOSTNAME]

Ответ

{
    "items":
    [
        {
            "server_id": "string",
            "hostname": "string",
            "username": "string",
            "domain": "string",
            "platform": "string",
            "uname": "string",
            "version": "string",
            "addr": "string",
            "uuid": "string"
        }
    ]
}

Пример¶

curl --header 'Authorization: Token [TOKEN]' --location 'https://[SERVER_ADDR]/api/peer/search/?hostname=[HOSTNAME]'

Получение информации о ресурсах устройства¶

Описание¶

Этот запрос используется для получения информации о ресурсах устройства по имени хоста. Нужно передать желаемое значение в параметре hostname для получения информации

Важно

Параметр hostname должен содержать имя хоста. В ответе вернется информация о ресурсах устройства
Доступны фильтра: exclude — для исключения указанных типов ресурса
- hardware
- software
- user
- group
- os

Запрос¶

GET /api/assets/search/?hostname=[HOSTNAME]

Ответ

{
    "hardware": [
        "ACR Acer Technologies 59659"
    ],
    "software": [
        "code 1.99.2-1744250061",
        "perl 5.38.2-3.2ubuntu0.1"
    ],
    "user": [
        "rudesktop"
    ],
    "group": [
        "Группа с правами администратора: rudesktop"
    ],
    "os": [
        "Ubuntu 24.04"
    ]
}

Пример¶

Получение всех ресурсов устройства

curl --header 'Authorization: Token [TOKEN]' --location 'https://[SERVER_ADDR]/api/assets/search/?hostname=[HOSTNAME]'

Получение всех ресурсов устройства, кроме оборудования

curl --header 'Authorization: Token [TOKEN]' --location 'https://[SERVER_ADDR]/api/assets/search/?hostname=[HOSTNAME]&exclude=hardware'