az ml service
Note
Эта ссылка является частью расширения azure-cli-ml для Azure CLI (версия 2.0.28 или более поздней). Расширение автоматически установит первый раз, когда вы запускаете команду az ml service. Подробнее о расширениях.
Управление операционными службами.
Команды
| Имя | Описание | Тип | Состояние |
|---|---|---|---|
| az ml service delete |
Удаление службы из рабочей области. |
Extension | GA |
| az ml service get-access-token |
Получение маркера для выдачи запросов к службе. |
Extension | GA |
| az ml service get-keys |
Получение ключей для выдачи запросов к службе. |
Extension | GA |
| az ml service get-logs |
Получение журналов для службы. |
Extension | GA |
| az ml service list |
Вывод списка служб в рабочей области. |
Extension | GA |
| az ml service regen-key |
Повторно создайте ключи для службы. |
Extension | GA |
| az ml service run |
Запустите службу в рабочей области. |
Extension | GA |
| az ml service show |
Отображение сведений о службе в рабочей области. |
Extension | GA |
| az ml service update |
Обновите службу в рабочей области. |
Extension | GA |
az ml service delete
Удаление службы из рабочей области.
az ml service delete --name
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[]
Обязательные параметры
Имя службы для удаления.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Путь к папке проекта. По умолчанию: текущий каталог.
Группа ресурсов, соответствующая предоставленной рабочей области.
Указывает идентификатор подписки.
Имя рабочей области, содержащей службу для удаления.
Флаг детализации.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |
az ml service get-access-token
Получение маркера для выдачи запросов к службе.
az ml service get-access-token --name
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[]
Обязательные параметры
Имя службы.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Путь к папке проекта. По умолчанию: текущий каталог.
Группа ресурсов, соответствующая предоставленной рабочей области.
Указывает идентификатор подписки.
Имя рабочей области, содержащей службу для отображения.
Флаг детализации.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |
az ml service get-keys
Получение ключей для выдачи запросов к службе.
az ml service get-keys --name
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[]
Обязательные параметры
Имя службы.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Путь к папке проекта. По умолчанию: текущий каталог.
Группа ресурсов, соответствующая предоставленной рабочей области.
Указывает идентификатор подписки.
Имя рабочей области, содержащей службу для отображения.
Флаг детализации.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |
az ml service get-logs
Получение журналов для службы.
az ml service get-logs --name
[--init]
[--num_lines]
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[]
Обязательные параметры
Имя службы.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Получение журналов контейнера init вместо контейнера оценки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Число строк журнала для возврата из хвоста (по умолчанию — 5000).
| Свойство | Значение |
|---|---|
| Default value: | 5000 |
Путь к папке проекта. По умолчанию: текущий каталог.
Группа ресурсов, соответствующая предоставленной рабочей области.
Указывает идентификатор подписки.
Имя рабочей области, содержащей службу для отображения.
Флаг детализации.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |
az ml service list
Вывод списка служб в рабочей области.
az ml service list [--compute-type]
[--image-digest]
[--model-id]
[--model-name]
[--path]
[--property]
[--resource-group]
[--subscription-id]
[--tag]
[--workspace-name]
[]
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Если это указано, отображаются только службы с указанным типом вычислений. (Параметры : ACI, AKS).
Если это указано, будет отображаться только службы, имеющие указанный дайджест образа.
При условии отображается только службы с указанным идентификатором модели.
При условии отображается только службы с указанным именем модели.
Путь к папке проекта. По умолчанию: текущий каталог.
При условии отфильтруется по указанному ключу или значению (e.g. key или key=value). Можно указать несколько свойств с несколькими параметрами --property.
| Свойство | Значение |
|---|---|
| Default value: | [] |
Группа ресурсов, соответствующая предоставленной рабочей области.
Указывает идентификатор подписки.
При условии отфильтруется по указанному ключу или значению (e.g. key или key=value). Несколько тегов можно указать с несколькими параметрами --tag.
| Свойство | Значение |
|---|---|
| Default value: | [] |
Имя рабочей области, содержащей службы для списка.
Флаг детализации.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |
az ml service regen-key
Повторно создайте ключи для службы.
az ml service regen-key --key
--name
[--path]
[--resource-group]
[--set-key]
[--subscription-id]
[--workspace-name]
[]
Обязательные параметры
Какой ключ необходимо повторно создать, если указан повторное создание. Параметры: основной, вторичный.
Имя службы.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Путь к папке проекта. По умолчанию: текущий каталог.
Группа ресурсов, соответствующая предоставленной рабочей области.
Укажите значение проверки подлинности для указанного ключа.
Указывает идентификатор подписки.
Имя рабочей области, содержащей службу для отображения.
Флаг детализации.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |
az ml service run
Запустите службу в рабочей области.
az ml service run --name
[--input-data]
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[]
Обязательные параметры
Имя службы для оценки.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Данные, используемые для вызова веб-службы.
Путь к папке проекта. По умолчанию: текущий каталог.
Группа ресурсов, соответствующая предоставленной рабочей области.
Указывает идентификатор подписки.
Имя рабочей области, содержащей службу для запуска.
Флаг детализации.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |
az ml service show
Отображение сведений о службе в рабочей области.
az ml service show --name
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[]
Обязательные параметры
Имя отображаемой веб-службы.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Путь к папке проекта. По умолчанию: текущий каталог.
Группа ресурсов, соответствующая предоставленной рабочей области.
Указывает идентификатор подписки.
Имя рабочей области, содержащей службу для отображения.
Флаг детализации.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |
az ml service update
Обновите службу в рабочей области.
az ml service update --name
[--add-property]
[--add-tag]
[--ae --auth-enabled]
[--ai --enable-app-insights]
[--ar --autoscale-refresh-seconds]
[--as --autoscale-enabled]
[--at --autoscale-target-utilization]
[--autoscale-max-replicas --ma]
[--autoscale-min-replicas --mi]
[--base-image --bi]
[--base-image-registry --ir]
[--cc --cpu-cores]
[--ccl --cpu-cores-limit]
[--cf --conda-file]
[--collect-model-data --md]
[--compute-target]
[--cuda-version --cv]
[--dc --deploy-config-file]
[--description]
[--dn --dns-name-label]
[--ds --extra-docker-file-steps]
[--ed --environment-directory]
[--eg --enable-gpu]
[--entry-script --es]
[--environment-name]
[--environment-version --ev]
[--failure-threshold --ft]
[--gb --memory-gb]
[--gbl --memory-gb-limit]
[--gc --gpu-cores]
[--ic --inference-config-file]
[--id --initial-delay-seconds]
[--is-migration]
[--kp --primary-key]
[--ks --secondary-key]
[--lo --location]
[--max-request-wait-time --mr]
[--model]
[--model-metadata-file]
[--no-wait]
[--nr --num-replicas]
[--path]
[--period-seconds --ps]
[--po --port]
[--remove-tag]
[--replica-max-concurrent-requests --rm]
[--resource-group]
[--rt --runtime]
[--sc --ssl-cname]
[--scoring-timeout-ms --tm]
[--sd --source-directory]
[--se --ssl-enabled]
[--sk --ssl-key-pem-file]
[--sp --ssl-cert-pem-file]
[--st --success-threshold]
[--subscription-id]
[--timeout-seconds --ts]
[--token-auth-enabled]
[--workspace-name]
[]
Обязательные параметры
Имя службы для обновления.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Свойство key/value для добавления (e.g. key=value). Можно указать несколько свойств с несколькими параметрами свойств --add-.
| Свойство | Значение |
|---|---|
| Default value: | [] |
Тег ключа и значения для добавления (e.g. key=value). Несколько тегов можно указать с несколькими параметрами тегов --add-tag.
| Свойство | Значение |
|---|---|
| Default value: | [] |
Следует ли включить проверку подлинности ключа для этой веб-службы. По умолчанию False.
Следует ли включить AppInsights для этой веб-службы. По умолчанию False.
Как часто автомасштабирование должно пытаться масштабировать эту веб-службу. Значение по умолчанию — 1.
Следует ли включить автоматическое масштабирование для этой веб-службы. По умолчанию значение True, если num_replicas — Нет.
Целевое использование (в процентах от 100) автомасштабирование должно попытаться сохранить для этой веб-службы. Значение по умолчанию — 70.
Максимальное количество контейнеров, используемых при автомасштабировании этой веб-службы. Значение по умолчанию равно 10.
Минимальное количество контейнеров, используемых при автомасштабировании этой веб-службы. Значение по умолчанию — 1.
Пользовательский образ, используемый в качестве базового образа. Если базовый образ не указан, базовый образ будет использоваться на основе заданного параметра среды выполнения.
Реестр образов, содержащий базовый образ.
Количество ядер ЦП, выделяемых для этой веб-службы. Может быть десятичным. Значение по умолчанию — 0.1.
Максимальное количество ядер ЦП, которые могут использоваться веб-службой. Может быть десятичным.
Путь к локальному файлу с определением среды conda для использования для образа.
Следует ли включить сбор данных модели для этой веб-службы. По умолчанию False.
(предварительная версия) Указывает целевой объект вычислений с расширением AzureML, установленным для размещения перенесенной виртуальной конечной точки Kubernetes и развертывания.
Версия CUDA для установки образов, которым требуется поддержка GPU. Образ GPU должен использоваться в службах Microsoft Azure, таких как экземпляры контейнеров Azure, вычисления машинного обучения Azure, виртуальные машины Azure и Служба Azure Kubernetes. Поддерживаемые версии: 9.0, 9.1 и 10.0. Если задано значение "enable_gpu", значение по умолчанию равно "9.1".
Путь к JSON-файлу с метаданными развертывания.
Описание службы.
Dns-имя для этой веб-службы.
Путь к локальному файлу с дополнительными шагами Docker для запуска при настройке образа.
Каталог для среды машинного обучения Azure для развертывания. Это тот же путь к каталогу, что и в команде az ml environment scaffold.
Следует ли включить поддержку GPU на изображении. Образ GPU должен использоваться в службах Microsoft Azure, таких как экземпляры контейнеров Azure, вычисления машинного обучения Azure, виртуальные машины Azure и Служба Azure Kubernetes. По умолчанию False.
Путь к локальному файлу, который содержит код для запуска службы (относительный путь от source_directory, если он указан).
Имя среды машинного обучения Azure для развертывания.
Версия существующей среды машинного обучения Azure для развертывания.
Когда модуль Pod запускается и проба активности завершается ошибкой, Kubernetes будет пытаться --failure-пороговое время, прежде чем отказаться. По умолчанию — 3. Минимальное значение равно 1.
Объем памяти (в ГБ) для этой веб-службы. Может быть десятичным.
Максимальный объем памяти (в ГБ) этой веб-службы разрешено использовать. Может быть десятичным.
Количество ядер gpu, выделяемых для этой веб-службы. По умолчанию 1.
Путь к JSON-файлу или YAML, содержанию конфигурации вывода.
Количество секунд после запуска контейнера до запуска проб активности. Значение по умолчанию — 310.
(предварительная версия) Перенос веб-службы AKS в конечную точку и развертывание Kubernetes в Сети. По умолчанию False.
Первичный ключ проверки подлинности, используемый для этой веб-службы.
Дополнительный ключ проверки подлинности, используемый для этой веб-службы.
Регион Azure для развертывания этой веб-службы. Если не указать, будет использоваться расположение рабочей области. Дополнительные сведения о доступных регионах см. здесь:https://azure.microsoft.com/en-us/global-infrastructure/services/?regions=all& products=container-instances.
Максимальное время, когда запрос останется в очереди (в миллисекундах), прежде чем возвращать ошибку 503. Значение по умолчанию — 500.
Идентификатор развернутой модели. Можно указать несколько моделей с дополнительными аргументами -m. Сначала необходимо зарегистрировать модели.
| Свойство | Значение |
|---|---|
| Default value: | [] |
Путь к JSON-файлу с метаданными регистрации модели. Несколько моделей можно предоставить с помощью нескольких -f параметров.
| Свойство | Значение |
|---|---|
| Default value: | [] |
Пометка, чтобы не ожидать асинхронных вызовов.
Количество контейнеров, выделяемых для этой веб-службы. Значение по умолчанию, если этот параметр не задан, автомасштабирование включается по умолчанию.
Путь к папке проекта. По умолчанию: текущий каталог.
Частота (в секундах) выполнения пробы активности. По умолчанию — 10 секунд. Минимальное значение равно 1.
Локальный порт, на который будет предоставляться конечная точка HTTP службы.
Ключ тега для удаления. Несколько тегов можно указать с несколькими параметрами тегов --remove-tag.
| Свойство | Значение |
|---|---|
| Default value: | [] |
Количество одновременных запросов на узел, разрешающих эту веб-службу. Значение по умолчанию — 1.
Группа ресурсов, соответствующая предоставленной рабочей области.
Какая среда выполнения используется для образа. Текущие поддерживаемые среды выполнения: spark-py и python-py|python|python|slim.
Имя cname, если протокол SSL включен. Применимо только при обновлении службы ACI.
Время ожидания для принудительного применения вызовов оценки для этой веб-службы. По умолчанию — 60000.
Путь к папкам, содержащим все файлы для создания образа.
Следует ли включить SSL для этой веб-службы. По умолчанию False.
Файл ключа, необходимый для включения SSL.
Файл сертификата, необходимый, если включен ПРОТОКОЛ SSL.
Минимальное число последовательных успешных попыток пробы активности после сбоя, после которых проба будет считаться успешной. Значение по умолчанию — 1. Минимальное значение равно 1.
Указывает идентификатор подписки.
Количество секунд, после которого время ожидания пробы активности истекает. Значение по умолчанию — 2 секунды. Минимальное значение равно 1.
Следует ли включить проверку подлинности маркеров для этой веб-службы. Доступно только для веб-служб AKS. По умолчанию False.
Имя рабочей области, содержащей службу для обновления.
Флаг детализации.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |