Spec-Zone.ru › AWS CLI v2

[ aws . textract ]

Запуск распознавания текста в документе

Описание

Запускает асинхронное распознавание текста в документе. Amazon Textract может распознавать строки текста и слова, составляющие строку текста.

StartDocumentTextDetection может анализировать текст в документах форматов JPEG, PNG, TIFF и PDF. Документы хранятся в ведре Amazon S3. Используйте DocumentLocation для указания имени ведра и имени файла документа.

StartTextDetection возвращает идентификатор задания (JobId ), который используется для получения результатов операции. По завершении распознавания текста Amazon Textract публикует статус завершения в тему Amazon Simple Notification Service (Amazon SNS), которую вы указали в NotificationChannel. Чтобы получить результаты операции распознавания текста, сначала проверьте, что значение статуса, опубликованное в тему Amazon SNS, равно SUCCEEDED. В этом случае вызовите GetDocumentTextDetection и передайте идентификатор задания (JobId) из первоначального вызова StartDocumentTextDetection.

Дополнительную информацию см. в разделе Распознавание текста в документе.

См. также: Документация API AWS

Синтаксис

  start-document-text-detection
--document-location <value>
[--client-request-token <value>]
[--job-tag <value>]
[--notification-channel <value>]
[--output-config <value>]
[--kms-key-id <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]

Параметры

--document-location (структура)

Расположение обрабатываемого документа.

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

Ведро Amazon S3, содержащее входной документ.

Bucket -> (строка)

Имя ведра S3. Обратите внимание, что символ # недопустим в имени файла.

Name -> (строка)

Имя файла входного документа. Синхронные операции могут использовать файлы изображений форматов JPEG или PNG. Асинхронные операции также поддерживают файлы форматов PDF и TIFF.

Version -> (строка)

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

Сокращенный синтаксис:

S3Object={Bucket=string,Name=string,Version=string}

Синтаксис JSON:

{
  "S3Object": {
    "Bucket": "string",
    "Name": "string",
    "Version": "string"
  }
}

--client-request-token (строка)

Идемпотентный маркер, используемый для идентификации запроса на запуск. Если вы используете один и тот же маркер с несколькими запросами StartDocumentTextDetection, возвращается то же JobId. Используйте ClientRequestToken для предотвращения случайного запуска одного и того же задания более одного раза. Дополнительную информацию см. в разделе Вызов асинхронных операций Amazon Textract.

--job-tag (строка)

Идентификатор, который вы указываете и который включается в уведомление о завершении, опубликованное в тему Amazon SNS. Например, вы можете использовать JobTag для идентификации типа документа, которому соответствует уведомление о завершении (например, налоговая декларация или квитанция).

--notification-channel (структура)

ARN темы Amazon SNS, в которую Amazon Textract должен публиковать статус завершения операции.

SNSTopicArn -> (строка)

Тема Amazon SNS, в которую Amazon Textract публикует статус завершения.

RoleArn -> (строка)

Amazon Resource Name (ARN) IAM-роли, предоставляющей Amazon Textract права публикации в тему Amazon SNS.

Сокращенный синтаксис:

SNSTopicArn=string,RoleArn=string

Синтаксис JSON:

{
  "SNSTopicArn": "string",
  "RoleArn": "string"
}

--output-config (структура)

Устанавливает, будет ли вывод направлен в ведро, определенное клиентом. По умолчанию Amazon Textract сохранит результаты во внутренней системе для доступа с помощью операции GetDocumentTextDetection.

S3Bucket -> (строка)

Имя ведра, в которое будет направлен вывод.

S3Prefix -> (строка)

Префикс ключа объекта, в который будет сохранен вывод. Если не указано, префикс будет «textract_output».

Сокращенный синтаксис:

S3Bucket=string,S3Prefix=string

Синтаксис JSON:

{
  "S3Bucket": "string",
  "S3Prefix": "string"
}

--kms-key-id (строка)

Ключ KMS, используемый для шифрования результатов вывода. Он может быть представлен в формате ID ключа или псевдонима ключа. Когда предоставлен ключ KMS, этот ключ будет использоваться для шифрования объектов в ведре клиента. Если этот параметр не указан, результат будет зашифрован на стороне сервера с использованием SSE-S3.

--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 (boolean)

Включить отладочную запись в журнал.

--endpoint-url (string)

Переопределить стандартный URL команды указанным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого SSL-соединения AWS CLI проверяет сертификаты SSL. Этот параметр переопределяет стандартное поведение проверки сертификатов SSL.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использование определенного профиля из файла учетных данных.

--region (string)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (string)

Отображение версии этого инструмента.

--color (string)

Включение/отключение цветного вывода.

  • on
  • off
  • auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (string)

Файл с корневым сертификатом для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (string)

Стиль форматирования для двоичных блоков. По умолчанию используется формат 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 (boolean)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (boolean)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматическое запроса параметров ввода CLI.

Примеры

Примечание

Чтобы использовать следующие примеры, необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в руководстве пользователя AWS CLI.

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

Начало обнаружения текста в многостраничном документе

Следующий start-document-text-detection пример демонстрирует, как запустить асинхронное обнаружение текста в многостраничном документе.

Linux/macOS:

aws textract start-document-text-detection \
        --document-location '{"S3Object":{"Bucket":"bucket","Name":"document"}}' \
        --notification-channel "SNSTopicArn=arn:snsTopic,RoleArn=roleARN"

Windows:

aws textract start-document-text-detection \
    --document-location "{\"S3Object\":{\"Bucket\":\"bucket\",\"Name\":\"document\"}}" \
    --region region-name \
    --notification-channel "SNSTopicArn=arn:snsTopic,RoleArn=roleArn"

Вывод:

{
    "JobId": "57849a3dc627d4df74123dca269d69f7b89329c870c65bb16c9fd63409d200b9"
}

Дополнительную информацию см. в разделе Обнаружение и анализ текста в многостраничных документах в Руководстве разработчика Amazon Textract

Вывод

JobId -> (string)

Идентификатор задания обнаружения текста для документа. Используйте JobId для идентификации задания в последующем вызове GetDocumentTextDetection. Значение JobIdдействительно только в течение 7 дней.

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

Spec-Zone.ru

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