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 implementado é 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, confira o documento Implantar um modelo nas Instâncias de Contêiner do Azure.

Inicialize a instância de serviço Web.

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

Herança

Webservice

AciWebservice

Construtor

AciWebservice(workspace, name)

Parâmetros

workspace

Workspace

Obrigatório

O objeto de workspace que contém o objeto de serviço Web a ser recuperado.

name

str

Obrigatório

O nome do objeto de serviço Web a ser recuperado.

Comentários

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

• o método deploy do Model para modelos já registrados no workspace.

• o método deploy_from_image do Webservice.

• o método deploy_from_model do Webservice para modelos já registrados no workspace. Esse método criará uma imagem.

• o método deploy do Webservice, que registrará um modelo e criará uma imagem.

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

• Consumir um modelo de Azure Machine Learning implantado como um serviço Web

• Monitorar e coletar dados de pontos de extremidade de serviço Web do ML

• Solucionando problemas da implantação

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

Variáveis

enable_app_insights

bool

Se o log do AppInsights está habilitado ou não para o serviço Web.

cname

str

O cname do serviço Web.

container_resource_requirements

ContainerResourceRequirements

Os requisitos de recursos do contêiner do serviço Web.

encryption_properties

EncryptionProperties

As propriedades de criptografia do serviço Web.

vnet_configuration

VnetConfiguration

As propriedades da rede virtual do serviço Web; a configuração deve ser criada e fornecida pelo usuário.

azureml.core.webservice.AciWebservice.location

str

O local em que 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 serviço Web

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 do swagger para o serviço Web

Métodos

add_properties	Adiciona pares chave-valor ao dicionário de propriedades desse serviço Web.
add_tags	Adiciona pares de chave-valor ao dicionário de marcas desse serviço Web.
deploy_configuration	Cria um objeto de configuração para implantar um AciWebservice.
get_token	Recuperar o token de autenticação para esse serviço Web, com escopo para o usuário atual. Observação Não implementado.
remove_tags	Remove as chaves especificadas do dicionário de marcas deste serviço Web.
run	Chamar esse serviço Web com a entrada fornecida.
serialize	Converte esse serviço Web em um dicionário serializado JSON.
update	Atualiza o serviço Web com as propriedades fornecidas. Os valores deixados como None permanecerão inalterados neste serviço Web.

add_properties

Adiciona pares chave-valor ao dicionário de propriedades desse serviço Web.

add_properties(properties)

Parâmetros

properties

dict[str, str]

Obrigatório

O dicionário de propriedades a adicionar.

add_tags

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

add_tags(tags)

Parâmetros

tags

dict[str, str]

Obrigatório

O dicionário de marcas a adicionar.

Exceções

WebserviceException

deploy_configuration

Cria 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

cpu_cores

float

valor padrão: None

O número de núcleos de CPU a serem alocados para esse serviço Web. Pode ser um decimal. O valor padrão é 0,1

memory_gb

float

valor padrão: None

A quantidade de memória (em GB) alocada para esse serviço Web. Pode ser um decimal. O valor padrão é 0.5

tags

dict[str, str]

valor padrão: None

Um dicionário de marcas de chave-valor a serem fornecidas a esse serviço Web.

properties

dict[str, str]

valor padrão: None

Um dicionário de propriedades de chave-valor a serem fornecidas a esse serviço Web. Essas propriedades não podem ser alteradas após a implantação, no entanto, novos pares de chave/valor podem ser adicionados.

description

str

valor padrão: None

Uma descrição a ser fornecida a esse serviço Web.

location

str

valor padrão: None

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.

auth_enabled

bool

valor padrão: None

Se a autenticação deve ou não ser habilitada para esse serviço Web. Usa False como padrão.

ssl_enabled

bool

valor padrão: None

Se o SSL deve ser habilitado ou não para esse serviço Web. Usa False como padrão.

enable_app_insights

bool

