Partilhar via


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
AciWebservice

Construtor

AciWebservice(workspace, name)

Parâmetros

Name Description
workspace
Necessário

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

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

Os requisitos de recursos de contentor para o Serviço Web.

encryption_properties

As propriedades de encriptação do Serviço Web.

vnet_configuration

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

Se o SSL está ou não ativado para o Serviço Web

public_fqdn
str

O FQDN público para o Webservice

environment

O objeto Ambiente que foi utilizado para criar o Webservice

azureml.core.webservice.AciWebservice.models

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

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

O dicionário de etiquetas a adicionar.

Exceções

Tipo Description

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

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

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

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

Default value: None
properties

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

Quer ative ou não a autenticação para este Webservice. Predefinições para Falso.

Default value: None
ssl_enabled

Quer ative ou não o SSL para este Webservice. Predefinições para Falso.

Default value: None
enable_app_insights

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

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

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

Exceções

Tipo Description

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

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

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

O resultado da chamada para o Serviço Web.

Exceções

Tipo Description

serialize

Converta este Webservice num dicionário serializado JSON.

serialize()

Devoluções

Tipo Description

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

Uma nova Imagem para implementar no serviço Web.

Default value: None
tags

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

Default value: None
properties

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

Ative ou desative a autenticação deste Webservice.

Default value: None
ssl_enabled

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

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

Default value: None
models

Uma lista de objetos de Modelo para empacotar no serviço atualizado.

Default value: None
inference_config

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

Default value: None

Devoluções

Tipo Description