Spec-Zone.ru › AWS CLI v2

[ aws . comprehend ]

describe-key-phrases-detection-job

Описание

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

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

Синтаксис

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

Идентификатор, сгенерированный Amazon Comprehend для задачи. Этот идентификатор возвращается операцией StartKeyPhrasesDetectionJob в ответе.

--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-key-phrases-detection-job пример получает свойства асинхронной задачи определения ключевых фраз.

aws comprehend describe-key-phrases-detection-job \
    --job-id 123456abcdeb0e11022f22a11EXAMPLE

Вывод:

{
    "KeyPhrasesDetectionJobProperties": {
        "JobId": "69aa080c00fc68934a6a98f10EXAMPLE",
        "JobArn": "arn:aws:comprehend:us-west-2:111122223333:key-phrases-detection-job/69aa080c00fc68934a6a98f10EXAMPLE",
        "JobName": "example-key-phrases-detection-job",
        "JobStatus": "COMPLETED",
        "SubmitTime": 1686606439.177,
        "EndTime": 1686606806.157,
        "InputDataConfig": {
            "S3Uri": "s3://dereksbucket1001/EventsData/",
            "InputFormat": "ONE_DOC_PER_LINE"
        },
        "OutputDataConfig": {
            "S3Uri": "s3://dereksbucket1002/testfolder/111122223333-KP-69aa080c00fc68934a6a98f10EXAMPLE/output/output.tar.gz"
        },
        "LanguageCode": "en",
        "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-testrole"
    }
}

Дополнительную информацию см. в разделе Асинхронный анализ для Amazon Comprehend Insights в руководстве разработчика Amazon Comprehend.

Вывод

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

Объект, содержащий свойства, связанные с задачей обнаружения ключевых фраз.

JobId -> (строка)

Идентификатор, присвоенный задаче обнаружения ключевых фраз.

JobArn -> (строка)

Amazon Resource Name (ARN) задачи обнаружения ключевых фраз. Это уникальный, полностью квалифицированный идентификатор задачи. Он включает учетную запись Amazon Web Services, регион Amazon Web Services и идентификатор задачи. Формат ARN следующий:

arn:<partition>:comprehend:<region>:<account-id>:key-phrases-detection-job/<job-id>

Следующий пример ARN задачи:

arn:aws:comprehend:us-west-2:111122223333:key-phrases-detection-job/1234abcd12ab34cd56ef1234567890ab

JobName -> (строка)

Имя, присвоенное задаче обнаружения ключевых фраз.

JobStatus -> (строка)

Текущий статус задачи обнаружения ключевых фраз. Если статус FAILED , поле Message отображает причину сбоя.

Message -> (строка)

Описание статуса задачи.

SubmitTime -> (временная метка)

Время подачи задачи обнаружения ключевых фраз на обработку.

EndTime -> (временная метка)

Время завершения задачи обнаружения ключевых фраз.

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 использует операцию API DetectDocumentText .
  • TEXTRACT_ANALYZE_DOCUMENT - Сервис Amazon Comprehend использует операцию API AnalyzeDocument .

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 - Возвращает дополнительную информацию о любых формах, обнаруженных в входном документе.

(строка)

TABLES или FORMS

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

Конфигурация выходных данных, предоставленная при создании задачи обнаружения ключевых фраз.

S3Uri -> (строка)

При использовании объекта OutputDataConfig с асинхронными операциями вы указываете расположение Amazon S3, где вы хотите записать выходные данные. URI должен находиться в том же регионе, что и вызываемый API-точку. Расположение используется в качестве префикса для фактического расположения выходного файла.

Когда задача обнаружения тем завершена, служба создает выходной файл в каталоге, специфичном для задачи. Поле S3Uri содержит расположение выходного файла, называемого output.tar.gz . Это сжатый архив, содержащий результат операции.

Для задачи обнаружения сущностей PII выходной файл является текстовым, а не сжатым архивом. Имя выходного файла такое же, как имя входного файла, с добавленным .out в конце.

KmsKeyId -> (строка)

ID ключа Amazon Web Services Key Management Service (KMS), который Amazon Comprehend использует для шифрования результатов анализа задачи. Укажите ID ключа симметричного ключа, так как асимметричный ключ не может быть использован для загрузки данных в S3.

KmsKeyId может иметь один из следующих форматов:

  • ID ключа 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 -> (строка)

Amazon Resource Name (ARN) роли IAM, предоставляющей Amazon Comprehend доступ для чтения к вашим входным данным.

VolumeKmsKeyId -> (строка)

ID ключа KMS, который Amazon Comprehend использует для шифрования данных на томе хранилища, подключенном к экземпляру/экземплярам вычислительных ресурсов ML, обрабатывающим задачу анализа. VolumeKmsKeyId может иметь один из следующих форматов:

  • ID ключа 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 -> (список)

Номер ID группы безопасности на экземпляре вашей частной VPC. Группы безопасности вашей VPC работают как виртуальный брандмауэр для управления входящим и исходящим трафиком и обеспечивают безопасность для ресурсов, к которым вы будете обращаться в VPC. Этот номер ID предваряется "sg-", например: "sg-03b388029b0a285ea". Дополнительная информация доступна в Группы безопасности вашей VPC.

(строка)

Subnets -> (список)

ID каждого подсети, используемой в вашей частной VPC. Эта подсеть является подмножеством диапазона адресов IPv4, используемых VPC, и специфична для конкретной зоны доступности в регионе VPC. Этот номер ID предваряется "subnet-", например: "subnet-04ccf456919e69055". Дополнительная информация доступна в VPC и подсети.

(строка)

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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