Описание: метод предназначен для обновления содержимого выгрузки. Все записи эталонной выгрузки будут удалены, и после этого добавится новая запись. Данный метод можно использовать для первичного наполнения.
Важно!
Наполнение должно иметь целое число строк, минимум 2 строки.
Минимальное количество колонок – 2.
Минимальный байтовый размер загружаемого контента – 128 байт.
Максимальный байтовый размер загружаемого контента – 2 ГБ.
Характеристики метода: POST, асинхронный.
Ресурс: xapi/etalonTable/{id}/content/replace.
Параметры:
- id – fingerprint_id редактируемого объекта.
Например: enatalonTable/0123456789ABCDEF/content/replce
Content-type тела запроса должно быть не application/json, а multipart/form-data (подробнее см.: https://ru.wikipedia.org/wiki/Multipart/form-data).
Content-Disposition, который будет содержать файл, должен иметь поле name со значением CONTENT и атрибут filename с названием файла с расширением TSV или CSV в зависимости от формата файла, разделенного Tab или запятыми соответственно.
Возможные значение ошибок поля CONTENT:
- not_valid – файл имеет неверную сигнатуру;
- not_allowed_file_extension – неразрешенное расширение файла, на данный момент разрешены 2 формата: TSV и CSV;
- too_long_size – слишком большой размер файла;
- duplicate – такой файл уже существует в системе.
В случае успеха – код возврата «200» и тело ответа:
{
"FINGERPRINT_ID": "string",
"TYPE": "string",
"SOURCE": "string",
"DISPLAY_NAME": "string",
"NOTE": "string",
"CONDITION_COLUMNS": "string",
"CREATE_DATE": "string",
"CHANGE_DATE": "string",
"STATUS": "string"
}
После получения кода возврата «200» нужно взять поле FINGERPRINT_ID и по нему проверять состояние выгрузки, пока статус не перейдет в состояние ready.
Важно!
Число ячеек в загружаемых строках должно совпадать со значением числа столбцов, которое было указано при создании выгрузки.
При удалении выгрузки через консоль TrafficMonitor она считается существующей до момента распространения конфигурации, т.е. с этой выгрузкой возможны операции обновления и добавления содержимого.
При загрузке «ошибочного» содержимого, т.е. содержимого, которое является дубликатом уже загруженной выгрузки (части выгрузки) или содержимого, строки которого содержат неправильное количество ячеек, весь эталонный объект получает невалидный статус. Внешняя подсистема должна перестать загружать такое содержимое и перейти к следующему содержимому. Загрузка корректного содержимого исправляет общий статус эталонного объекта. Некорректное содержимое никогда не попадает на модули анализа.