AciWebservice Класс

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

Развернутая служба создается из модели, скрипта и связанных файлов. Полученная веб-служба — это конечная точка HTTP с балансировкой нагрузки с помощью REST API. Вы можете отправлять данные в этот API и получать прогноз, возвращаемый моделью.

Дополнительные сведения см. в статье Развертывание модели в экземплярах контейнеров Azure.

Инициализация экземпляра веб-службы.

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

Конструктор

AciWebservice(workspace, name)

Параметры

Имя	Описание
workspace Обязательно	Workspace Объект рабочей области, содержащий объект веб-службы для извлечения.
name Обязательно	str Имя извлекаемого объекта веб-службы.

Рекомендуемый шаблон развертывания — создать объект конфигурации развертывания с deploy_configuration методом, а затем использовать его с deploy методом Model класса, как показано ниже.


   from azureml.core.model import InferenceConfig
   from azureml.core.webservice import AciWebservice


   service_name = 'my-custom-env-service'

   inference_config = InferenceConfig(entry_script='score.py', environment=environment)
   aci_config = AciWebservice.deploy_configuration(cpu_cores=1, memory_gb=1)

   service = Model.deploy(workspace=ws,
                          name=service_name,
                          models=[model],
                          inference_config=inference_config,
                          deployment_config=aci_config,
                          overwrite=True)
   service.wait_for_deployment(show_output=True)

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

deploy Метод для моделей Model , уже зарегистрированных в рабочей области.
deploy_from_image Webserviceметод .
deploy_from_model Метод для моделей Webservice , уже зарегистрированных в рабочей области. Этот метод создаст изображение.
deploy Webserviceметод , который будет регистрировать модель и создавать изображение.

Сведения о работе с веб-службами см. в разделе

В разделе "Переменные" перечислены атрибуты локального представления объекта AciWebservice облака. Эти переменные должны рассматриваться только для чтения. Изменение их значений не будет отражено в соответствующем облачном объекте.

Переменные

Имя	Описание
enable_app_insights	bool Включена ли ведение журнала AppInsights для веб-службы.
cname	str Имя cname для веб-службы.
container_resource_requirements	ContainerResourceRequirements Требования к ресурсу контейнера для веб-службы.
encryption_properties	EncryptionProperties Свойства шифрования веб-службы.
vnet_configuration	VnetConfiguration Свойства виртуальной сети для веб-службы должны быть созданы и предоставлены пользователем.
azureml.core.webservice.AciWebservice.location	str Расположение веб-службы развертывается в.
public_ip	str Общедоступный IP-адрес веб-службы.
azureml.core.webservice.AciWebservice.scoring_uri	str Конечная точка оценки для веб-службы
ssl_enabled	bool Включена ли протокол SSL для веб-службы.
public_fqdn	str Общедоступное полное доменное имя веб-службы
environment	Environment Объект Среды, используемый для создания веб-службы
azureml.core.webservice.AciWebservice.models	list[Model] Список моделей, развернутых в веб-службе
azureml.core.webservice.AciWebservice.swagger_uri	str Конечная точка swagger для веб-службы

Методы

add_properties	Добавьте пары значений ключа в словарь свойств этой веб-службы.
add_tags	Добавьте пары значений ключа в словарь тегов веб-службы.
deploy_configuration	Создайте объект конфигурации для развертывания AciWebservice.
get_token	Получение маркера проверки подлинности для этой веб-службы, заданного текущим пользователем. Замечание Не реализовано.
remove_tags	Удалите указанные ключи из словаря тегов этой веб-службы.
run	Вызовите эту веб-службу с предоставленными входными данными.
serialize	Преобразуйте эту веб-службу в сериализованный словарь JSON.
update	Обновите веб-службу с предоставленными свойствами. Значения, оставленные как None, останутся неизменными в этой веб-службе.

add_properties

Добавьте пары значений ключа в словарь свойств этой веб-службы.

add_properties(properties)

Параметры

Имя	Описание
properties Обязательно	dict[str, str] Словарь добавляемых свойств.

add_tags

Добавьте пары значений ключа в словарь тегов веб-службы.

add_tags(tags)

Параметры

Имя	Описание
tags Обязательно	dict[str, str] Словарь добавляемых тегов.

Исключения

Тип	Описание
WebserviceException

deploy_configuration

Создайте объект конфигурации для развертывания AciWebservice.

static deploy_configuration(cpu_cores=None, memory_gb=None, tags=None, properties=None, description=None, location=None, auth_enabled=None, ssl_enabled=None, enable_app_insights=None, ssl_cert_pem_file=None, ssl_key_pem_file=None, ssl_cname=None, dns_name_label=None, primary_key=None, secondary_key=None, collect_model_data=None, cmk_vault_base_url=None, cmk_key_name=None, cmk_key_version=None, vnet_name=None, subnet_name=None)

Параметры

