az ml online-endpoint

Note

This reference is part of the ml extension for the Azure CLI (version 2.15.0 or higher). Расширение будет автоматически устанавливаться при первом запуске команды az ml online-endpoint. Learn more about extensions.

Управление конечными точками Azure ML в Интернете.

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

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

Команды

Имя	Описание	Тип	Состояние
az ml online-endpoint create	Создайте конечную точку.	Extension	GA
az ml online-endpoint delete	Удаление конечной точки.	Extension	GA
az ml online-endpoint get-credentials	Вывод списка маркеров и ключей для сетевой конечной точки.	Extension	GA
az ml online-endpoint invoke	Вызов конечной точки.	Extension	GA
az ml online-endpoint list	Вывод списка конечных точек в рабочей области.	Extension	GA
az ml online-endpoint regenerate-keys	Повторно создайте ключи для сетевой конечной точки.	Extension	GA
az ml online-endpoint show	Отображение сведений о конечной точке.	Extension	GA
az ml online-endpoint update	Обновите конечную точку.	Extension	GA

az ml online-endpoint create

Создайте конечную точку.

Чтобы создать конечную точку, укажите файл YAML с конфигурацией веб-конечной точки. Если конечная точка уже существует, она завершится ошибкой. Если вы хотите обновить существующую конечную точку, используйте az ml online-endpoint update.

az ml online-endpoint create --resource-group
                             --workspace-name
                             [--auth-mode]
                             [--file]
                             [--local {false, true}]
                             [--name]
                             [--no-wait]
                             [--set]
                             [--web]

Примеры

Создание конечной точки из файла спецификации YAML

az ml online-endpoint create --file endpoint.yml --resource-group my-resource-group --workspace-name my-workspace

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

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--auth-mode

Метод проверки подлинности для конечной точки. Допустимые значения: ключ, aml_token. Default: key.

--file -f

Локальный путь к YAML-файлу, содержаму спецификацию веб-конечной точки Машинного обучения Azure. Справочные документы YAML для веб-конечной точки можно найти по адресу: https://aka.ms/ml-cli-v2-endpoint-online-yaml-reference.

--local

Создайте конечную точку локально. Примечание. Трафик и проверка подлинности не поддерживаются локально. Вы можете напрямую использовать az ml online-deployment create --local. Он создаст конечную точку, если она не существует.

Свойство	Значение
Default value:	False
Допустимые значения:	false, true

--name -n

Имя веб-конечной точки.

--no-wait

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

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

--set

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

--web -e

Отображение сведений о конечной точке в студии машинного обучения Azure в веб-браузере.

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

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

--debug

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

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

--help -h

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

--only-show-errors

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

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

--output -o

Output format.

Свойство	Значение
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 online-endpoint delete

Удаление конечной точки.

az ml online-endpoint delete --name
                             --resource-group
                             --workspace-name
                             [--local {false, true}]
                             [--no-wait]
                             [--yes]

Примеры

Удаление сетевой конечной точки, включая все его развертывания

az ml online-endpoint delete --name my-online-endpoint --resource-group my-resource-group --workspace-name my-workspace

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

--name -n

Имя веб-конечной точки.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--local

Удаление локальной конечной точки.

Свойство	Значение
Default value:	False
Допустимые значения:	false, true

--no-wait

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

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

--yes -y

Не запрашивать подтверждение.

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

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

--debug

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

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

--help -h

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

--only-show-errors

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

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

--output -o

Output format.

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

--query

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

--subscription

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

--verbose

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

az ml online-endpoint get-credentials

Вывод списка маркеров и ключей для сетевой конечной точки.

az ml online-endpoint get-credentials --name
                                      --resource-group
                                      --workspace-name

Примеры

Вывод списка ключей для конечной точки в Сети

az ml online-endpoint get-credentials --name my-online-endpoint --resource-group my-resource-group --workspace-name my-workspace

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

--name -n

Имя веб-конечной точки.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

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

--debug

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

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

--help -h

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

--only-show-errors

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

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

--output -o

Output format.

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

--query

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

--subscription

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

--verbose

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

az ml online-endpoint invoke

Вызов конечной точки.

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

az ml online-endpoint invoke --name
                             --resource-group
                             --workspace-name
                             [--deployment-name]
                             [--local {false, true}]
                             [--request-file]

Примеры

Вызов сетевой конечной точки с некоторыми данными запроса

az ml online-endpoint invoke --name my-online-endpoint --request-file sample_request.json --resource-group my-resource-group --workspace-name my-workspace

Вызов сетевой конечной точки, предназначенный для конкретного развертывания

az ml online-endpoint invoke --name my-online-endpoint --deployment my-deployment --request-file sample_request.json --resource-group my-resource-group --workspace-name my-workspace

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

--name -n

Имя веб-конечной точки.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--deployment-name -d

Имя развертывания для целевого объекта.

--local

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

Свойство	Значение
Default value:	False
Допустимые значения:	false, true

--request-file -r

Локальный путь к JSON-файлу с данными запроса.

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

