Перейти к содержанию

Создание настройки идентификации активов

Запрос

Тип Метод
POST /asset_lookup_confs/create

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

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

POST
http://127.0.0.1/cruddy/v2/asset_lookup_confs/create

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

Параметр Тип Обязательность Описание
name string Required Название настройки
ranges Array<string> Required Диапазоны IP-адресов. Маски подсетей в CIDR-нотации.

При создании/изменении можно указать IP-адрес вместо CIDR
strategy string Required Стратегия идентификации актива:
- ip;
- fqdn;
- mac
Пример тела запроса

{
  "name": "string",
  "ranges": [
    "string"
  ],
  "strategy": "ip"
}

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

Статус код: 201 - успешное создание настройки.

Формат: JSON.

Тело ответа: модель созданной настройки идентификации активов.

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

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "created_at": "2023-12-20T00:00:01.652259Z",
  "updated_at": "2023-12-20T00:00:01.652259Z",
  "name": "string",
  "ranges": [
    "string"
  ],
  "strategy": "ip",
  "_relations": {}
}

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

Код Ответ Описание
400 1. Bad Request
2. missing uid header
3. Pgr-User-Id should be uuid format
4. empty name
5. exceeded maximum length for a value
6. empty strategy
7. invalid strategy …
8. empty ranges
9. invalid range format
1. Неверный тип параметра запроса, либо отсутствует обязательный параметр
2. Не передан заголовок Pgr-User-ID
3. Недопустимый формат Pgr-User-ID
4. Поле name не может быть пустым
5. Превышена максимальная длина поля name
6. Поле strategy не может быть пустым
7. Недопустимое значение поля strategy
8. Поле ranges не может быть пустым
9. Недопустимое значение в массиве ranges
409 Bad Request Попытка создать отчёт с существующим именем
500 Internal Server Error Другие ошибки при удалении объектов

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

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

Код 400

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

Код 409

{
  "error": "Bad Request",
  "error_code": 409,
  "extra": {
    "fields": [
      "name"
    ]
  }
}

Код 500

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