valor padrão: None

Se o AppInsights deve ser habilitado ou não para esse serviço Web. Usa False como padrão.

ssl_cert_pem_file

str

valor padrão: None

O arquivo de certificado necessário se o SSL estiver habilitado.

ssl_key_pem_file

str

valor padrão: None

O arquivo de chave necessário se o SSL estiver habilitado.

ssl_cname

str

valor padrão: None

O cname a ser usado se o SSL estiver habilitado.

dns_name_label

str

valor padrão: None

O rótulo de nome DNS do ponto de extremidade de pontuação. Se ele não for especificado, um rótulo de nome DNS exclusivo será gerado para o ponto de extremidade de pontuação.

primary_key

str

valor padrão: None

Uma chave de autenticação primária a ser usada para esse serviço Web.

secondary_key

str

valor padrão: None

Uma chave de autenticação secundária a ser usada para esse serviço Web.

collect_model_data

bool

valor padrão: None

Se a coleta de dados de modelo deve ou não ser habilitada para o serviço Web.

cmk_vault_base_url

str

valor padrão: None

URL base do cofre de chaves gerenciadas pelo cliente

cmk_key_name

str

valor padrão: None

O nome da chave gerenciada pelo cliente.

cmk_key_version

str

valor padrão: None

Versão da chave gerenciada pelo cliente.

vnet_name

str

valor padrão: None

O nome da rede virtual.

subnet_name

str

valor padrão: None

O nome da sub-rede na rede virtual.

Retornos

Um objeto de configuração a ser usado ao implantar um objeto do serviço Web.

Tipo de retorno

AciServiceDeploymentConfiguration

Exceções

WebserviceException

get_token

Recuperar 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

O token de autenticação para esse serviço Web e quando ele deverá ser atualizado depois.

Tipo de retorno

str, datetime

Exceções

azureml.exceptions.NotImplementedError

remove_tags

Remove as chaves especificadas do dicionário de marcas deste serviço Web.

remove_tags(tags)

Parâmetros

tags

list[str]

Obrigatório

A lista de chaves a serem removidas.

run

Chamar esse serviço Web com a entrada fornecida.

run(input_data)

Parâmetros

input_data

<xref:varies>

Obrigatório

A entrada com a qual chamar o serviço Web.

Retornos

O resultado da chamada ao serviço Web.

Tipo de retorno

dict

Exceções

WebserviceException

serialize

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

serialize()

Retornos

A representação JSON desse objeto de serviço Web.

Tipo de retorno

dict

update

Atualiza o serviço Web com as propriedades fornecidas.

Os valores deixados como None 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

image

Image

valor padrão: None

Uma nova imagem a ser implantada no serviço Web.

tags

dict[str, str]

valor padrão: None

Um dicionário de marcas de chave-valor a serem fornecidas a esse serviço Web. Substituirá as marcas existentes.

properties

dict[str, str]

valor padrão: None

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

description

str

valor padrão: None

Uma descrição a ser fornecida a esse serviço Web.

auth_enabled

bool

valor padrão: None

Habilita ou desabilita a autenticação para este serviço Web.

ssl_enabled

bool

valor padrão: None

Se o SSL deve ser habilitado ou não para esse serviço Web.

ssl_cert_pem_file

str

valor padrão: None

O arquivo de certificado necessário se o SSL estiver habilitado.

ssl_key_pem_file

str

valor padrão: None

O arquivo de chave necessário se o SSL estiver habilitado.

ssl_cname

str

valor padrão: None

O cname a ser usado se o SSL estiver habilitado.

enable_app_insights

bool

valor padrão: None

Se o AppInsights deve ser habilitado ou não para esse serviço Web.

models

list[Model]

valor padrão: None

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

inference_config

InferenceConfig

valor padrão: None

Um objeto InferenceConfig usado para fornecer as propriedades de implantação de modelo necessárias.

Tipo de retorno

None