Импорт записей в контекстную таблицу
POST /api/v1/kuma/contextTables/import
Целевой коррелятор должен быть запущен.
Доступ: Главный администратор, Администратор тенанта, Аналитик второго уровня, Аналитик первого уровня.
Параметры запроса (URL Query)
Имя | Тип данных | Обязательное ли поле | Описание | Пример значения |
correlatorID | Строка | Да | Идентификатор сервиса коррелятора | 00000000-0000-0000-0000-000000000000 |
contextTableID | Строка | Если не указан contextTableName | Идентификатор контекстной таблицы. | 00000000-0000-0000-0000-000000000000 |
contextTableName | Строка | Если не указан contextTableID | Имя контекстной таблицы | Attackers |
format | Строка | Да | Формат импортируемых записей | CSV, TSV, internal |
clear | bool | Нет | Очистить контекстную таблицу перед выполнением импорта. Если параметр присутствует в URL query, его значение принимается как true. Указанные пользователем значения игнорируются. | /api/v1/contextTables/import?clear |
Тело запроса
Формат | Содержание |
CSV | Первая строка - заголовок, где перечислены поля, разделенные запятой. Остальные строки - значения, соответствующие полям в заголовке, разделенные запятой. Количество полей на каждой строке должно быть одинаковым и должно соответствовать количеству полей в схеме контекстной таблицы. Значения списочных полей разделяются символом "|". Например, значение списочного поля целочисленного типа - 1|2|3. |
TSV | Первая строка - заголовок, где перечислены поля, разделенные TAB. Остальные строки - значения, соответствующие полям в заголовке, разделенные TAB. Количество полей на каждой строке должно быть одинаковым и должно соответствовать количеству полей в схеме контекстной таблицы. Значения списочных полей разделяются символом "|". |
internal | Каждая строка содержит один индивидуальный объект JSON. Данные в internal формате можно получить путем экспорта содержимого контекстной таблицы из коррелятора в консоли KUMA. |
Действие по реагированию
HTTP-код: 204
Возможные ошибки
HTTP-код | Описание | Значение поля | Значение поля |
---|---|---|---|
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 | Пользователю не присвоена необходимая роль в тенанте коррелятора. | Доступ запрещен. | - |
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 | Любая другая внутренняя ошибка. | Переменная. | Переменная. |