AciWebservice Classe

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

workspace

Workspace

Necessário

O objeto da área de trabalho que contém o objeto Webservice a obter.

name

str

Necessário

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 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 do Webservice, que registará um modelo e criará uma imagem.

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

• Consumir um modelo do Azure Machine Learning implementado como serviço Web

• Monitorizar e recolher dados de pontos finais de serviço Web de ML

• Resolução de problemas de implementação

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

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

encryption_properties

EncryptionProperties

As propriedades de encriptação do Webservice.

vnet_configuration

VnetConfiguration

As propriedades da rede virtual para o Serviço Web, a configuração devem ser criadas e fornecidas pelo utilizador.

azureml.core.webservice.AciWebservice.location

str

A localização onde o Webservice está implementado.

public_ip

str

O endereço IP público do Webservice.

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 Serviço Web

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 Webservice

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 Webservice com a entrada fornecida.
serialize	Converta este Webservice num 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 chave ao dicionário de propriedades deste Webservice.

add_properties(properties)

Parâmetros

properties

dict[str, str]

Necessário

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

tags

dict[str, str]

Necessário

O dicionário de etiquetas a adicionar.

Exceções

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

cpu_cores

float

valor predefinido: None

O número de núcleos de CPU a alocar para este webservice. Pode ser um decimal. Predefinições para 0.1

memory_gb

float

valor predefinido: None

A quantidade de memória (em GB) a alocar para este webservice. Pode ser um decimal. Predefinições para 0,5

tags

dict[str, str]

valor predefinido: None

Um dicionário de etiquetas de valor de chave para dar este webservice.

properties

dict[str, str]

valor predefinido: None

Um dicionário de propriedades de valor de 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.

description

str

valor predefinido: None

Uma descrição para dar a este Webservice.

location

str

valor predefinido: None

A região do Azure onde 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.

auth_enabled

bool

valor predefinido: None

Se pretende ativar ou não a autenticação para este webservice. A predefinição é Falso.

ssl_enabled

bool

valor predefinido: None

Quer ative ou não o SSL para este webservice. A predefinição é Falso.

enable_app_insights

bool

valor predefinido: None

Quer ative ou não o AppInsights para este webservice. A predefinição é Falso.

ssl_cert_pem_file

str

valor predefinido: None

O ficheiro de certificado necessário se o SSL estiver ativado.

ssl_key_pem_file

str

valor predefinido: None

O ficheiro de chave necessário se o SSL estiver ativado.

ssl_cname

str

valor predefinido: None

O cname para se o SSL estiver ativado.

dns_name_label

str

valor predefinido: None

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.

primary_key

str

valor predefinido: None

Uma chave de autenticação primária a utilizar para este webservice.

secondary_key

str

valor predefinido: None

Uma chave de autenticação secundária a utilizar para este webservice.

collect_model_data

bool

valor predefinido: None

Ativar ou não a recolha de dados do modelo para o Webservice.

cmk_vault_base_url

str

valor predefinido: None

URL base do cofre de chaves gerido pelo cliente

cmk_key_name

str

valor predefinido: None

nome da chave gerida pelo cliente.

cmk_key_version

str

valor predefinido: None

versão da chave gerida pelo cliente.

vnet_name

str

valor predefinido: None

nome da rede virtual.

subnet_name

str

valor predefinido: None

nome da sub-rede na rede virtual.

Devoluções

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

Tipo de retorno

AciServiceDeploymentConfiguration

Exceções

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

O token de autenticação para este webservice e quando deve ser atualizado depois.

Tipo de retorno

str, datetime

Exceções

azureml.exceptions.NotImplementedError

remove_tags

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

remove_tags(tags)

Parâmetros

tags

list[str]

Necessário

A lista de chaves a remover.

run

Chame este Webservice com a entrada fornecida.

run(input_data)

Parâmetros

input_data

<xref:varies>

Necessário

A entrada para chamar o Webservice com.

Devoluções

O resultado da chamada do Webservice.

Tipo de retorno

dict

Exceções

WebserviceException

serialize

Converta este Webservice num dicionário serializado JSON.

serialize()

Devoluções

A representação JSON deste objeto Webservice.

Tipo de retorno

dict

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

image

Image

valor predefinido: None

Uma nova Imagem a implementar no Webservice.

tags

dict[str, str]

valor predefinido: None

Um dicionário de etiquetas de valor de chave para dar este webservice. Substituirá as etiquetas existentes.

properties

dict[str, str]

valor predefinido: None

Um dicionário de propriedades de valor de chave para adicionar ao dicionário de propriedades existente.

description

str

valor predefinido: None

Uma descrição para dar a este Webservice.

auth_enabled

bool

valor predefinido: None

Ativar ou desativar a autenticação para este webservice.

ssl_enabled

bool

valor predefinido: None

Quer ative ou não o SSL para este webservice.

ssl_cert_pem_file

str

valor predefinido: None

O ficheiro de certificado necessário se o SSL estiver ativado.

ssl_key_pem_file

str

valor predefinido: None

O ficheiro de chave necessário se o SSL estiver ativado.

ssl_cname

str

valor predefinido: None

O cname para se o SSL estiver ativado.

enable_app_insights

bool

valor predefinido: None

Quer ative ou não o AppInsights para este webservice.

models

list[Model]

valor predefinido: None

Uma lista de Objetos de modelo a empacotar no serviço atualizado.

inference_config

InferenceConfig

valor predefinido: None

Um objeto InferenceConfig utilizado para fornecer as propriedades de implementação do modelo necessárias.

Tipo de retorno

None