AciWebservice Classe

Representa um modelo de aprendizado de máquina implantado como um ponto de extremidade de serviço Web em Instâncias de Contêiner do Azure.

Um serviço implantado é criado a partir de um modelo, script e arquivos associados. O serviço Web resultante é um ponto de extremidade HTTP com balanceamento de carga com uma API REST. Você pode enviar dados para essa API e receber a previsão retornada pelo modelo.

Para obter mais informações, consulte Implantar um modelo em instâncias de contêiner do Azure.

Inicialize a instância do Webservice.

O construtor Webservice recupera uma representação na nuvem de um objeto Webservice associado ao espaço de trabalho fornecido. Ele retornará uma instância de uma classe filho correspondente ao tipo específico do objeto Webservice recuperado.

Construtor

AciWebservice(workspace, name)

Parâmetros

Name	Description
workspace Necessário	Workspace O objeto de espaço de trabalho que contém o objeto Webservice a ser recuperado.
name Necessário	str O nome do objeto Webservice a ser recuperado.

Observações

O padrão de implantação recomendado é criar um objeto de configuração de implantação com o deploy_configuration método e, em seguida, usá-lo com o deploy método da classe, Model 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)

Há várias maneiras de implantar um modelo como um serviço Web, inclusive com:

deploy método do para modelos já registrados no espaço de Model trabalho.
deploy_from_image método de Webservice.
deploy_from_model método de para modelos já registrados no espaço de Webservice trabalho. Este método criará uma imagem.
deploy método do Webservice, que registrará um modelo e criará uma imagem.

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

A seção Variáveis lista atributos de uma representação local do objeto AciWebservice na nuvem. Essas variáveis devem ser consideradas somente leitura. A alteração de seus valores não será refletida no objeto de nuvem correspondente.

Variáveis

Name	Description
enable_app_insights	bool Se o log do AppInsights está habilitado ou não para o WebService.
cname	str O cname para o WebService.
container_resource_requirements	ContainerResourceRequirements Os requisitos de recursos de contêiner para o WebService.
encryption_properties	EncryptionProperties As propriedades de criptografia para o WebService.
vnet_configuration	VnetConfiguration As propriedades de rede virtual para o Webservice, configuração deve ser criada e fornecida pelo usuário.
azureml.core.webservice.AciWebservice.location	str O local em que o Webservice é implantado.
public_ip	str O endereço IP público do WebService.
azureml.core.webservice.AciWebservice.scoring_uri	str O ponto de extremidade de pontuação para o Webservice
ssl_enabled	bool Se o SSL está ou não habilitado para o WebService
public_fqdn	str O FQDN público para o WebService
environment	Environment O objeto Environment que foi usado para criar o Webservice
azureml.core.webservice.AciWebservice.models	list[Model] Uma lista de modelos implantados no Webservice
azureml.core.webservice.AciWebservice.swagger_uri	str O ponto de extremidade swagger para o Webservice

Métodos

add_properties	Adicione pares de valores de chave ao dicionário de propriedades deste WebService.
add_tags	Adicione pares de valor-chave ao dicionário de tags deste WebService.
deploy_configuration	Crie um objeto de configuração para implantar um AciWebservice.
get_token	Recupere o token de autenticação para este WebService, com escopo para o usuário atual. Observação Não implementado.
remove_tags	Remova as chaves especificadas do dicionário de tags deste WebService.
run	Chame este Webservice com a entrada fornecida.
serialize	Converta este Webservice em um dicionário serializado JSON.
update	Atualize o Webservice com as propriedades fornecidas. Os valores deixados como Nenhum permanecerão inalterados neste WebService.

add_properties

Adicione pares de valores de 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 valor-chave ao dicionário de tags deste WebService.

add_tags(tags)

Parâmetros

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

Exceções

Tipo	Description
WebserviceException

deploy_configuration

