AciWebservice Classe

Representa um modelo de machine learning implantado como um ponto de extremidade de serviço Web em Instâncias de Contêiner do Azure.

Um serviço implantado é criado com base em 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, confira o documento Implantar um modelo nas Instâncias de Contêiner do Azure.

Inicialize a instância do Webservice.

O construtor do Webservice recupera uma representação na nuvem de um objeto webservice associado ao workspace 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

Nome	Description
workspace Obrigatório	Workspace O objeto de workspace que contém o objeto Webservice a ser recuperado.
name Obrigatório	str O nome do objeto webservice a ser recuperado.

Comentários

O padrão de implantação recomendado é criar um objeto de configuração de implantação com o deploy_configuration método e usá-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)

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

deploy do método para Model modelos já registrados no workspace.
deploy_from_image método de Webservice.
deploy_from_model de Webservice modelos já registrados no workspace. Esse método criará uma imagem.
deploy do Webservicemétodo , 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

Nome	Description
enable_app_insights	bool Se o registro em log do AppInsights está ou não habilitado para o serviço Web.
cname	str O cname para o serviço Web.
container_resource_requirements	ContainerResourceRequirements Os requisitos de recurso de contêiner para o serviço Web.
encryption_properties	EncryptionProperties As propriedades de criptografia para o serviço Web.
vnet_configuration	VnetConfiguration As propriedades de rede virtual para o serviço Web, a configuração deve ser criada e fornecida pelo usuário.
azureml.core.webservice.AciWebservice.location	str O local no qual o serviço Web é implantado.
public_ip	str O endereço ip público do serviço Web.
azureml.core.webservice.AciWebservice.scoring_uri	str O ponto de extremidade de pontuação para o serviço Web
ssl_enabled	bool Se o SSL está habilitado ou não para o serviço Web
public_fqdn	str O FQDN público para o serviço Web
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 serviço Web
azureml.core.webservice.AciWebservice.swagger_uri	str O ponto de extremidade swagger para o serviço Web

Métodos

add_properties	Adicione pares de valor de chave ao dicionário de propriedades desse serviço Web.
add_tags	Adicione pares de valor de chave ao dicionário de marcas desse serviço Web.
deploy_configuration	Crie um objeto de configuração para implantar um AciWebservice.
get_token	Recupere o token de autenticação para esse serviço Web, com escopo para o usuário atual. Observação Não implementado.
remove_tags	Remova as chaves especificadas do dicionário de marcas desse serviço Web.
run	Chame esse serviço Web com a entrada fornecida.
serialize	Converta esse serviço Web em um 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 valor de chave ao dicionário de propriedades desse serviço Web.

add_properties(properties)

Parâmetros

Nome	Description
properties Obrigatório	dict[str, str] O dicionário de propriedades a serem adicionadas.

add_tags

Adicione pares de valor de chave ao dicionário de marcas desse serviço Web.

add_tags(tags)

Parâmetros

Nome	Description
tags Obrigatório	dict[str, str] O dicionário de marcas a serem adicionadas.

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

