Импорт записей в контекстную таблицу

POST /api/v2/contextTables/import

Целевой коррелятор должен быть запущен.

Доступ: Главный администратор, Администратор тенанта, Аналитик второго уровня, Аналитик первого уровня (может импортировать данные в любую таблицу коррелятора доступного тенанта, даже если контекстная таблица, создана в Общем тенанте).

Параметры запроса (URL Query)

Имя

Тип данных

Обязательный

Описание

Пример значения

correlatorID

string

Да

Идентификатор сервиса коррелятора

00000000-0000-0000-0000-000000000000

contextTableID

string

Если не указан contextTableName

Идентификатор контекстной таблицы

00000000-0000-0000-0000-000000000000

contextTableName

string

Если не указан contextTableID

Имя контекстной таблицы

Attackers

format

string

Да

Формат импортируемых записей

CSV, TSV, internal

clear

bool

Нет

Очистить контекстную таблицу перед выполнением импорта. Если параметр присутствует в URL query, его значение принимается как true. Указанные пользователем значения игнорируются.

/api/v2/contextTables/import?clear

Тело запроса

Формат

Содержимое

CSV

Первая строка - заголовок, где перечислены поля, разделенные запятой. Остальные строки - значения, соответствующие полям в заголовке, разделенные запятой. Количество полей на каждой строке должно быть одинаковым и должно соответствовать количеству полей в схеме контекстной таблицы. Значения списочных полей разделяются символом "|". Например, значение списочного поля целочисленного типа - 1|2|3.

TSV

Первая строка - заголовок, где перечислены поля, разделенные TAB. Остальные строки - значения, соответствующие полям в заголовке, разделенные TAB. Количество полей на каждой строке должно быть одинаковым и должно соответствовать количеству полей в схеме контекстной таблицы. Значения списочных полей разделяются символом "|".

internal

Каждая строка содержит один индивидуальный объект JSON. Данные в internal формате можно получить путем экспорта содержимого контекстной таблицы из коррелятора в веб-консоли KUMA.

Ответ

HTTP-код: 204

Возможные ошибки

HTTP-код

Описание

Значение поля message

Значение поля details

400

Не указан идентификатор сервиса коррелятора.

query parameter required

correlatorID

400

Не указан ни параметр contextTableID, ни параметр contextTableName.

one of query parameters required

contextTableID, contextTableName

400

Не указан параметр format.

query parameter required

format

400

Параметр format имеет неверное значение.

invalid query parameter value

format

400

Тело запроса имеет нулевую длину.

request body required

-

400

Ошибка парсинга тела запроса, а том числе соответствие схеме контекстной таблицы наименования полей и типов импортируемой записи.

correlator API request failed

вариативное

403

Пользователь не имеет необходимой роли в тенанте коррелятора.

access denied

-

404

Сервис с указанным идентификатором correlatorID не найден.

service not found

-

404

Контекстная таблица не найдена.

context table not found

-

406

Сервис с указанным идентификатором correlatorID не является коррелятором.

service is not correlator

-

406

Коррелятор не выполнил первый запуск.

service not paired

-

406

Тенант коррелятора отключен.

tenant disabled

-

406

Поиск контекстной таблицы выполнялся по имени contextTableName и было найдено более одной контекстной таблицы.

more than one matching context tables found

-

50x

Не удалось обратиться к API коррелятора.

correlator API request failed

вариативное

500

Ошибка подготовки данных для импорта в сервис коррелятора.

context table process import request failed

вариативное

500

Любые другие внутренние ошибки.

вариативное

вариативное

В начало