Spec-Zone.ru › AWS CLI v2

[ aws . transcribe ]

describe-language-model

Описание

Предоставляет информацию о заданной пользовательской модели языка.

Данная операция также показывает, была ли обновлена базовая модель языка, которую вы использовали для создания пользовательской модели языка. Если Amazon Transcribe обновил базовый язык, вы можете создать новую пользовательскую модель языка, используя обновлённую базовую модель.

Если вы пытались создать новую пользовательскую модель языка, и запрос не был успешным, вы можете использовать DescribeLanguageModel, чтобы определить причину этой ошибки.

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

Синтаксис

  describe-language-model
--model-name <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]

Параметры

--model-name (строка)

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

--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
  • текст
  • таблица
  • 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 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-language-model пример получает информацию о конкретной пользовательской модели языка. Например, в BaseModelName вы можете увидеть, обучена ли ваша модель с помощью модели NarrowBand или WideBand. Пользовательские модели языка с базовой моделью NarrowBand могут транскрибировать аудио с частотой дискретизации менее 16 кГц. Модели языка, использующие базовую модель WideBand, могут транскрибировать аудио с частотой дискретизации более 16 кГц. Параметр S3Uri указывает префикс Amazon S3, который вы использовали для доступа к обучающим данным для создания пользовательской модели языка.

aws transcribe describe-language-model \
    --model-name cli-clm-example

Вывод:

{
    "LanguageModel": {
        "ModelName": "cli-clm-example",
        "CreateTime": "2020-09-25T17:57:38.504000+00:00",
        "LastModifiedTime": "2020-09-25T17:57:48.585000+00:00",
        "LanguageCode": "language-code",
        "BaseModelName": "base-model-name",
        "ModelStatus": "IN_PROGRESS",
        "UpgradeAvailability": false,
        "InputDataConfig": {
            "S3Uri": "s3://amzn-s3-demo-bucket/Amazon-S3-Prefix/",
            "TuningDataS3Uri": "s3://amzn-s3-demo-bucket/Amazon-S3-Prefix/",
            "DataAccessRoleArn": "arn:aws:iam::AWS-account-number:role/IAM-role-with-permissions-to-create-a-custom-language-model"
        }
    }
}

Дополнительную информацию см. в разделе Улучшение точности транскрипции для определённых областей с помощью пользовательских моделей языка в руководстве разработчика Amazon Transcribe.

Вывод

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

Предоставляет информацию о заданной пользовательской модели языка.

Этот параметр также показывает, была ли обновлена базовая модель языка, которую вы использовали для создания пользовательской модели языка. Если Amazon Transcribe обновил базовую модель, вы можете создать новую пользовательскую модель языка, используя обновлённую базовую модель.

Если вы пытались создать новую пользовательскую модель языка, и запрос не был успешным, вы можете использовать этот DescribeLanguageModel, чтобы определить причину этой ошибки.

ModelName -> (строка)

Уникальное имя, выбранное вами, для вашей пользовательской модели языка.

Это имя чувствительно к регистру, не может содержать пробелы и должно быть уникальным в рамках аккаунта Amazon Web Services.

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

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

Метки времени имеют формат YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC . Например, 2022-05-04T12:32:58.761000-07:00 обозначает 12:32 PM UTC-7 4 мая 2022 года.

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

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

Метки времени имеют формат YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC . Например, 2022-05-04T12:32:58.761000-07:00 обозначает 12:32 PM UTC-7 4 мая 2022 года.

LanguageCode -> (строка)

Код языка, используемый для создания вашей пользовательской модели языка. Каждая пользовательская модель языка должна содержать термины только на одном языке, и язык, который вы выбираете для своей пользовательской модели языка, должен совпадать с языком ваших обучающих и настраивающих данных.

Список поддерживаемых языков и соответствующих кодов языков см. в таблице Поддерживаемые языки. Обратите внимание, что US English (en-US) — единственный поддерживаемый язык Amazon Transcribe Medical.

BaseModelName -> (строка)

Стандартная модель языка Amazon Transcribe, или базовая модель, используемая для создания вашей пользовательской модели языка.

ModelStatus -> (строка)

Статус указанной пользовательской модели языка. Когда статус отображается как COMPLETED, модель готова к использованию.

UpgradeAvailability -> (булево)

Показывает, доступна ли более современная базовая модель для использования с указанной пользовательской моделью языка.

Если false, ваша пользовательская модель языка использует самую последнюю базовую модель.

Если true, доступна более новая базовая модель, чем та, которую использует ваша модель языка.

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

FailureReason -> (строка)

Если ModelStatus является FAILED, FailureReason содержит информацию о причинах неудачи запроса пользовательской модели языка. См. также: Общие ошибки.

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

Расположение Amazon S3 входных файлов, используемых для обучения и настройки вашей пользовательской модели языка, а также ARN роли доступа к данным, которая имеет разрешения на доступ к этим данным.

S3Uri -> (строка)

Расположение (URI) Amazon S3 текстовых файлов, которые вы хотите использовать для обучения вашей пользовательской модели языка.

Вот пример URI пути: s3://DOC-EXAMPLE-BUCKET/my-model-training-data/

TuningDataS3Uri -> (строка)

Расположение (URI) Amazon S3 текстовых файлов, которые вы хотите использовать для настройки вашей пользовательской модели языка.

Вот пример URI пути: s3://DOC-EXAMPLE-BUCKET/my-model-tuning-data/

DataAccessRoleArn -> (строка)

Amazon Resource Name (ARN) роли IAM, у которой есть разрешения на доступ к ведру Amazon S3, содержащему ваши входные файлы. Если у роли, которую вы указали, нет соответствующих разрешений на доступ к указанному расположению Amazon S3, ваш запрос завершается ошибкой.

ARN ролей IAM имеют формат arn:partition:iam::account:role/role-name-with-path . Например: arn:aws:iam::111122223333:role/Admin .

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

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

Spec-Zone.ru

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