[ aws . comprehend ]
describe-entities-detection-job
Описание
Получает свойства, связанные с задачей обнаружения сущностей. Используйте эту операцию, чтобы получить статус задачи обнаружения.
См. также: AWS API документацию
Синтаксис
describe-entities-detection-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 (строка)
StartEntitiesDetectionJob операция возвращает этот идентификатор в своём ответе.--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 (логическое значение)
Автоматический запрос параметров ввода командной строки.
--no-cli-auto-prompt (логическое значение)
Отключение автоматического запроса параметров ввода командной строки.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Подробную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.
Если не указано иное, во всех примерах используются правила цитирования, характерные для Unix-систем. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной среды. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.
Для описания задачи обнаружения сущностей
Следующий describe-entities-detection-job пример получает свойства асинхронной задачи обнаружения сущностей.
aws comprehend describe-entities-detection-job \
--job-id 123456abcdeb0e11022f22a11EXAMPLE
Вывод:
{
"EntitiesDetectionJobProperties": {
"JobId": "123456abcdeb0e11022f22a11EXAMPLE",
"JobArn": "arn:aws:comprehend:us-west-2:111122223333:entities-detection-job/123456abcdeb0e11022f22a11EXAMPLE",
"JobName": "example-entity-detector",
"JobStatus": "COMPLETED",
"SubmitTime": "2023-06-08T21:30:15.323000+00:00",
"EndTime": "2023-06-08T21:40:23.509000+00:00",
"InputDataConfig": {
"S3Uri": "s3://amzn-s3-demo-bucket/AsyncBatchJobs/",
"InputFormat": "ONE_DOC_PER_LINE"
},
"OutputDataConfig": {
"S3Uri": "s3://amzn-s3-demo-bucket/thefolder/111122223333-NER-123456abcdeb0e11022f22a11EXAMPLE/output/output.tar.gz"
},
"LanguageCode": "en",
"DataAccessRoleArn": "arn:aws:iam::12345678012:role/service-role/AmazonComprehendServiceRole-example-role"
}
}
Для получения дополнительной информации см. Раздел Асинхронный анализ для Amazon Comprehend insights в Руководстве разработчика Amazon Comprehend.
Вывод
EntitiesDetectionJobProperties -> (структура)
Объект, содержащий свойства, связанные с задачей обнаружения сущностей.
JobId -> (строка)
JobArn -> (строка)
Amazon Resource Name (ARN) задачи обнаружения сущностей. Это уникальный, полностью квалифицированный идентификатор задачи. Он включает учетную запись Amazon Web Services, регион Amazon Web Services и идентификатор задачи. Формат ARN следующий:
arn:<partition>:comprehend:<region>:<account-id>:entities-detection-job/<job-id>Вот пример ARN задачи:
arn:aws:comprehend:us-west-2:111122223333:entities-detection-job/1234abcd12ab34cd56ef1234567890abJobName -> (строка)
JobStatus -> (строка)
FAILED, поле Message показывает причину ошибки.Message -> (строка)
SubmitTime -> (метка времени)
EndTime -> (метка времени)
EntityRecognizerArn -> (строка)
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 Key Management Service (KMS), который Amazon Comprehend использует для шифрования результатов анализа задачи. Укажите ID ключа симметричного ключа, так как асимметричный ключ нельзя использовать для загрузки данных в 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"
LanguageCode -> (строка)
DataAccessRoleArn -> (строка)
VolumeKmsKeyId -> (строка)
Идентификатор ключа Amazon Web Services Key Management Service (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.