Partilhar via

LocalWebservice Classe

  • Referência

Representa um modelo de machine learning implementado como um ponto final de serviço Web local.

Implementar serviços Web localmente é útil para cenários de depuração e teste.

Construtor webservice local.

O construtor LocalWebservice é utilizado para obter uma representação local de um objeto LocalWebservice associado à área de trabalho fornecida.

Herança
Webservice
LocalWebservice

Construtor

LocalWebservice(*args, **kwargs)

Parâmetros

Name Description
workspace
Necessário
Workspace

O objeto da área de trabalho que contém quaisquer objetos de Modelo que serão obtidos.
name
Necessário
str

O nome do objeto Webservice a obter.
must_exist
Necessário
bool

Se o serviço Web já tem de existir ao criar o objeto dentro da memória.
workspace
Necessário
Workspace

O objeto da área de trabalho que contém quaisquer objetos de Modelo que serão obtidos.
name
Necessário
str

O nome do objeto LocalWebservice a obter.
must_exist
Necessário
bool

Se o serviço Web já tem de existir ao criar o objeto dentro da memória.

Observações

Os exemplos de código seguintes mostram como criar um serviço Web local do Docker. Consulte a ligação do bloco de notas para obter mais detalhes.


   from azureml.core.webservice import LocalWebservice

   # This is optional, if not provided Docker will choose a random unused port.
   deployment_config = LocalWebservice.deploy_configuration(port=6789)

   local_service = Model.deploy(ws, "test", [model], inference_config, deployment_config)

   local_service.wait_for_deployment()

O exemplo completo está disponível a partir de https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/deployment/deploy-to-local/register-model-deploy-local.ipynb

Métodos

delete

Elimine este LocalWebservice do computador local.

Esta chamada de função não é assíncrona; é executado até que o serviço seja eliminado.
deploy_configuration

Crie um objeto de configuração para implementar um Webservice local.
deploy_to_cloud

Implemente um serviço Web com base na configuração do LocalWebservice.
deserialize

Converter um objeto JSON de resposta do Serviço de Gestão de Modelos num objeto webservice.

Nota

Não suportado para LocalWebservice.
get_keys

Obtenha chaves de autenticação para este Webservice.

Nota

Não suportado para LocalWebservice.
get_logs

Obtenha registos para este LocalWebservice.
get_token

Obtenha o token de autenticação para este Webservice, no âmbito do utilizador atual.

Nota

Não suportado para LocalWebservice.
list

Liste os Serviços Web Locais associados à Área de Trabalho correspondente.

Os resultados devolvidos podem ser filtrados com parâmetros.
regen_key

Regenerar uma das chaves do Webservice.

Nota

Não suportado para LocalWebservice.
reload

Recarregue o script de execução e as dependências do LocalWebservice.

Esta ação reinicia o contentor do serviço com cópias de recursos atualizados, incluindo o script de execução e as dependências locais, mas não recompila a imagem subjacente. Por conseguinte, as alterações às dependências conda/pip ou aos passos personalizados do Docker não serão refletidas no LocalWebservice recarregado. Em alternativa, para lidar com essas alterações, chame o update método.
run

Chame este LocalWebservice com a entrada fornecida.
serialize

Converta este objeto Webservice num dicionário serializado JSON.
update

Atualize o LocalWebservice com as propriedades fornecidas.

Os valores deixados como Nenhum permanecerão inalterados neste LocalWebservice.
update_deployment_state

Atualize o estado atual do objeto dentro da memória.

Efetue uma atualização no local das propriedades do objeto com base no estado atual do contentor do Docker local correspondente.
wait_for_deployment

Consulte a implementação LocalWebservice em execução.

delete

Elimine este LocalWebservice do computador local.

Esta chamada de função não é assíncrona; é executado até que o serviço seja eliminado.

delete(delete_cache=True, delete_image=False, delete_volume=True)

Parâmetros

Name Description
delete_cache
Necessário
bool