Crie um objeto de configuração para implantar 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 decimal. O padrão é 0,1 Default value: None
memory_gb	float A quantidade de memória (em GB) a alocar para este WebService. Pode ser decimal. O padrão é 0,5 Default value: None
tags	dict[str, str] Um dicionário de tags de valor chave para fornecer este WebService. Default value: None
properties	dict[str, str] Um dicionário de propriedades de valor de chave para fornecer este WebService. Essas propriedades não podem ser alteradas após a implantação, no entanto, novos pares de valor de chave podem ser adicionados. Default value: None
description	str Uma descrição para fornecer este WebService. Default value: None
location	str A região do Azure na qual implantar este WebService. Se não for especificado, o local do espaço de trabalho será usado. Para obter mais detalhes sobre as regiões disponíveis, consulte Produtos por região. Default value: None
auth_enabled	bool Habilitar ou não a autenticação para este WebService. A definição padrão é 'False'. Default value: None
ssl_enabled	bool Ativar ou não o SSL para este WebService. A definição padrão é 'False'. Default value: None
enable_app_insights	bool Habilitar ou não o AppInsights para este WebService. A definição padrão é 'False'. Default value: None
ssl_cert_pem_file	str O arquivo cert necessário se o SSL estiver habilitado. Default value: None
ssl_key_pem_file	str O arquivo de chave necessário se o SSL estiver habilitado. Default value: None
ssl_cname	str O cname para se o SSL estiver habilitado. Default value: None
dns_name_label	str O rótulo de nome DNS para o ponto de extremidade de pontuação. Se não for especificado, um rótulo de nome DNS exclusivo será gerado para o ponto de extremidade de pontuação. Default value: None
primary_key	str Uma chave de autenticação primária a ser usada para este WebService. Default value: None
secondary_key	str Uma chave de autenticação secundária a ser usada para este WebService. Default value: None
collect_model_data	bool Se a coleta de dados de modelo deve ou não ser habilitada para o WebService. Default value: None
cmk_vault_base_url	str URL base do cofre de chaves gerenciado pelo cliente Default value: None
cmk_key_name	str nome da chave gerenciada pelo cliente. Default value: None
cmk_key_version	str versão da chave gerenciada 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 ser usado ao implantar um objeto Webservice.

Exceções

Tipo	Description
WebserviceException

get_token

Recupere o token de autenticação para este WebService, com escopo para o usuário atual.

Observação

Não implementado.

get_token()

Devoluções

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

Exceções

Tipo	Description
azureml.exceptions.NotImplementedError

remove_tags

Remova as chaves especificadas do dicionário de tags deste WebService.

remove_tags(tags)

Parâmetros

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

run

Chame este Webservice com a entrada fornecida.

run(input_data)

Parâmetros

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

Devoluções

Tipo	Description
dict	O resultado de chamar o WebService.

Exceções

Tipo	Description
WebserviceException

serialize

Converta este Webservice em um dicionário serializado JSON.

serialize()

Devoluções

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

update

Atualize o Webservice com as propriedades fornecidas.

Os valores deixados como Nenhum permanecerão inalterados neste WebService.

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 implantar no WebService. Default value: None
tags	dict[str, str] Um dicionário de tags de valor chave para fornecer este WebService. Substituirá as tags existentes. Default value: None
properties	dict[str, str] Um dicionário de propriedades de valor chave para adicionar ao dicionário de propriedades existente. Default value: None
description	str Uma descrição para fornecer este WebService. Default value: None
auth_enabled	bool Habilite ou desabilite a autenticação para este WebService. Default value: None
ssl_enabled	bool Ativar ou não o SSL para este WebService. Default value: None
ssl_cert_pem_file	str O arquivo cert necessário se o SSL estiver habilitado. Default value: None
ssl_key_pem_file	str O arquivo de chave necessário se o SSL estiver habilitado. Default value: None
ssl_cname	str O cname para se o SSL estiver habilitado. Default value: None
enable_app_insights	bool Habilitar ou não o AppInsights para este WebService. Default value: None
models	list[Model] Uma lista de objetos Model a serem empacotados no serviço atualizado. Default value: None
inference_config	InferenceConfig Um objeto InferenceConfig usado para fornecer as propriedades de implantação de modelo necessárias. Default value: None

Devoluções

Tipo	Description
None

Feedback

Esta página foi útil?

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

Feedback