Partilhar via

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'