Имя	Описание
cpu_cores	float Количество ядер ЦП, выделяемых для этой веб-службы. Может быть десятичным. Значение по умолчанию — 0.1 Default value: None
memory_gb	float Объем памяти (в ГБ) для этой веб-службы. Может быть десятичным. Значение по умолчанию — 0.5 Default value: None
tags	dict[str, str] Словарь тегов значений ключа для предоставления этой веб-службы. Default value: None
properties	dict[str, str] Словарь свойств значений ключа для предоставления этой веб-службы. Эти свойства нельзя изменить после развертывания, однако можно добавить новые пары значений ключей. Default value: None
description	str Описание для предоставления этой веб-службы. Default value: None
location	str Регион Azure для развертывания этой веб-службы. Если не указать, будет использоваться расположение рабочей области. Дополнительные сведения о доступных регионах см. в разделе "Продукты по регионам". Default value: None
auth_enabled	bool Следует ли включить проверку подлинности для этой веб-службы. По умолчанию False. Default value: None
ssl_enabled	bool Следует ли включить SSL для этой веб-службы. По умолчанию False. Default value: None
enable_app_insights	bool Следует ли включить AppInsights для этой веб-службы. По умолчанию False. Default value: None
ssl_cert_pem_file	str Файл сертификата, необходимый, если включен ПРОТОКОЛ SSL. Default value: None
ssl_key_pem_file	str Файл ключа, необходимый для включения SSL. Default value: None
ssl_cname	str Имя cname, если протокол SSL включен. Default value: None
dns_name_label	str Метка DNS-имени для конечной точки оценки. Если не указана уникальная метка DNS-имени, будет создана для конечной точки оценки. Default value: None
primary_key	str Первичный ключ проверки подлинности, используемый для этой веб-службы. Default value: None
secondary_key	str Дополнительный ключ проверки подлинности, используемый для этой веб-службы. Default value: None
collect_model_data	bool Независимо от того, включена ли сбор данных модели для веб-службы. Default value: None
cmk_vault_base_url	str Базовый URL-адрес управляемого хранилища ключей клиента Default value: None
cmk_key_name	str Имя ключа, управляемого клиентом. Default value: None
cmk_key_version	str Версия управляемого клиентом ключа. Default value: None
vnet_name	str имя виртуальной сети. Default value: None
subnet_name	str Имя подсети в виртуальной сети. Default value: None

Возвращаемое значение

Тип	Описание
AciServiceDeploymentConfiguration	Объект конфигурации, используемый при развертывании объекта веб-службы.

Исключения

Тип	Описание
WebserviceException

get_token

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

Замечание

Не реализовано.

get_token()

Возвращаемое значение

Тип	Описание
str, datetime	Маркер проверки подлинности для этой веб-службы и после обновления.

Исключения

Тип	Описание
azureml.exceptions.NotImplementedError

remove_tags

Удалите указанные ключи из словаря тегов этой веб-службы.

remove_tags(tags)

Параметры

Имя	Описание
tags Обязательно	list[str] Список ключей для удаления.

run

Вызовите эту веб-службу с предоставленными входными данными.

run(input_data)

Параметры

Имя	Описание
input_data Обязательно	<xref:varies> Входные данные для вызова веб-службы.

Возвращаемое значение

Тип	Описание
dict	Результат вызова веб-службы.

Исключения

Тип	Описание
WebserviceException

serialize

Преобразуйте эту веб-службу в сериализованный словарь JSON.

serialize()

Возвращаемое значение

Тип	Описание
dict	Представление JSON этого объекта веб-службы.

update

Обновите веб-службу с предоставленными свойствами.

Значения, оставленные как None, останутся неизменными в этой веб-службе.

update(image=None, tags=None, properties=None, description=None, auth_enabled=None, ssl_enabled=None, ssl_cert_pem_file=None, ssl_key_pem_file=None, ssl_cname=None, enable_app_insights=None, models=None, inference_config=None)

Параметры

Имя	Описание
image	Image Новый образ для развертывания в веб-службе. Default value: None
tags	dict[str, str] Словарь тегов значений ключа для предоставления этой веб-службы. Заменит существующие теги. Default value: None
properties	dict[str, str] Словарь свойств ключевого значения для добавления в существующий словарь свойств. Default value: None
description	str Описание для предоставления этой веб-службы. Default value: None
auth_enabled	bool Включите или отключите проверку подлинности для этой веб-службы. Default value: None
ssl_enabled	bool Следует ли включить SSL для этой веб-службы. Default value: None
ssl_cert_pem_file	str Файл сертификата, необходимый, если включен ПРОТОКОЛ SSL. Default value: None
ssl_key_pem_file	str Файл ключа, необходимый для включения SSL. Default value: None
ssl_cname	str Имя cname, если протокол SSL включен. Default value: None
enable_app_insights	bool Следует ли включить AppInsights для этой веб-службы. Default value: None
models	list[Model] Список объектов модели для упаковки в обновленную службу. Default value: None
inference_config	InferenceConfig Объект InferenceConfig, используемый для предоставления необходимых свойств развертывания модели. Default value: None

Возвращаемое значение

Тип	Описание
None

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

Были ли сведения на этой странице полезными?

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

Конструктор

Параметры

Комментарии

Переменные

add_properties

Параметры

add_tags

Параметры

Исключения

deploy_configuration

Параметры

Возвращаемое значение

Исключения

get_token

Возвращаемое значение

Исключения

remove_tags

Параметры

run

Параметры

Возвращаемое значение

Исключения

serialize

Возвращаемое значение

update

Параметры

Возвращаемое значение