Se pretende eliminar ficheiros temporários em cache para o serviço. (Predefinição: Verdadeiro)
delete_image
Necessário
bool

Se pretende eliminar a imagem do Docker do serviço. (Predefinição: Falso)
delete_volume
Necessário
bool

Se pretende eliminar o volume do Docker do serviço. (Predefinição: Verdadeiro)

Exceções

Tipo Description
WebserviceException

deploy_configuration

Crie um objeto de configuração para implementar um Webservice local.

static deploy_configuration(port=None)

Parâmetros

Name Description
port
int

A porta local na qual pretende expor o ponto final HTTP do serviço.

Default value: None

Devoluções

Tipo Description
LocalWebserviceDeploymentConfiguration

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

Exceções

Tipo Description
WebserviceException

deploy_to_cloud

Implemente um serviço Web com base na configuração do LocalWebservice.

deploy_to_cloud(name=None, deployment_config=None, deployment_target=None)

Parâmetros

Name Description
name
str

O nome a atribuir ao serviço implementado. Tem de ser exclusivo da área de trabalho.

Default value: None
deployment_config
WebserviceDeploymentConfiguration

Um WebserviceDeploymentConfiguration utilizado para configurar o serviço Web. Se não for fornecido um, será utilizado um objeto de configuração vazio com base no destino pretendido.

Default value: None
deployment_target
ComputeTarget

Um ComputeTarget para o qual implementar o Serviço Web. Como o ACI não tem nenhum ComputeTarget, deixe este parâmetro como Nenhum para implementar no ACI.

Default value: None

Devoluções

Tipo Description
Webservice

Um objeto webservice correspondente ao webservice implementado.

Exceções

Tipo Description
WebserviceException

deserialize

Converter um objeto JSON de resposta do Serviço de Gestão de Modelos num objeto webservice.

Nota

Não suportado para LocalWebservice.

deserialize(workspace, webservice_payload)

Parâmetros

Name Description
cls
Necessário
workspace
Necessário
Workspace

O objeto da área de trabalho em que o Webservice está registado.
webservice_payload
Necessário
dict

Um objeto JSON para converter num objeto Webservice.

Exceções

Tipo Description
azureml.exceptions.NotImplementedError

get_keys

Obtenha chaves de autenticação para este Webservice.

Nota

Não suportado para LocalWebservice.

get_keys()

Devoluções

Tipo Description

As chaves de autenticação deste webservice.

Exceções

Tipo Description
azureml.exceptions.NotImplementedError

get_logs

Obtenha registos para este LocalWebservice.

get_logs(num_lines=5000, raw=False)

Parâmetros

Name Description
num_lines
Necessário
int

O número máximo de linhas de registo a obter. (Predefinição: 5000)
raw
Necessário
bool

Devolva a saída de contentor do Docker não processada sem tentar formatá-la. (Predefinição: Falso)

Devoluções

Tipo Description
str

Os registos deste LocalWebservice.

Exceções

Tipo Description
WebserviceException

get_token

Obtenha o token de autenticação para este Webservice, no âmbito do utilizador atual.

Nota

Não suportado para LocalWebservice.

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

list

Liste os Serviços Web Locais associados à Área de Trabalho correspondente.

Os resultados devolvidos podem ser filtrados com parâmetros.

static list(workspace, model_name=None, model_id=None, all=None)

Parâmetros

Name Description
workspace
Necessário
Workspace

O objeto Área de Trabalho associado aos Serviços Web Locais.
model_name
str

Filtrar lista para incluir apenas LocalWebservices implementados com o nome de modelo específico.

Default value: None
model_id
str

Filtrar lista para incluir apenas LocalWebservices implementados com o ID de modelo específico.

Default value: None
all
bool

Mostrar todos os serviços. Apenas os serviços em execução são apresentados por predefinição.

Default value: None

Devoluções

Tipo Description
list[LocalWebservice]

Uma lista filtrada de LocalWebservices associados à Área de Trabalho fornecida.

