Spec-Zone.ru › AWS CLI v2

[ aws . sagemaker ]

create-inference-component

Описание

Создает компонент вывода, который является объектом хостинга SageMaker AI, который можно использовать для развертывания модели на конечной точке. В настройках компонента вывода вы указываете модель, конечную точку и то, как модель использует ресурсы, размещенные в конечной точке. Вы можете оптимизировать использование ресурсов, настраивая распределение необходимых ядер процессора, ускорителей и памяти. Вы можете развернуть несколько компонентов вывода на конечной точке, где каждый компонент вывода содержит одну модель и потребности в использовании ресурсов для этой конкретной модели. После развертывания компонента вывода вы можете напрямую вызывать связанную модель, когда используете действие InvokeEndpoint API.

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

Синтаксис

  create-inference-component
--inference-component-name <value>
--endpoint-name <value>
[--variant-name <value>]
--specification <value>
[--runtime-config <value>]
[--tags <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]

Параметры

--inference-component-name (строка)

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

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

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

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

Имя существующего варианта производства, где вы размещаете компонент вывода.

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

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

ModelName -> (строка)

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

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

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

Image -> (строка)

Путь Amazon Elastic Container Registry (Amazon ECR), где хранится Docker-образ модели.

ArtifactUrl -> (строка)

Путь Amazon S3, где хранятся артефакты модели, полученные в результате обучения модели. Этот путь должен указывать на один сжатый gzip-архив tar (.tar.gz).

Environment -> (массив)

Переменные среды, которые необходимо установить в Docker-контейнере. Каждый ключ и значение в строковом массиве Environment могут иметь длину до 1024. Мы поддерживаем до 16 записей в массиве.

key -> (строка)

value -> (строка)

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

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

ModelDataDownloadTimeoutInSeconds -> (целое число)

Значение тайм-аута в секундах для загрузки и извлечения модели, которую вы хотите разместить из Amazon S3 на отдельный экземпляр вывода, связанный с этим компонентом вывода.

ContainerStartupHealthCheckTimeoutInSeconds -> (целое число)

Значение тайм-аута в секундах для вашего контейнера вывода для успешной проверки состояния службой Amazon S3 Hosting. Дополнительную информацию о проверке состояния см. в разделе Как ваш контейнер должен реагировать на запросы проверки состояния (пинга).

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

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

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

NumberOfCpuCoresRequired -> (вещественное число)

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

NumberOfAcceleratorDevicesRequired -> (вещественное число)

Количество ускорителей, которые нужно выделить для выполнения модели, которую вы назначаете компоненту вывода. Ускорители включают графические процессоры и Amazon Web Services Inferentia.

MinMemoryRequiredInMb -> (целое число)

Минимальное значение памяти в МБ для выделения для выполнения модели, которую вы назначаете компоненту вывода.

MaxMemoryRequiredInMb -> (целое число)

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

BaseInferenceComponentName -> (строка)

Имя существующего компонента вывода, который должен содержать компонент вывода, который вы создаете в своем запросе.

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

При создании компонента вывода адаптера используйте параметр Container для указания расположения артефактов адаптера. В значении параметра используйте параметр ArtifactUrl типа данных InferenceComponentContainerSpecification.

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

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

ModelName=string,Container={Image=string,ArtifactUrl=string,Environment={KeyName1=string,KeyName2=string}},StartupParameters={ModelDataDownloadTimeoutInSeconds=integer,ContainerStartupHealthCheckTimeoutInSeconds=integer},ComputeResourceRequirements={NumberOfCpuCoresRequired=float,NumberOfAcceleratorDevicesRequired=float,MinMemoryRequiredInMb=integer,MaxMemoryRequiredInMb=integer},BaseInferenceComponentName=string

Синтаксис JSON:

{
  "ModelName": "string",
  "Container": {
    "Image": "string",
    "ArtifactUrl": "string",
    "Environment": {"string": "string"
      ...}
  },
  "StartupParameters": {
    "ModelDataDownloadTimeoutInSeconds": integer,
    "ContainerStartupHealthCheckTimeoutInSeconds": integer
  },
  "ComputeResourceRequirements": {
    "NumberOfCpuCoresRequired": float,
    "NumberOfAcceleratorDevicesRequired": float,
    "MinMemoryRequiredInMb": integer,
    "MaxMemoryRequiredInMb": integer
  },
  "BaseInferenceComponentName": "string"
}

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

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

CopyCount -> (целое число)

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

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

CopyCount=integer

Синтаксис JSON:

{
  "CopyCount": integer
}

--tags (список)

Список пар «ключ-значение», связанных с моделью. Дополнительную информацию см. в разделе Маркировка ресурсов Amazon Web Services в справочнике Amazon Web Services General Reference.

(структура)

Объект тега, состоящий из ключа и необязательного значения, используемый для управления метаданными для ресурсов SageMaker Amazon Web Services.

Вы можете добавлять теги к экземплярам ноутбуков, задачам обучения, задачам настройки гиперпараметров, задачам пакетного преобразования, моделям, задачам маркировки, рабочим группам, конфигурациям конечных точек и конечным точкам. Дополнительную информацию о добавлении тегов к ресурсам SageMaker см. в разделе AddTags.

Дополнительную информацию о добавлении метаданных к вашим ресурсам Amazon Web Services с помощью маркировки см. в разделе Маркировка ресурсов Amazon Web Services. Советы по наилучшим методам работы с ресурсами Amazon Web Services с помощью маркировки см. в разделе Практические рекомендации по маркировке: Реализация эффективной стратегии маркировки ресурсов Amazon Web Services.

Key -> (строка)

Ключ тега. Ключи тегов должны быть уникальными для каждого ресурса.

Value -> (строка)

Значение тега.

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

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--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.

Вывод

InferenceComponentArn -> (строка)

Идентификатор ресурса Amazon (ARN) компонента вывода.

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

Spec-Zone.ru

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