az ml deployment-template

  • Предварительный просмотр

Замечание

Эта ссылка входит в расширение ml для Azure CLI (версия 2.15.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az ml deployment-template . Подробнее о расширениях.

Эта группа команд находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Управление шаблонами развертывания Azure машинного обучения.

Шаблоны развертывания — это повторно используемые шаблоны, определяющие конфигурации развертывания для Azure машинного обучения. Они поддерживают только операции на основе реестра (не на основе рабочих областей) и предоставляют способ стандартизации конфигураций развертывания в командах и проектах.

Команды

Имя Описание Тип Состояние
az ml deployment-template archive

Архивируйте шаблон развертывания.

 Extension Preview
az ml deployment-template create

Создайте новый шаблон развертывания из YAML-файла.

 Extension Preview
az ml deployment-template list

Вывод списка шаблонов развертывания в реестре.

 Extension Preview
az ml deployment-template restore

Восстановление архивного шаблона развертывания.

 Extension Preview
az ml deployment-template show

Получите конкретный шаблон развертывания по имени и версии.

 Extension Preview
az ml deployment-template update

Обновите определенные поля существующего шаблона развертывания.

 Extension Preview

az ml deployment-template archive

Предварительный просмотр

Группа команд "ml deployment-template" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Архивируйте шаблон развертывания.

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

az ml deployment-template archive --name
                                  --registry-name
                                  --version
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--no-wait]

Примеры

Архивация определенной версии

az ml deployment-template archive --name my-template --version 1 --registry-name myregistry

Архив без ожидания завершения

az ml deployment-template archive --name my-template --version 1 --registry-name myregistry --no-wait

Обязательные параметры

--name -n

Имя шаблона развертывания.

--registry-name -r

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

--version -v

Версия шаблона развертывания.

Необязательные параметры

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

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--no-wait

Не дождитесь завершения длительной операции. По умолчанию — False.

Свойство Значение
Default value: False
Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az ml deployment-template create

Предварительный просмотр

Группа команд "ml deployment-template" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Создайте новый шаблон развертывания из YAML-файла.

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

az ml deployment-template create --registry-name
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--file]
                                 [--name]
                                 [--no-wait]
                                 [--set]
                                 [--version]

Примеры

Создание шаблона развертывания из YAML-файла

az ml deployment-template create --file template.yml --registry-name myregistry

Создание с переопределениями имен и версий

az ml deployment-template create --file template.yml --name custom-template --version 2 --registry-name myregistry

Создание без ожидания завершения

az ml deployment-template create --file template.yml --registry-name myregistry --no-wait

Обязательные параметры

--registry-name -r

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

Необязательные параметры

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

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--file -f

Локальный путь к ФАЙЛу YAML, содержаному спецификацию шаблона развертывания Azure машинного обучения. Справочные документы YAML для шаблона развертывания см. в следующих https://aka.ms/ml-cli-v2-deployment-template-yamlсведениях.

--name -n

Имя шаблона развертывания.

--no-wait

Не дождитесь завершения длительной операции. По умолчанию — False.

Свойство Значение
Default value: False
--set

Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=value.

--version -v

Версия шаблона развертывания.

Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az ml deployment-template list

Предварительный просмотр

Группа команд "ml deployment-template" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Вывод списка шаблонов развертывания в реестре.

Список всех шаблонов развертывания, доступных в указанном реестре. Эта команда возвращает все шаблоны вместе с их метаданными, включая имя, версию, описание и теги.

az ml deployment-template list --registry-name

Примеры

Вывод списка всех шаблонов развертывания в реестре

az ml deployment-template list --registry-name myregistry

Вывод списка шаблонов развертывания с определенным форматом вывода

az ml deployment-template list --registry-name myregistry --output table

Обязательные параметры

--registry-name -r

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

Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az ml deployment-template restore

Предварительный просмотр

Группа команд "ml deployment-template" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Восстановление архивного шаблона развертывания.

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

az ml deployment-template restore --name
                                  --registry-name
                                  --version
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--no-wait]

Примеры

Восстановление определенной версии

az ml deployment-template restore --name my-template --version 1 --registry-name myregistry

Восстановление без ожидания завершения

az ml deployment-template restore --name my-template --version 1 --registry-name myregistry --no-wait

Обязательные параметры

--name -n

Имя шаблона развертывания.

--registry-name -r

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

--version -v

Версия шаблона развертывания.

Необязательные параметры

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

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--no-wait

Не дождитесь завершения длительной операции. По умолчанию — False.

Свойство Значение
Default value: False
Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az ml deployment-template show

Предварительный просмотр

Группа команд "ml deployment-template" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Получите конкретный шаблон развертывания по имени и версии.

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

az ml deployment-template show --name
                               --registry-name
                               --version

Примеры

Получение определенной версии шаблона развертывания

az ml deployment-template show --name my-template --version 1 --registry-name myregistry

Обязательные параметры

--name -n

Имя шаблона развертывания.

--registry-name -r

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

--version -v

Версия шаблона развертывания.

Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az ml deployment-template update

Предварительный просмотр

Группа команд "ml deployment-template" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Обновите определенные поля существующего шаблона развертывания.

Обновите поля метаданных (описание и теги) существующего шаблона развертывания, не требуя yamL-файла. Эта команда следует Azure CLI соглашениям и принимает только определенные обновления полей. Теги объединяются с существующими тегами, а не заменяются.

Для структурных изменений шаблона развертывания (конечных точек, конфигурации развертывания и т. д.) используйте команду create с файлом YAML.

az ml deployment-template update --name
                                 --registry-name
                                 --version
                                 [--acquire-policy-token]
                                 [--add]
                                 [--change-reference]
                                 [--force-string]
                                 [--remove]
                                 [--set]

Примеры

Обновление описания шаблона развертывания

az ml deployment-template update --name my-template --version 1 --registry-name myregistry --set "description=Updated description"

Обновление тегов шаблона развертывания

az ml deployment-template update --name my-template --version 1 --registry-name myregistry --set "tags=environment=production owner=ml-team"

Обновление описания и тегов

az ml deployment-template update --name my-template --version 1 --registry-name myregistry --set "description=Production template" --set "tags=status=active"

Обязательные параметры

--name -n

Имя шаблона развертывания.

--registry-name -r

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

--version -v

Версия шаблона развертывания.

Необязательные параметры

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

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--add

Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>.

Свойство Значение
Группа параметров: Generic Update Arguments
Default value: []
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--force-string

При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.

Свойство Значение
Группа параметров: Generic Update Arguments
Default value: False
--remove

Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Свойство Значение
Группа параметров: Generic Update Arguments
Default value: []
--set

Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>.

Свойство Значение
Группа параметров: Generic Update Arguments
Default value: []
Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False