Partilhar via

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

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

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 de chave para dar este webservice.

Default value: None
properties
dict[str, str]

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.

Default value: None
description
str

Uma descrição para dar a este Webservice.

Default value: None
location
str

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.

Default value: None
auth_enabled
bool

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

Default value: None
ssl_enabled
bool

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

Default value: None
enable_app_insights
bool

Quer ative ou não o AppInsights para este webservice. A predefinição é 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

Ativar ou não a recolha de dados do modelo 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 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 da chamada do Webservice.

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 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 a implementar no Webservice.

Default value: None
tags
dict[str, str]

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

Default value: None
properties
dict[str, str]

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

Default value: None
description
str

Uma descrição para dar a este Webservice.

Default value: None
auth_enabled
bool

Ativar ou desativar a autenticação para este 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 a 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