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

Создание маппинга

Запрос

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

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

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

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

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

Параметр Тип данных Обязательность Описание
field_path string Required Путь поля
type string Required Тип поля.. Допустимые значения: group, keyword, date.
Тип date поддерживает все форматы времени, согласно стандарту ISO 8601.
extra string Optional
is_error boolean Required Флаг: используется ли поле в шаблоне события со статусом “Ошибка”
is_parsed boolean Required Флаг: используется ли поле в шаблоне события со статусом  “Разобрано”
is_normalized boolean Required Флаг: используется ли поле в шаблоне события со статусом “Нормализовано”
user_title string Optional Название маппинга
user_description string Optional Описание маппинга
trace_id string Optional Идентификатор трассировки действия пользователя для аудита
Пример тела запроса

{
  "field_path": "string",
  "type": "keyword",
  "extra": "string",
  "is_error": true,
  "is_parsed": true,
  "is_normalized": true,
  "user_title": "string",
  "user_description": "string",
  "trace_id": "uuid"
}

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

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

Формат: JSON.

Тело ответа: модель созданного маппинга.

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

{
  "id": "uuid",
  "field": "string",
  "field_path": "string",
  "path": "string",
  "type": "group",
  "extra": "string",
  "is_error": true,
  "is_parsed": true,
  "is_normalized": true,
  "user_title": "string",
  "user_description": "string",
  "created_at": "2023-12-20T00:00:01.652259Z",
  "updated_at": "2023-12-20T00:00:01.652259Z",
  "trace_id": "uuid"
}

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

Код Ответ Описание
400 Bad Request Неверный тип параметра запроса, либо отсутствует обязательный параметр
409 name_already_used Попытка создать маппинг с существующим field_path
500 Internal Server Error Другие ошибки при создании объекта

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

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

Код 400

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

Код 409

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

Код 500

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