LocalWebservice Classe

Representa um modelo de aprendizado de máquina implantado como um ponto de extremidade de serviço Web local.

A implantação de serviços Web localmente é útil para depurar e testar cenários.

Construtor de serviço Web local.

LocalWebservice construtor é usado para recuperar uma representação local de um objeto LocalWebservice associado com o espaço de trabalho fornecido.

Construtor

LocalWebservice(*args, **kwargs)

Parâmetros

Name	Description
workspace Necessário	Workspace O objeto de espaço de trabalho que contém quaisquer objetos Model que serão recuperados.
name Necessário	str O nome do objeto Webservice a ser recuperado.
must_exist Necessário	bool Se o serviço Web já deve existir ao criar o objeto na memória.
workspace Necessário	Workspace O objeto de espaço de trabalho que contém quaisquer objetos Model que serão recuperados.
name Necessário	str O nome do objeto LocalWebservice a ser recuperado.
must_exist Necessário	bool Se o serviço Web já deve existir ao criar o objeto na memória.

Observações

Os exemplos de código a seguir mostram como criar um serviço Web Docker local. Consulte o link do bloco de anotações 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()

Métodos

delete	Exclua este LocalWebservice da máquina local. Esta chamada de função não é assíncrona; ele é executado até que o serviço seja excluído.
deploy_configuration	Crie um objeto de configuração para implantar um WebService local.
deploy_to_cloud	Implante um Webservice com base na configuração do LocalWebservice.
deserialize	Converter um objeto JSON de resposta do Serviço de Gerenciamento de Modelo em um objeto Webservice. Observação Não suportado para LocalWebservice.
get_keys	Recupere chaves de autenticação para este WebService. Observação Não suportado para LocalWebservice.
get_logs	Recupere logs para este LocalWebservice.
get_token	Recupere o token de autenticação para este WebService, com escopo para o usuário atual. Observação Não suportado para LocalWebservice.
list	Liste os LocalWebservices associados ao espaço de trabalho correspondente. Os resultados retornados podem ser filtrados usando parâmetros.
regen_key	Regenere uma das chaves do WebService. Observação Não suportado para LocalWebservice.
reload	Recarregue o script de execução e as dependências do LocalWebservice. Isso reinicia o contêiner do serviço com cópias de ativos atualizados, incluindo o script de execução e dependências locais, mas não reconstrói a imagem subjacente. Consequentemente, as alterações nas dependências Conda/pip ou nas etapas personalizadas do Docker não serão refletidas no LocalWebservice recarregado. Para lidar com essas alterações, chame o update método em vez disso.
run	Chame este LocalWebservice com a entrada fornecida.
serialize	Converta este objeto Webservice em um dicionário serializado por 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 na memória. Execute uma atualização in-loco das propriedades do objeto com base no estado atual do contêiner Docker local correspondente.
wait_for_deployment	Sonde a implantação do LocalWebservice em execução.

delete

Exclua este LocalWebservice da máquina local.

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

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

Parâmetros

Name	Description
delete_cache Necessário	bool Se deseja excluir arquivos temporários armazenados em cache para o serviço. (Padrão: True)
delete_image Necessário	bool Se a imagem do Docker do serviço deve ser excluída. (Padrão: False)
delete_volume Necessário	bool Se o volume do Docker do serviço deve ser excluído. (Padrão: True)

Exceções

Tipo	Description
WebserviceException

deploy_configuration

Crie um objeto de configuração para implantar um WebService local.

static deploy_configuration(port=None)

Parâmetros

Name	Description
port	int A porta local na qual expor o ponto de extremidade HTTP do serviço. Default value: None

Devoluções

Tipo	Description
LocalWebserviceDeploymentConfiguration	Um objeto de configuração a ser usado ao implantar um objeto Webservice.

Exceções

Tipo	Description
WebserviceException

deploy_to_cloud

Implante um Webservice 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 ser dado ao serviço implantado. Deve ser exclusivo para o espaço de trabalho. Default value: None
deployment_config	WebserviceDeploymentConfiguration Um WebserviceDeploymentConfiguration usado para configurar o webservice. Se um não for fornecido, um objeto de configuração vazio será usado com base no destino desejado. Default value: None
deployment_target	ComputeTarget A ComputeTarget para o qual implantar o WebService. Como o ACI não tem nenhum associado ComputeTarget, deixe este parâmetro como Nenhum para implantar no ACI. Default value: None

Devoluções

Tipo	Description
Webservice	Um objeto Webservice correspondente ao webservice implantado.

Exceções

Tipo	Description
WebserviceException

deserialize

Converter um objeto JSON de resposta do Serviço de Gerenciamento de Modelo em um objeto Webservice.

