[ aws . comprehend ]
describe-document-classification-job
Описание
Получает свойства, связанные с задачей классификации документов. Используйте эту операцию, чтобы получить статус задачи классификации.
См. также: Документация API AWS
Синтаксис
describe-document-classification-job
--job-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]
Параметры
--job-id (строка)
StartDocumentClassificationJob операция возвращает этот идентификатор в своём ответе.--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.
--cli-auto-prompt (логическое)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (логическое)
Отключить автоматическую запрос параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров вам необходимо установить и настроить AWS CLI. Дополнительная информация приведена в руководстве по началу работы в руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования, характерные для Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. раздел Использование кавычек со строками в руководстве пользователя AWS CLI.
Для описания задачи классификации документов
Следующий describe-document-classification-job пример получает свойства асинхронной задачи классификации документов.
aws comprehend describe-document-classification-job \
--job-id 123456abcdeb0e11022f22a11EXAMPLE
Вывод:
{
"DocumentClassificationJobProperties": {
"JobId": "123456abcdeb0e11022f22a11EXAMPLE",
"JobArn": "arn:aws:comprehend:us-west-2:111122223333:document-classification-job/123456abcdeb0e11022f22a11EXAMPLE",
"JobName": "exampleclassificationjob",
"JobStatus": "COMPLETED",
"SubmitTime": "2023-06-14T17:09:51.788000+00:00",
"EndTime": "2023-06-14T17:15:58.582000+00:00",
"DocumentClassifierArn": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/mymodel/version/1",
"InputDataConfig": {
"S3Uri": "s3://amzn-s3-demo-bucket/jobdata/",
"InputFormat": "ONE_DOC_PER_LINE"
},
"OutputDataConfig": {
"S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-CLN-123456abcdeb0e11022f22a11EXAMPLE/output/output.tar.gz"
},
"DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-servicerole"
}
}
Дополнительную информацию см. в разделе Настройка классификации в Руководстве разработчика Amazon Comprehend.
Вывод
DocumentClassificationJobProperties -> (структура)
Объект, описывающий свойства задания классификации документов.
JobId -> (строка)
JobArn -> (строка)
Amazon Resource Name (ARN) задания классификации документов. Это уникальный, полностью квалифицированный идентификатор задания. Он включает в себя учетную запись Amazon Web Services, регион Amazon Web Services и идентификатор задания. Формат ARN следующий:
arn:<partition>:comprehend:<region>:<account-id>:document-classification-job/<job-id>Вот пример ARN задания:
arn:aws:comprehend:us-west-2:111122223333:document-classification-job/1234abcd12ab34cd56ef1234567890abJobName -> (строка)
JobStatus -> (строка)
FAILED, поле Message отображает причину сбоя.Message -> (строка)
SubmitTime -> (отметка времени)
EndTime -> (отметка времени)
DocumentClassifierArn -> (строка)
InputDataConfig -> (структура)
Настройка входных данных, предоставленная при создании задания классификации документов.
S3Uri -> (строка)
Amazon S3 URI для входных данных. URI должен находиться в том же регионе, что и вызываемый API-точкой. URI может указывать на один входной файл или префикс для набора файлов данных.
Например, если используется URI S3://bucketName/prefix , если префикс — это единственный файл, Amazon Comprehend использует этот файл в качестве входных данных. Если более одного файла начинается с указанного префикса, Amazon Comprehend использует все эти файлы в качестве входных данных.
InputFormat -> (строка)
Указывает, как должен обрабатываться текст в входном файле:
-
ONE_DOC_PER_FILE— Каждый файл считается отдельным документом. Используйте этот параметр при обработке больших документов, таких как статьи газет или научные работы. -
ONE_DOC_PER_LINE— Каждая строка в файле считается отдельным документом. Используйте этот параметр при обработке многих коротких документов, например, текстовых сообщений.
DocumentReaderConfig -> (структура)
Предоставляет параметры конфигурации для переопределения стандартных действий по извлечению текста из PDF-документов и файлов изображений.
DocumentReadAction -> (строка)
Это поле определяет операцию API Amazon Textract, которую Amazon Comprehend использует для извлечения текста из PDF-файлов и файлов изображений. Введите одно из следующих значений:
-
TEXTRACT_DETECT_DOCUMENT_TEXT— Сервис Amazon Comprehend использует операцию APIDetectDocumentText. -
TEXTRACT_ANALYZE_DOCUMENT— Сервис Amazon Comprehend использует операцию APIAnalyzeDocument.
DocumentReadMode -> (строка)
Определяет действия по извлечению текста для PDF-файлов. Введите одно из следующих значений:
-
SERVICE_DEFAULT— используйте стандартные настройки сервиса Amazon Comprehend для PDF-файлов. -
FORCE_DOCUMENT_READ_ACTION— Amazon Comprehend использует API Textract, указанный в DocumentReadAction, для всех PDF-файлов, включая цифровые PDF-файлы.
FeatureTypes -> (список)
Указывает тип функций Amazon Textract, которые следует применить. Если вы выбрали TEXTRACT_ANALYZE_DOCUMENT в качестве действия чтения, вы должны указать одно или оба из следующих значений:
-
TABLES— Возвращает дополнительную информацию о любых таблицах, обнаруженных в документе. -
FORMS— Возвращает дополнительную информацию о любых формах, обнаруженных в документе.
(строка)
OutputDataConfig -> (структура)
Настройка выходных данных, предоставленная при создании задания классификации документов.
S3Uri -> (строка)
При использовании объекта OutputDataConfig с асинхронными операциями вы указываете расположение Amazon S3, в котором вы хотите записать выходные данные. URI должен находиться в том же регионе, что и вызываемый API-точкой. Это расположение используется в качестве префикса для фактического расположения выходного файла.
По завершении задания обнаружения темы сервис создает выходной файл в каталоге, специфичном для задания. Поле S3Uri содержит расположение выходного файла, называемого output.tar.gz . Это сжатый архив, содержащий результат операции.
Для задания обнаружения сущностей PII выходной файл представляет собой обычный текст, а не сжатый архив. Имя выходного файла такое же, как имя входного файла, с добавленным .out в конце.
KmsKeyId -> (строка)
Идентификатор ключа службы управления ключами Amazon Web Services (KMS), который Amazon Comprehend использует для шифрования результатов анализа задания. Укажите идентификатор симметричного ключа, так как асимметричный ключ нельзя использовать для загрузки данных в S3.
KmsKeyId может иметь один из следующих форматов:
- Идентификатор ключа KMS:
"1234abcd-12ab-34cd-56ef-1234567890ab" - Amazon Resource Name (ARN) ключа KMS:
"arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" - Псевдоним ключа KMS:
"alias/ExampleAlias" - ARN псевдонима ключа KMS:
"arn:aws:kms:us-west-2:111122223333:alias/ExampleAlias"
DataAccessRoleArn -> (строка)
VolumeKmsKeyId -> (строка)
Идентификатор ключа службы управления ключами Amazon Web Services (KMS), который Amazon Comprehend использует для шифрования данных на томе хранилища, подключенном к виртуальным машинам ML, обрабатывающим задание анализа. VolumeKmsKeyId может иметь один из следующих форматов:
- Идентификатор ключа KMS:
"1234abcd-12ab-34cd-56ef-1234567890ab" - Amazon Resource Name (ARN) ключа KMS:
"arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
VpcConfig -> (структура)
Параметры конфигурации для частного виртуального частного облака (VPC), содержащего ресурсы, которые вы используете для задания классификации документов. Дополнительные сведения см. в разделе Amazon VPC.
SecurityGroupIds -> (список)
Идентификатор группы безопасности на экземпляре вашего частного VPC. Группы безопасности в вашем VPC выполняют функции виртуального брандмауэра, контролируя входящий и исходящий трафик и обеспечивая безопасность ресурсов, к которым вы будете обращаться в VPC. Этот идентификатор начинается с "sg-", например: "sg-03b388029b0a285ea". Дополнительные сведения см. в разделе Группы безопасности для вашего VPC.
(строка)
Subnets -> (список)
Идентификатор каждого подсети, используемого в вашем частном VPC. Эта подсеть является подмножеством диапазона адресов IPv4, используемых VPC, и относится к конкретной зоне доступности в регионе VPC. Этот идентификатор начинается с "subnet-", например: "subnet-04ccf456919e69055". Дополнительные сведения см. в разделе VPC и подсети.
(строка)
FlywheelArn -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.