Spec-Zone.ru › AWS CLI v2

[ aws . rekognition ]

создание-версии-проекта

Описание

Создает новую версию проекта Amazon Rekognition (например, модель Custom Labels или пользовательский адаптер) и запускает обучение. Модели и адаптеры управляются в рамках проекта Rekognition. Ответом на CreateProjectVersion является Amazon Resource Name (ARN) для версии проекта.

Аргумент операции FeatureConfig позволяет настроить определенные параметры модели или адаптера. Вы можете предоставить описание версии проекта, используя аргумент VersionDescription. Обучение может занять некоторое время. Вы можете получить текущий статус, вызвав DescribeProjectVersions. Обучение завершилось успешно, если значение поля Status равно TRAINING_COMPLETED. После успешного завершения обучения вызовите DescribeProjectVersions, чтобы получить результаты обучения и оценить модель.

Для этой операции требуются разрешения на выполнение действия rekognition:CreateProjectVersion.

Примечание

Следующее относится только к проектам с Amazon Rekognition Custom Labels в качестве выбранного функционала:

Вы можете обучить модель в проекте, у которого нет связанных наборов данных, указав файлы манифеста в полях TrainingData и TestingData.

Если вы откроете консоль после обучения модели с файлами манифеста, Amazon Rekognition Custom Labels создаст для вас наборы данных, используя самые последние файлы манифеста. Вы больше не сможете обучить версию модели для проекта, указывая файлы манифеста.

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

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

Синтаксис

  create-project-version
--project-arn <value>
--version-name <value>
--output-config <value>
[--training-data <value>]
[--testing-data <value>]
[--tags <value>]
[--kms-key-id <value>]
[--version-description <value>]
[--feature-config <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]

Параметры

--project-arn (строка)

ARN проекта Amazon Rekognition, который будет управлять версией проекта, которую вы хотите обучить.

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

Имя версии проекта. Это значение должно быть уникальным.

--output-config (структура)

Расположение в Amazon S3 для хранения результатов обучения. Ведро может быть любым ведром S3 в вашей учетной записи AWS. Вам необходимо разрешение s3:PutObject на ведро.

S3Bucket -> (строка)

Ведро S3, в котором размещаются выходные данные обучения.

S3KeyPrefix -> (строка)

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

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

S3Bucket=string,S3KeyPrefix=string

Синтаксис JSON:

{
  "S3Bucket": "string",
  "S3KeyPrefix": "string"
}

--training-data (структура)

Указывает внешний манифест, который службы используют для обучения версии проекта. Если вы указываете TrainingData, вы также должны указать TestingData. Проект не должен иметь связанных наборов данных.

Assets -> (список)

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

(структура)

Assets — это изображения, которые вы используете для обучения и оценки версии модели. Assets также могут содержать информацию о валидации, используемую для отладки неудачного обучения модели.

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

Ведро S3, содержащее файл манифеста формата Amazon Sagemaker Ground Truth.

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

Предоставляет имя ведра S3 и имя объекта.

Регион ведра S3, содержащего объект S3, должен соответствовать региону, который вы используете для операций Amazon Rekognition.

Для обработки Amazon Rekognition объекта S3, пользователь должен иметь разрешение на доступ к объекту S3. Дополнительная информация в руководстве для разработчиков Amazon Rekognition, раздел "Как Amazon Rekognition работает с IAM".

Bucket -> (строка)

Имя ведра S3.

Name -> (строка)

Имя ключа объекта S3.

Version -> (строка)

Если ведро поддерживает версионирование, вы можете указать версию объекта.

Синтаксис JSON:

{
  "Assets": [
    {
      "GroundTruthManifest": {
        "S3Object": {
          "Bucket": "string",
          "Name": "string",
          "Version": "string"
        }
      }
    }
    ...
  ]
}

--testing-data (структура)

Указывает внешний манифест, который служба использует для тестирования версии проекта. Если вы указываете TestingData, вы также должны указать TrainingData. Проект не должен иметь связанных наборов данных.

Assets -> (список)

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

(структура)

Assets — это изображения, которые вы используете для обучения и оценки версии модели. Assets также могут содержать информацию о валидации, используемую для отладки неудачного обучения модели.

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

Ведро S3, содержащее файл манифеста формата Amazon Sagemaker Ground Truth.

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

Предоставляет имя ведра S3 и имя объекта.

Регион ведра S3, содержащего объект S3, должен соответствовать региону, который вы используете для операций Amazon Rekognition.

Для обработки Amazon Rekognition объекта S3, пользователь должен иметь разрешение на доступ к объекту S3. Дополнительная информация в руководстве для разработчиков Amazon Rekognition, раздел "Как Amazon Rekognition работает с IAM".

Bucket -> (строка)

Имя ведра S3.

Name -> (строка)

Имя ключа объекта S3.

Version -> (строка)

Если ведро поддерживает версионирование, вы можете указать версию объекта.

AutoCreate -> (булево)

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

Синтаксис JSON:

{
  "Assets": [
    {
      "GroundTruthManifest": {
        "S3Object": {
          "Bucket": "string",
          "Name": "string",
          "Version": "string"
        }
      }
    }
    ...
  ],
  "AutoCreate": true|false
}

--tags (отображение)

Набор тегов (пар ключ-значение), которые вы хотите добавить к версии проекта.

key -> (строка)

value -> (строка)

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

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--kms-key-id (строка)

Идентификатор вашего ключа AWS Key Management Service (AWS KMS). Вы можете указать Amazon Resource Name (ARN) вашего ключа KMS, ID вашего ключа KMS, псевдоним вашего ключа KMS или псевдоним ARN. Ключ используется для шифрования обучающих изображений, тестовых изображений и файлов манифеста, скопированных в службу для версии проекта. Ваши исходные изображения не затрагиваются. Ключ также используется для шифрования результатов обучения и файлов манифеста, записанных в выходное ведро Amazon S3 (OutputConfig).

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

  • kms:CreateGrant
  • kms:DescribeKey
  • kms:GenerateDataKey
  • kms:Decrypt

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

--version-description (строка)

Описание, примененное к создаваемой версии проекта.

--feature-config (структура)

Конфигурация, специфичная для функции, задачи обучения. Если конфигурация задачи не соответствует типу функции, связанной с проектом, возвращается InvalidParameterException.

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

Параметры конфигурации для обучения Custom Moderation.

ConfidenceThreshold -> (число с плавающей точкой)

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

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

ContentModeration={ConfidenceThreshold=float}

Синтаксис JSON:

{
  "ContentModeration": {
    "ConfidenceThreshold": float
  }
}

--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 (boolean)

Включить отладочную запись в журнал.

--endpoint-url (string)

Переопределить URL по умолчанию команды заданным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

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

--profile (string)

Использовать определенный профиль из файла аутентификации.

--region (string)

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

--version (string)

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

--color (string)

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

  • on
  • off
  • auto

--no-sign-request (boolean)

Не подписывать запросы. Кредиты не будут загружены, если этот аргумент указан.

--ca-bundle (string)

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

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

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

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — 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 (boolean)

Отключить страницу кли для вывода.

--cli-auto-prompt (boolean)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматическое запросить параметры ввода CLI.

Вывод

ProjectVersionArn -> (string)

ARN модели или версии проекта, которая была создана. Используйте DescribeProjectVersion, чтобы получить текущий статус операции обучения.

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

Spec-Zone.ru

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