Exceções

Tipo Description
WebserviceException

regen_key

Regenerar uma das chaves do Webservice.

Nota

Não suportado para LocalWebservice.

regen_key(key)

Parâmetros

Name Description
key
Necessário
str

Que chave para regenerar. As opções são "Principal" ou "Secundário"

Exceções

Tipo Description
NotImplementedError

reload

Recarregue o script de execução e as dependências do LocalWebservice.

Esta ação reinicia o contentor do serviço com cópias de recursos atualizados, incluindo o script de execução e as dependências locais, mas não recompila a imagem subjacente. Por conseguinte, as alterações às dependências conda/pip ou aos passos personalizados do Docker não serão refletidas no LocalWebservice recarregado. Em alternativa, para lidar com essas alterações, chame o update método.

reload(wait=False)

Parâmetros

Name Description
wait
Necessário
bool

Aguarde que o contentor do serviço atinja um bom estado de funcionamento. (Predefinição: Falso)

Exceções

Tipo Description
WebserviceException

run

Chame este LocalWebservice com a entrada fornecida.

run(input_data)

Parâmetros

Name Description
input_data
Necessário
<xref:varies>

A entrada com a qual chamar o LocalWebservice.

Devoluções

Tipo Description
<xref:varies>

O resultado da chamada localWebservice.

Exceções

Tipo Description
WebserviceException

serialize

Converta este objeto Webservice num dicionário serializado JSON.

serialize()

Devoluções

Tipo Description
dict

Representação serializada do objeto Webservice.

Exceções

Tipo Description
WebserviceException

update

Atualize o LocalWebservice com as propriedades fornecidas.

Os valores deixados como Nenhum permanecerão inalterados neste LocalWebservice.

update(models=None, image_config=None, deployment_config=None, wait=False, inference_config=None)

Parâmetros

Name Description
models
Necessário
list[Model]

Uma nova lista de modelos contidos no LocalWebservice.
image_config
Necessário
ContainerImageConfig

Opções de configuração de imagens a aplicar ao LocalWebservice.
deployment_config
Necessário
LocalWebserviceDeploymentConfiguration

Opções de configuração de implementação a aplicar ao LocalWebservice.
inference_config
Necessário
InferenceConfig

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

Aguarde que o contentor do serviço atinja um bom estado de funcionamento. (Predefinição: Falso)

Devoluções

Tipo Description
None

Exceções

Tipo Description
WebserviceException

update_deployment_state

Atualize o estado atual do objeto dentro da memória.

Efetue uma atualização no local das propriedades do objeto com base no estado atual do contentor do Docker local correspondente.

update_deployment_state(must_exist=False)

Parâmetros

Name Description
must_exist
bool

Se o webservice já tem de existir ao criar o objeto dentro da memória.

Default value: False

Exceções

Tipo Description
WebserviceException

wait_for_deployment

Consulte a implementação LocalWebservice em execução.

wait_for_deployment(show_output=False)

Parâmetros

Name Description
show_output
Necessário
bool

Opção para imprimir uma saída mais verbosa. (Predefinição: Falso)

Exceções

Tipo Description
WebserviceException

Atributos

port

Obtenha a porta de webservice local.

Devoluções

Tipo Description
int

Número da porta.

scoring_uri

Obtenha o URI de classificação de webservice local.

Devoluções

Tipo Description
str

URI de Classificação.

swagger_uri

Obtenha o URI swagger do serviço Web local.

Devoluções

Tipo Description
str

Swagger URI.

NETWORK_NAME 

NETWORK_NAME = 'azureml-local'

STATE_DELETED 

STATE_DELETED = 'deleted'

STATE_DEPLOYING 

STATE_DEPLOYING = 'deploying'

STATE_FAILED 

STATE_FAILED = 'failed'

STATE_RUNNING 

STATE_RUNNING = 'running'

STATE_UNKNOWN 

STATE_UNKNOWN = 'unknown'