--debug

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

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

--help -h

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

--only-show-errors

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

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

--output -o

Output format.

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

--query

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

--subscription

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

--verbose

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

az ml online-endpoint list

Вывод списка конечных точек в рабочей области.

az ml online-endpoint list --resource-group
                           --workspace-name
                           [--local {false, true}]

Примеры

Вывод списка всех сетевых конечных точек в рабочей области

az ml online-endpoint list --resource-group my-resource-group --workspace-name my-workspace

Вывод списка всех конечных точек пакетной службы в рабочей области

az ml online-endpoint list  --resource-group my-resource-group --workspace-name my-workspace

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

az ml online-endpoint list --query "[].{Name:name}"  --output table --resource-group my-resource-group --workspace-name my-workspace

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

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--local

Список всех локальных конечных точек.

Свойство	Значение
Default value:	False
Допустимые значения:	false, true

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

--debug

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

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

--help -h

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

--only-show-errors

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

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

--output -o

Output format.

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

--query

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

--subscription

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

--verbose

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

az ml online-endpoint regenerate-keys

Повторно создайте ключи для сетевой конечной точки.

az ml online-endpoint regenerate-keys --name
                                      --resource-group
                                      --workspace-name
                                      [--key-type]
                                      [--no-wait]

Примеры

Повторное создание ключей для сетевой конечной точки

az ml online-endpoint regenerate-keys --name my-online-endpoint --resource-group my-resource-group --workspace-name my-workspace

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

--name -n

Имя веб-конечной точки.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--key-type

Тип ключа для повторного создания. Допустимые значения: первичные, вторичные.

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

--no-wait

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

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

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

--debug

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

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

--help -h

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

--only-show-errors

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

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

--output -o

Output format.

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

--query

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

--subscription

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

--verbose

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

az ml online-endpoint show

Отображение сведений о конечной точке.

az ml online-endpoint show --name
                           --resource-group
                           --workspace-name
                           [--local {false, true}]
                           [--web]

Примеры

Отображение сведений о конечной точке пакетной службы

az ml online-endpoint show --name my-online-endpoint  --resource-group my-resource-group --workspace-name my-workspace

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

az ml online-endpoint show -n my-endpoint --query "{Name:name,State:provisioning_state}"  --output table --resource-group my-resource-group --workspace-name my-workspace

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

--name -n

Имя веб-конечной точки.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--local

Показать локальную конечную точку.

Свойство	Значение
Default value:	False
Допустимые значения:	false, true

--web -e

Отображение сведений о конечной точке в студии машинного обучения Azure в веб-браузере.

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

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

--debug

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

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

--help -h

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

--only-show-errors

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

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

--output -o

Output format.

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

--query

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

--subscription

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

--verbose

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

az ml online-endpoint update

Обновите конечную точку.

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

az ml online-endpoint update --resource-group
                             --workspace-name
                             [--add]
                             [--file]
                             [--force-string]
                             [--local {false, true}]
                             [--mirror-traffic]
                             [--name]
                             [--no-wait]
                             [--remove]
                             [--set]
                             [--traffic]
                             [--web]

Примеры

Обновление конечной точки из файла спецификации YAML

az ml online-endpoint update --file updated_endpoint.yml --resource-group my-resource-group --workspace-name my-workspace

Обновление параметров трафика для конечной точки

az ml online-endpoint update --name my-online-endpoint  --traffic "my-new-deployment=100" --resource-group my-resource-group --workspace-name my-workspace

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

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--add

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

Свойство	Значение
Parameter group:	Generic Update Arguments
Default value:	[]

--file -f

--force-string

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

Свойство	Значение
Parameter group:	Generic Update Arguments
Default value:	False

--local

Обновите локальную конечную точку.

Свойство	Значение
Default value:	False
Допустимые значения:	false, true

--mirror-traffic

Направляет повторяющийся процент динамического трафика в обучение развертывания.

--name -n

Имя веб-конечной точки.

--no-wait

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

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

--remove

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

Свойство	Значение
Parameter group:	Generic Update Arguments
Default value:	[]

--set

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

Свойство	Значение
Parameter group:	Generic Update Arguments
Default value:	[]

--traffic -r

Пары "ключ-значение", разделенные пробелами, в кавычках, для параметров трафика для конечной точки.

--web -e

Отображение сведений о конечной точке в студии машинного обучения Azure в веб-браузере.

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

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

--debug

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

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

--help -h

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

--only-show-errors

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

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

--output -o

Output format.

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

--query

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

--subscription

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

--verbose

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

Поделиться через

az ml online-endpoint

Команды

az ml online-endpoint create

Примеры

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

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

az ml online-endpoint delete

Примеры

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

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

az ml online-endpoint get-credentials

Примеры

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

az ml online-endpoint invoke

Примеры

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

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

az ml online-endpoint list

Примеры

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

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

az ml online-endpoint regenerate-keys

Примеры

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

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

az ml online-endpoint show

Примеры

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

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

az ml online-endpoint update

Примеры

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

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

Обратная связь