Создание настройки идентификации активов
Запрос
| Тип | Метод |
|---|---|
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 Request2. missing uid header3. Pgr-User-Id should be uuid format4. empty name5. exceeded maximum length for a value6. empty strategy7. invalid strategy …8. empty ranges9. invalid range format |
1. Неверный тип параметра запроса, либо отсутствует обязательный параметр 2. Не передан заголовок Pgr-User-ID 3. Недопустимый формат Pgr-User-ID 4. Поле name не может быть пустым5. Превышена максимальная длина поля name6. Поле strategy не может быть пустым7. Недопустимое значение поля strategy8. Поле 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
}