Spec-Zone.ru › AWS CLI v2

[ aws . kendra ]

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 (строка)

Идентификатор индекса, в который нужно добавить документы. Идентификатор индекса возвращается API CreateIndex.

--document-info-list (список)

Список объектов DocumentInfo, которые идентифицируют документы, для которых нужно получить состояние. Вы идентифицируете документы по их идентификатору документа и необязательным атрибутам.

(структура)

Идентифицирует документ, для которого нужно получить информацию о состоянии

DocumentId -> (строка)

Идентификатор документа.

Attributes -> (список)

Атрибуты, которые идентифицируют конкретную версию документа для проверки.

Допустимыми атрибутами являются:

  • version
  • datasourceId
  • jobExecutionId

Атрибуты подчиняются следующим правилам:

  • dataSourceId и jobExecutionId должны использоваться вместе.
  • version игнорируется, если dataSourceId и jobExecutionId не указаны.
  • Если dataSourceId и jobExecutionId указаны, но version нет, версия по умолчанию устанавливается в «0».

(структура)

Атрибут или поле метаданных документа. Чтобы создать пользовательские атрибуты документов, см. Пользовательские атрибуты.

Key -> (строка)

Идентификатор атрибута.

Value -> (структура)

Значение атрибута.

StringValue -> (строка)

Строка, например, «department».

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 -> (строка)

Указывает, что API не смог получить состояние документа. Это может быть связано с тем, что запрос не является корректным или есть системная ошибка.

DocumentStatusList -> (список)

Состояние документов. Состояние указывает, ожидает ли документ индексации, находится ли он в процессе индексации, завершил ли индексацию или индексация завершилась с ошибкой. Если индексация документа завершилась ошибкой, состояние содержит причину ошибки.

(структура)

Предоставляет информацию о состоянии документов, отправленных на индексацию.

DocumentId -> (строка)

Идентификатор документа.

DocumentStatus -> (строка)

Текущее состояние документа.

Если документ был отправлен на удаление, состояние будет NOT_FOUND после удаления документа.

FailureCode -> (строка)

Указывает источник ошибки.

FailureReason -> (строка)

Предоставляет подробную информацию о причинах, по которым документ не удалось проиндексировать. Используйте эту информацию, чтобы исправить ошибку перед повторной отправкой документа на индексацию.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API