AciWebservice Classe

Referência

Representa um modelo de machine learning implementado como um ponto final de serviço Web no Azure Container Instances.

Um serviço implementado é criado a partir de um modelo, script e ficheiros associados. O serviço Web resultante é um ponto final HTTP com balanceamento de carga com uma API REST. Pode enviar dados para esta API e receber a predição devolvida pelo modelo.

Para obter mais informações, veja Implementar um modelo para Azure Container Instances.

Inicialize a instância do Webservice.

O construtor webservice obtém uma representação na cloud de um objeto Webservice associado à área de trabalho fornecida. Devolverá uma instância de uma classe subordinada correspondente ao tipo específico do objeto Webservice obtido.

Herança: Webservice

AciWebservice

Construtor

AciWebservice(workspace, name)

Parâmetros

Name	Description
workspace Necessário	Workspace O objeto da área de trabalho que contém o objeto Webservice a obter.
name Necessário	str O nome do objeto Webservice a obter.

Observações

O padrão de implementação recomendado é criar um objeto de configuração de implementação com o deploy_configuration método e, em seguida, utilizá-lo com o deploy método da Model classe, conforme mostrado abaixo.


   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)

Existem várias formas de implementar um modelo como um serviço Web, incluindo com:

deploy método do Model para modelos já registados na área de trabalho.
deploy_from_image método de Webservice.
deploy_from_model método de Webservice para modelos já registados na área de trabalho. Este método irá criar uma imagem.
deploy método do Webservice, que irá registar um modelo e criar uma imagem.

Para obter informações sobre como trabalhar com serviços Web, consulte

A secção Variables (Variáveis ) lista os atributos de uma representação local do objeto cloud AciWebservice. Estas variáveis devem ser consideradas só de leitura. A alteração dos respetivos valores não será refletida no objeto de cloud correspondente.

Variáveis

Name	Description
enable_app_insights	bool Se o registo do AppInsights está ou não ativado para o Serviço Web.
cname	str O cname do serviço Web.
container_resource_requirements	ContainerResourceRequirements Os requisitos de recursos de contentor para o Serviço Web.
encryption_properties	EncryptionProperties As propriedades de encriptação do Serviço Web.
vnet_configuration	VnetConfiguration As propriedades da rede virtual para o Serviço Web devem ser criadas e fornecidas pelo utilizador.
azureml.core.webservice.AciWebservice.location	str A localização onde o Serviço Web está implementado.
public_ip	str O endereço IP público do Serviço Web.
azureml.core.webservice.AciWebservice.scoring_uri	str O ponto final de classificação do Webservice
ssl_enabled	bool Se o SSL está ou não ativado para o Serviço Web
public_fqdn	str O FQDN público para o Webservice
environment	Environment O objeto Ambiente que foi utilizado para criar o Webservice
azureml.core.webservice.AciWebservice.models	list[Model] Uma lista de Modelos implementados no Webservice
azureml.core.webservice.AciWebservice.swagger_uri	str O ponto final swagger para o Serviço Web

Métodos

add_properties	Adicione pares de valores chave ao dicionário de propriedades deste Webservice.
add_tags	Adicione pares de valores chave ao dicionário de etiquetas deste Webservice.
deploy_configuration	Crie um objeto de configuração para implementar um AciWebservice.
get_token	Obtenha o token de autenticação para este Webservice, no âmbito do utilizador atual. Nota Não implementado.
remove_tags	Remova as chaves especificadas do dicionário de etiquetas deste Webservice.
run	Chame este Serviço Web com a entrada fornecida.
serialize	Converta este Webservice num dicionário serializado JSON.
update	Atualize o Serviço Web com as propriedades fornecidas. Os valores deixados como Nenhum permanecerão inalterados neste Serviço Web.

add_properties

Adicione pares de valores chave ao dicionário de propriedades deste Webservice.

add_properties(properties)

Parâmetros

Name	Description
properties Necessário	dict[str, str] O dicionário de propriedades a adicionar.

add_tags

Adicione pares de valores chave ao dicionário de etiquetas deste Webservice.

add_tags(tags)

Parâmetros

Name	Description
tags Necessário	dict[str, str] O dicionário de etiquetas a adicionar.

Exceções

Tipo	Description
WebserviceException

deploy_configuration

Crie um objeto de configuração para implementar um 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)

Parâmetros