Nome	Description
cpu_cores	float O número de núcleos de CPU a serem alocados para esse serviço Web. Pode ser um decimal. O padrão é 0.1 Valor padrão: None
memory_gb	float A quantidade de memória (em GB) a ser alocada para esse serviço Web. Pode ser um decimal. O padrão é 0,5 Valor padrão: None
tags	dict[str, str] Um dicionário de marcas de valor de chave para fornecer esse serviço Web. Valor padrão: None
properties	dict[str, str] Um dicionário de propriedades de valor de chave para fornecer esse serviço Web. Essas propriedades não podem ser alteradas após a implantação, no entanto, novos pares de valor de chave podem ser adicionados. Valor padrão: None
description	str Uma descrição para fornecer esse serviço Web. Valor padrão: None
location	str A região do Azure na qual implantar esse serviço Web. Se não for especificado, o local do workspace será usado. Para obter mais detalhes sobre as regiões disponíveis, consulte Produtos por região. Valor padrão: None
auth_enabled	bool Se deseja ou não habilitar a autenticação para este serviço Web. Usa False como padrão. Valor padrão: None
ssl_enabled	bool Se deseja ou não habilitar o SSL para este serviço Web. Usa False como padrão. Valor padrão: None
enable_app_insights	bool Habilitar ou não o AppInsights para esse serviço Web. Usa False como padrão. Valor padrão: None
ssl_cert_pem_file	str O arquivo de certificado necessário se o SSL estiver habilitado. Valor padrão: None
ssl_key_pem_file	str O arquivo de chave necessário se o SSL estiver habilitado. Valor padrão: None
ssl_cname	str O cname para se o SSL estiver habilitado. Valor padrão: 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. Valor padrão: None
primary_key	str Uma chave de autenticação primária a ser usada para este serviço Web. Valor padrão: None
secondary_key	str Uma chave de autenticação secundária a ser usada para este serviço Web. Valor padrão: None
collect_model_data	bool Se a coleta de dados do modelo foi habilitada ou não para o serviço Web. Valor padrão: None
cmk_vault_base_url	str URL base do cofre de chaves gerenciado pelo cliente Valor padrão: None
cmk_key_name	str nome da chave gerenciada pelo cliente. Valor padrão: None
cmk_key_version	str versão da chave gerenciada pelo cliente. Valor padrão: None
vnet_name	str nome da rede virtual. Valor padrão: None
subnet_name	str Nome da sub-rede na rede virtual. Valor padrão: None

Retornos

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 esse serviço Web, com escopo para o usuário atual.

Observação

Não implementado.

get_token()

Retornos

Tipo	Description
str, datetime	O token de autenticação para esse 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 marcas desse serviço Web.

remove_tags(tags)

Parâmetros

Nome	Description
tags Obrigatório	list[str] A lista de chaves a serem removidas.

run

Chame esse serviço Web com a entrada fornecida.

run(input_data)

Parâmetros

Nome	Description
input_data Obrigatório	<xref:varies> A entrada com a qual chamar o serviço Web.

Retornos

Tipo	Description
dict	O resultado de chamar o serviço Web.

Exceções

Tipo	Description
WebserviceException

serialize

Converta esse serviço Web em um dicionário serializado JSON.

serialize()

Retornos

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

Nome	Description
image	Image Uma nova imagem a ser implantada no serviço Web. Valor padrão: None
tags	dict[str, str] Um dicionário de marcas de valor de chave para fornecer esse serviço Web. Substituirá as marcas existentes. Valor padrão: None
properties	dict[str, str] Um dicionário de propriedades de valor de chave a ser adicionado ao dicionário de propriedades existentes. Valor padrão: None
description	str Uma descrição para fornecer esse serviço Web. Valor padrão: None
auth_enabled	bool Habilite ou desabilite a autenticação para este serviço Web. Valor padrão: None
ssl_enabled	bool Se deseja ou não habilitar o SSL para este serviço Web. Valor padrão: None
ssl_cert_pem_file	str O arquivo de certificado necessário se o SSL estiver habilitado. Valor padrão: None
ssl_key_pem_file	str O arquivo de chave necessário se o SSL estiver habilitado. Valor padrão: None
ssl_cname	str O cname para se o SSL estiver habilitado. Valor padrão: None
enable_app_insights	bool Habilitar ou não o AppInsights para esse serviço Web. Valor padrão: None
models	list[Model] Uma lista de objetos Model a serem empacotados no serviço atualizado. Valor padrão: None
inference_config	InferenceConfig Um objeto InferenceConfig usado para fornecer as propriedades de implantação de modelo necessárias. Valor padrão: None

Retornos

Tipo	Description
None

Comentários

Esta página foi útil?

Compartilhar via

AciWebservice Classe

Construtor

Parâmetros

Comentários

Variáveis

Métodos

add_properties

Parâmetros

add_tags

Parâmetros

Exceções

deploy_configuration

Parâmetros

Retornos

Exceções

get_token

Retornos

Exceções

remove_tags

Parâmetros

run

Parâmetros

Retornos

Exceções

serialize

Retornos

update

Parâmetros

Retornos

Comentários