Spec-Zone.ru › AWS CLI v2

[ aws . comprehend ]

list-key-phrases-detection-jobs

Описание

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

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

list-key-phrases-detection-jobs является постраничной операцией. Для получения всего набора результатов могут потребоваться несколько вызовов API. Вы можете отключить постраничность, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответ на постраничном запросе, аргумент --query должен извлечь данные из результатов следующих выражений запроса: KeyPhrasesDetectionJobPropertiesList

Синтаксис

  list-key-phrases-detection-jobs
[--filter <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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]

Параметры

--filter (структура)

Фильтрует возвращаемые задания. Вы можете фильтровать задания по их имени, статусу или дате и времени их отправки. Вы можете задать только один фильтр за раз.

JobName -> (строка)

Фильтрация по имени задания.

JobStatus -> (строка)

Фильтрует список заданий на основе статуса задания. Возвращает только задания с указанным статусом.

SubmitTimeBefore -> (метка времени)

Фильтрует список заданий на основе времени отправки задания на обработку. Возвращает только задания, отправленные до указанного времени. Задания возвращаются в порядке возрастания, от старейшего к новейшему.

SubmitTimeAfter -> (метка времени)

Фильтрует список заданий на основе времени отправки задания на обработку. Возвращает только задания, отправленные после указанного времени. Задания возвращаются в порядке убывания, от новейшего к старейшему.

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

JobName=string,JobStatus=string,SubmitTimeBefore=timestamp,SubmitTimeAfter=timestamp

Синтаксис JSON:

{
  "JobName": "string",
  "JobStatus": "SUBMITTED"|"IN_PROGRESS"|"COMPLETED"|"FAILED"|"STOP_REQUESTED"|"STOPPED",
  "SubmitTimeBefore": timestamp,
  "SubmitTimeAfter": timestamp
}

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы указаны в командной строке, эти значения переопределят значения, полученные из JSON. Невозможно передать произвольные двоичные данные с помощью значения, предоставленного в JSON, так как строка будет воспринята буквально. Это может не быть указано вместе с --cli-input-yaml.

--starting-token (строка)

Токен для указания места начала постраничного вывода. Это NextToken из ранее урезанного ответа.

Примеры использования см. в разделе «Постраничный вывод» в Руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.

Примеры использования см. в разделе «Постраничный вывод» в Руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Для возобновления постраничного вывода укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе «Постраничный вывод» в Руководстве пользователя AWS Command Line Interface.

--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
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • вкл
  • выкл
  • авто

--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 версии 1, и двоичные значения должны передаваться буквально. При предоставлении содержимого файла, соответствующего двоичному блоку 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.

Примеры

Примечание

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

За исключением случаев, когда указано иное, все примеры используют правила цитирования unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашего терминала. См. раздел «Использование кавычек со строками» в Руководстве пользователя AWS CLI.

Чтобы перечислить все задания обнаружения ключевых фраз

Следующий list-key-phrases-detection-jobs пример перечисляет все незавершенные и завершенные асинхронные задания обнаружения ключевых фраз.

aws comprehend list-key-phrases-detection-jobs

Вывод:

{
    "KeyPhrasesDetectionJobPropertiesList": [
        {
            "JobId": "123456abcdeb0e11022f22a11EXAMPLE",
            "JobArn": "arn:aws:comprehend:us-west-2:111122223333:key-phrases-detection-job/123456abcdeb0e11022f22a11EXAMPLE",
            "JobName": "keyphrasesanalysis1",
            "JobStatus": "COMPLETED",
            "SubmitTime": "2023-06-08T22:31:43.767000+00:00",
            "EndTime": "2023-06-08T22:39:52.565000+00:00",
            "InputDataConfig": {
                "S3Uri": "s3://amzn-s3-demo-source-bucket/AsyncBatchJobs/",
                "InputFormat": "ONE_DOC_PER_LINE"
            },
            "OutputDataConfig": {
                "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-KP-123456abcdeb0e11022f22a11EXAMPLE/output/output.tar.gz"
            },
            "LanguageCode": "en",
            "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role"
        },
        {
            "JobId": "123456abcdeb0e11022f22a33EXAMPLE",
            "JobArn": "arn:aws:comprehend:us-west-2:111122223333:key-phrases-detection-job/123456abcdeb0e11022f22a33EXAMPLE",
            "JobName": "keyphrasesanalysis2",
            "JobStatus": "STOPPED",
            "SubmitTime": "2023-06-08T22:57:52.154000+00:00",
            "EndTime": "2023-06-08T23:05:48.385000+00:00",
            "InputDataConfig": {
                "S3Uri": "s3://amzn-s3-demo-bucket/AsyncBatchJobs/",
                "InputFormat": "ONE_DOC_PER_LINE"
            },
            "OutputDataConfig": {
                "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-KP-123456abcdeb0e11022f22a33EXAMPLE/output/output.tar.gz"
            },
            "LanguageCode": "en",
            "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role"
        },
        {
            "JobId": "123456abcdeb0e11022f22a44EXAMPLE",
            "JobArn": "arn:aws:comprehend:us-west-2:111122223333:key-phrases-detection-job/123456abcdeb0e11022f22a44EXAMPLE",
            "JobName": "keyphrasesanalysis3",
            "JobStatus": "FAILED",
            "Message": "NO_READ_ACCESS_TO_INPUT: The provided data access role does not have proper access to the input data.",
            "SubmitTime": "2023-06-09T16:47:04.029000+00:00",
            "EndTime": "2023-06-09T16:47:18.413000+00:00",
            "InputDataConfig": {
                "S3Uri": "s3://amzn-s3-demo-bucket",
                "InputFormat": "ONE_DOC_PER_LINE"
            },
            "OutputDataConfig": {
                "S3Uri": "s3://amzn-s3-demo-destination-bucket/testfolder/111122223333-KP-123456abcdeb0e11022f22a44EXAMPLE/output/output.tar.gz"
            },
            "LanguageCode": "en",
            "DataAccessRoleArn": "arn:aws:iam::111122223333:role/service-role/AmazonComprehendServiceRole-example-role"
        }
    ]
}

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

Вывод

KeyPhrasesDetectionJobPropertiesList -> (список)

Список свойств каждого задания, которое возвращается.

(структура)

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

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

Это поле определяет операцию Amazon Textract API, которую 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 -> (строка)

Идентификатор ключа Amazon Web Services Key Management Service (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"

LanguageCode -> (строка)

Язык входных документов.

DataAccessRoleArn -> (строка)

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

VolumeKmsKeyId -> (строка)

Идентификатор ключа 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 и подсети.

(строка)

NextToken -> (строка)

Идентифицирует следующую страницу результатов.

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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