batch-get-document-status
Описание
Возвращает состояние индексации одного или нескольких документов, отправленных с помощью API BatchPutDocument.
При использовании API BatchPutDocument документы индексируются асинхронно. Вы можете использовать API BatchGetDocumentStatus, чтобы получить текущее состояние списка документов и определить, были ли они успешно индексированы.
Вы также можете использовать API BatchGetDocumentStatus для проверки состояния API BatchDeleteDocument. Когда документ удаляется из индекса, Amazon Kendra возвращает значение NOT_FOUND в качестве состояния.
См. также: документацию AWS API
Синтаксис
batch-get-document-status
--index-id <value>
--document-info-list <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--index-id (строка)
--document-info-list (список)
Список объектов DocumentInfo, которые идентифицируют документы, для которых нужно получить состояние. Вы идентифицируете документы по их идентификатору документа и необязательным атрибутам.
(структура)
Идентифицирует документ, для которого нужно получить информацию о состоянии
DocumentId -> (строка)
Attributes -> (список)
Атрибуты, которые идентифицируют конкретную версию документа для проверки.
Допустимыми атрибутами являются:
- version
- datasourceId
- jobExecutionId
Атрибуты подчиняются следующим правилам:
-
dataSourceIdиjobExecutionIdдолжны использоваться вместе. -
versionигнорируется, еслиdataSourceIdиjobExecutionIdне указаны. - Если
dataSourceIdиjobExecutionIdуказаны, ноversionнет, версия по умолчанию устанавливается в «0».
(структура)
Атрибут или поле метаданных документа. Чтобы создать пользовательские атрибуты документов, см. Пользовательские атрибуты.
Key -> (строка)
Value -> (структура)
Значение атрибута.
StringValue -> (строка)
StringListValue -> (список)
Список строк. Максимальная длина или количество строк по умолчанию составляет 10.
(строка)
LongValue -> (целое число)
DateValue -> (метка времени)
Дата, представленная в формате ISO 8601.
Важно включить часовой пояс в формате даты-времени ISO 8601. Например, 2012-03-25T12:30:10+01:00 — это формат даты-времени ISO 8601 для 25 марта 2012 года в 12:30 (плюс 10 секунд) по Центральноевропейскому времени.
Синтаксис JSON:
[
{
"DocumentId": "string",
"Attributes": [
{
"Key": "string",
"Value": {
"StringValue": "string",
"StringListValue": ["string", ...],
"LongValue": long,
"DateValue": timestamp
}
}
...
]
}
...
]
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы указаны в командной строке, эти значения переопределят значения, полученные из JSON. Невозможно передавать произвольные двоичные данные с помощью значения, предоставленного в JSON, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит каркас JSON в стандартный вывод без отправки запроса к API. Если предоставлено значение без значения или значение input, выводится пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, он выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, оно валидирует входные данные команд и возвращает пример выходного JSON для этой команды. Сгенерированный каркас JSON не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном каркасе JSON.
Глобальные параметры
--debug (булево)
Включить отладочную регистрацию.
--endpoint-url (строка)
Переопределить стандартный URL команды заданным URL.
--no-verify-ssl (булево)
По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение по умолчанию проверки сертификатов SSL.
--no-paginate (булево)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования выходных данных команды.
- json
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для использования в фильтрации данных ответа.
--profile (строка)
Использование определенного профиля из файла учетных данных.
--region (строка)
Используемый регион. Переопределяет настройки конфигурации/окружения.
--version (строка)
Отображение версии этого инструмента.
--color (строка)
Включить/отключить вывод цветного текста.
- on
- off
- auto
--no-sign-request (булево)
Не подписывать запросы. Учетные данные не будут загружены, если этот параметр указан.
--ca-bundle (строка)
Файл с пакетом сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/окружения.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться без блокировки и без таймаута. Значение по умолчанию составляет 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться без блокировки и без таймаута. Значение по умолчанию составляет 60 секунд.
--cli-binary-format (строка)
Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 предполагает, что двоичные блоки предоставляются как закодированная строка base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, fileb:// всегда будет обрабатываться как двоичное и использовать содержимое файла непосредственно независимо от параметра cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного параметра cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (булево)
Отключить вывод страницы кли для вывода.
--cli-auto-prompt (булево)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (булево)
Отключить автоматическое запросы параметров ввода CLI.
Выходные данные
Errors -> (список)
Список документов, для которых Amazon Kendra не смог получить состояние. Список включает идентификатор документа и причину, по которой состояние не было найдено.
(структура)
Предоставляет ответ, когда состояние документа не может быть получено.
DocumentId -> (строка)
DataSourceId -> (строка)
ErrorCode -> (строка)
ErrorMessage -> (строка)
DocumentStatusList -> (список)
Состояние документов. Состояние указывает, ожидает ли документ индексации, находится ли он в процессе индексации, завершил ли индексацию или индексация завершилась с ошибкой. Если индексация документа завершилась ошибкой, состояние содержит причину ошибки.
(структура)
Предоставляет информацию о состоянии документов, отправленных на индексацию.
DocumentId -> (строка)
DocumentStatus -> (строка)
Текущее состояние документа.
Если документ был отправлен на удаление, состояние будет NOT_FOUND после удаления документа.
FailureCode -> (строка)
FailureReason -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.