Обновление сервисов на активах

Запрос

Тип	Метод
`POST`	`/sonar/services/update`

Описание: При выполнении запроса по идентификатора актива будет найден сетевой интерфейс, на котором будет просканированы сервисы. По результатам сканирования:

Создаёт/обновляет сервисы.
Старые сервисы удаляются.
Возвращает массив сервисов, сгруппированных по сетевым интерфейсам и активам.

Пример запроса


POST
http://127.0.0.1/cruddy/v2/sonar/services/update

Тело запроса:

Параметр	Тип данных	Обязательность	Описание
service_asset_ids	`Array<string>`	Required	Массив идентификаторов активов

Пример тела запроса


{
  "service_asset_ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ]
}

Успешный ответ

Статус код: 200 – запрос успешно обработан.

Формат: JSON.

Параметры ответа:

Параметр	Тип данных	Описание
_	`Array`<AssetServiceScanResult>	Массив сервисов с информацией о хосте

Пример ответа


{
  "_": [
    {
      "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",
      "nicServices": [
        {
          "networkInterfaceId": "29d425c3-7721-4ca1-9d9e-271f2746c0b6",
          "os": "string",
          "services": [
            {
              "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
              "created_at": "2023-12-20T00:00:01.652259Z",
              "updated_at": "2023-12-20T00:00:01.652259Z",
              "network_interface_id": "bec51eeb-07af-41bd-b9be-258f3c6716f0",
              "port": 0,
              "status": "string",
              "type": "string",
              "name": "string",
              "version": "string",
              "cpe": "cpe:/o:linux:kernel"
            }
          ],
          "error_code": 0,
          "error": "string"
        }
      ]
    }
  ]
}

Другие возможные ответы

Код	Ответ	Описание
`400`	`Bad Request` `empty service_asset_ids`	Неверный тип параметра запроса, либо отсутствует обязательный параметр Идентификаторы активов не заданы
`500`	`Internal Server Error`	Другие ошибки при удалении объектов

Примечание: Текст ошибки не фиксированный, может изменяться в зависимости от фактического ответа получателя запроса.

Пример ответа

   
Код 400   

{
  "error": "Bad Request",
  "error_code": 400
}



   
Код 500   

{
  "error": "Internal Server Error",
  "error_code": 500
}