Name	Description
cpu_cores	float O número de núcleos de CPU a alocar para este Webservice. Pode ser um decimal. Predefinições para 0.1 Default value: None
memory_gb	float A quantidade de memória (em GB) a alocar para este Webservice. Pode ser um decimal. Predefinições para 0,5 Default value: None
tags	dict[str, str] Um dicionário de etiquetas de valor chave para fornecer este webservice. Default value: None
properties	dict[str, str] Um dicionário de propriedades de valor chave para fornecer este webservice. Estas propriedades não podem ser alteradas após a implementação, no entanto, podem ser adicionados novos pares de valores chave. Default value: None
description	str Uma descrição para fornecer este serviço Web. Default value: None
location	str A região do Azure para implementar este Webservice. Se não for especificada, será utilizada a localização da Área de Trabalho. Para obter mais detalhes sobre as regiões disponíveis, veja Produtos por região. Default value: None
auth_enabled	bool Quer ative ou não a autenticação para este Webservice. Predefinições para Falso. Default value: None
ssl_enabled	bool Quer ative ou não o SSL para este Webservice. Predefinições para Falso. Default value: None
enable_app_insights	bool Quer ative ou não o AppInsights para este Webservice. Predefinições para Falso. Default value: None
ssl_cert_pem_file	str O ficheiro de certificado necessário se o SSL estiver ativado. Default value: None
ssl_key_pem_file	str O ficheiro de chave necessário se o SSL estiver ativado. Default value: None
ssl_cname	str O cname para se o SSL estiver ativado. Default value: None
dns_name_label	str A etiqueta de nome DNS para o ponto final de classificação. Se não for especificada, será gerada uma etiqueta de nome DNS exclusiva para o ponto final de classificação. Default value: None
primary_key	str Uma chave de autenticação primária a utilizar para este webservice. Default value: None
secondary_key	str Uma chave de autenticação secundária a utilizar para este webservice. Default value: None
collect_model_data	bool Quer tenha ou não ativado a recolha de dados de modelos para o Webservice. Default value: None
cmk_vault_base_url	str url base do cofre de chaves gerido pelo cliente Default value: None
cmk_key_name	str nome da chave gerida pelo cliente. Default value: None
cmk_key_version	str versão da chave gerida pelo cliente. Default value: None
vnet_name	str nome da rede virtual. Default value: None
subnet_name	str nome da sub-rede na rede virtual. Default value: None

Devoluções

Tipo	Description
AciServiceDeploymentConfiguration	Um objeto de configuração a utilizar ao implementar um objeto webservice.

Exceções

Tipo	Description
WebserviceException

get_token

Obtenha o token de autenticação para este Webservice, no âmbito do utilizador atual.

Nota

Não implementado.

get_token()

Devoluções

Tipo	Description
str, datetime	O token de autenticação para este Webservice e quando deve ser atualizado depois.

Exceções

Tipo	Description
azureml.exceptions.NotImplementedError

remove_tags

Remova as chaves especificadas do dicionário de etiquetas deste Webservice.

remove_tags(tags)

Parâmetros

Name	Description
tags Necessário	list[str] A lista de chaves a remover.

run

Chame este Serviço Web com a entrada fornecida.

run(input_data)

Parâmetros

Name	Description
input_data Necessário	<xref:varies> A entrada para chamar o Serviço Web com.

Devoluções

Tipo	Description
dict	O resultado da chamada para o Serviço Web.

Exceções

Tipo	Description
WebserviceException

serialize

Converta este Webservice num dicionário serializado JSON.

serialize()

Devoluções

Tipo	Description
dict	A representação JSON deste objeto webservice.

update

Atualize o Serviço Web com as propriedades fornecidas.

Os valores deixados como Nenhum permanecerão inalterados neste Serviço Web.

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)

Parâmetros

Name	Description
image	Image Uma nova Imagem para implementar no serviço Web. Default value: None
tags	dict[str, str] Um dicionário de etiquetas de valor chave para fornecer este webservice. Substituirá as etiquetas existentes. Default value: None
properties	dict[str, str] Um dicionário de propriedades de valor chave para adicionar ao dicionário de propriedades existentes. Default value: None
description	str Uma descrição para fornecer este serviço Web. Default value: None
auth_enabled	bool Ative ou desative a autenticação deste Webservice. Default value: None
ssl_enabled	bool Quer ative ou não o SSL para este Webservice. Default value: None
ssl_cert_pem_file	str O ficheiro de certificado necessário se o SSL estiver ativado. Default value: None
ssl_key_pem_file	str O ficheiro de chave necessário se o SSL estiver ativado. Default value: None
ssl_cname	str O cname para se o SSL estiver ativado. Default value: None
enable_app_insights	bool Quer ative ou não o AppInsights para este Webservice. Default value: None
models	list[Model] Uma lista de objetos de Modelo para empacotar no serviço atualizado. Default value: None
inference_config	InferenceConfig Um objeto InferenceConfig utilizado para fornecer as propriedades de implementação do modelo necessárias. Default value: None

Devoluções

Tipo	Description
None

Partilhar via

AciWebservice Classe

Construtor

Parâmetros

Observações

Variáveis

Métodos

add_properties

Parâmetros

add_tags

Parâmetros

Exceções

deploy_configuration

Parâmetros

Devoluções

Exceções

get_token

Devoluções

Exceções

remove_tags

Parâmetros

run

Parâmetros

Devoluções

Exceções

serialize

Devoluções

update

Parâmetros

Devoluções

Comentários

Recursos adicionais