Observação

Não suportado para LocalWebservice.

deserialize(workspace, webservice_payload)

Parâmetros

Name	Description
cls Necessário
workspace Necessário	Workspace O objeto de espaço de trabalho no qual o Webservice está registrado.
webservice_payload Necessário	dict Um objeto JSON para converter em um objeto Webservice.

Exceções

Tipo	Description
azureml.exceptions.NotImplementedError

get_keys

Recupere chaves de autenticação para este WebService.

Observação

Não suportado para LocalWebservice.

get_keys()

Devoluções

Tipo	Description
	As chaves de autenticação para este WebService.

Exceções

Tipo	Description
azureml.exceptions.NotImplementedError

get_logs

Recupere logs 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 log a serem recuperadas. (Padrão: 5000)
raw Necessário	bool Retorne a saída bruta do contêiner do Docker sem tentar formatá-la. (Padrão: False)

Devoluções

Tipo	Description
str	Os logs para este LocalWebservice.

Exceções

Tipo	Description
WebserviceException

get_token

Recupere o token de autenticação para este WebService, com escopo para o usuário atual.

Observação

Não suportado para LocalWebservice.

get_token()

Devoluções

Tipo	Description
str, datetime	O token de autenticação para este Webservice e quando ele deve ser atualizado depois.

Exceções

Tipo	Description
azureml.exceptions.NotImplementedError

list

Liste os LocalWebservices associados ao espaço de trabalho correspondente.

Os resultados retornados podem ser filtrados usando parâmetros.

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

Parâmetros

Name	Description
workspace Necessário	Workspace O objeto Workspace associado ao LocalWebservices.
model_name	str Lista de filtros para incluir apenas LocalWebservices implantados com o nome do modelo específico. Default value: None
model_id	str Lista de filtros para incluir apenas LocalWebservices implantados 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 mostrados por padrão. Default value: None

Devoluções

Tipo	Description
list[LocalWebservice]	Uma lista filtrada de LocalWebservices associados ao espaço de trabalho fornecido.

Exceções

Tipo	Description
WebserviceException

regen_key

Regenere uma das chaves do WebService.

Observação

Não suportado para LocalWebservice.

regen_key(key)

Parâmetros

Name	Description
key Necessário	str Qual a chave para regenerar. As opções são 'Primária' ou 'Secundária'

Exceções

Tipo	Description
NotImplementedError

reload

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

Isso reinicia o contêiner do serviço com cópias de ativos atualizados, incluindo o script de execução e dependências locais, mas não reconstrói a imagem subjacente. Consequentemente, as alterações nas dependências Conda/pip ou nas etapas personalizadas do Docker não serão refletidas no LocalWebservice recarregado. Para lidar com essas alterações, chame o update método em vez disso.

reload(wait=False)

Parâmetros

Name	Description
wait Necessário	bool Aguarde até que o contêiner do serviço atinja um estado íntegro. (Padrão: False)

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 de chamar o LocalWebservice.

Exceções

Tipo	Description
WebserviceException

serialize

Converta este objeto Webservice em um dicionário serializado por JSON.

serialize()

Devoluções

Tipo	Description
dict	Representação serializada do objeto Webservice.

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 imagem a serem aplicadas ao LocalWebservice.
deployment_config Necessário	LocalWebserviceDeploymentConfiguration Opções de configuração de implantação a serem aplicadas ao LocalWebservice.
inference_config Necessário	InferenceConfig Um objeto InferenceConfig usado para fornecer as propriedades de implantação de modelo necessárias.
wait Necessário	bool Aguarde até que o contêiner do serviço atinja um estado íntegro. (Padrão: False)

Devoluções

Tipo	Description
None

Exceções

Tipo	Description
WebserviceException

update_deployment_state

Atualize o estado atual do objeto na memória.

Execute uma atualização in-loco das propriedades do objeto com base no estado atual do contêiner Docker local correspondente.

update_deployment_state(must_exist=False)

Parâmetros

Name	Description
must_exist	bool Se o serviço Web já deve existir ao criar o objeto na memória. Default value: False

wait_for_deployment

Sonde a implantação do 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 detalhada. (Padrão: False)

Exceções

Tipo	Description
WebserviceException

Atributos

port

Obtenha a porta de serviço Web local.

Devoluções

Tipo	Description
int	Número da porta.

scoring_uri

Obtenha o URI de pontuação do serviço Web local.

Devoluções

Tipo	Description
str	Pontuação URI.

swagger_uri

Obtenha o URI do Swagger do serviço Web local.

Devoluções

Tipo	Description
str	URI do Swagger.

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'