az ml online-endpoint

Примечание.

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

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

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

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

Команды

Имя	Описание	Тип	Состояние
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	Обновите конечную точку.	Расширение	Общедоступная версия

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

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

--auth-mode

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

--file -f

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

--local

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

допустимые значения: false, true

значение по умолчанию: False

--name -n

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

--no-wait

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

значение по умолчанию: False

--set

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

--web -e

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

значение по умолчанию: False

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

--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

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

--subscription

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

--verbose

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

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

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

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

--local

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

допустимые значения: false, true

значение по умолчанию: False

--no-wait

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

значение по умолчанию: False

--yes -y

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

значение по умолчанию: False

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

--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

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

--subscription

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

--verbose

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

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

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

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

--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

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

--subscription

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

--verbose

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

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

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

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

--deployment-name -d

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

--local

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

допустимые значения: false, true

значение по умолчанию: False

--request-file -r

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

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

--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

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

--subscription

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

--verbose

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

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

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

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

--local

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

допустимые значения: false, true

значение по умолчанию: False

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

--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

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

--subscription

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

--verbose

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

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

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

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

--key-type

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

значение по умолчанию: primary

--no-wait

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

значение по умолчанию: False

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

--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

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

--subscription

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

--verbose

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

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

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

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

--local

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

допустимые значения: false, true

значение по умолчанию: False

--web -e

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

значение по умолчанию: False

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

--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

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

--subscription

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

--verbose

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

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

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

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

--add

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

значение по умолчанию: []

--file -f

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

--force-string

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

значение по умолчанию: False

--local

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

допустимые значения: false, true

значение по умолчанию: False

--mirror-traffic

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

--name -n

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

--no-wait

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

значение по умолчанию: False

--remove

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

значение по умолчанию: []

--set

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

значение по умолчанию: []

--traffic -r

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

--web -e

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

значение по умолчанию: False

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

--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

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

--subscription

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

--verbose

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