Compartilhar via

LocalWebservice Classe

Representa um modelo de machine learning implantado como um ponto de extremidade de serviço Web local.

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

Construtor de webservice local.

O construtor LocalWebservice é usado para recuperar uma representação local de um objeto LocalWebservice associado ao workspace fornecido.

Construtor

LocalWebservice(*args, **kwargs)

Parâmetros

Nome Description
workspace
Obrigatório
Workspace

O objeto de workspace que contém todos os objetos Model que serão recuperados.
name
Obrigatório
str

O nome do objeto webservice a ser recuperado.
must_exist
Obrigatório
bool

Se o serviço Web já deve existir ao criar o objeto na memória.
workspace
Obrigatório
Workspace

O objeto de workspace que contém todos os objetos Model que serão recuperados.
name
Obrigatório
str

O nome do objeto LocalWebservice a ser recuperado.
must_exist
Obrigatório
bool

Se o serviço Web já deve existir ao criar o objeto na memória.

Comentários

Os exemplos de código a seguir mostram como criar um serviço Web local do Docker. 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 do computador local.

Essa 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 serviço Web local.
deploy_to_cloud

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

Converta um objeto JSON de resposta do Serviço de Gerenciamento de Modelos em um objeto webservice.

Observação

Não há suporte para o LocalWebservice.
get_keys

Recupere chaves de autenticação para este serviço Web.

Observação

Não há suporte para o LocalWebservice.
get_logs

Recupere logs para este LocalWebservice.
get_token

Recupere o token de autenticação para esse serviço Web, com escopo para o usuário atual.

Observação

Não há suporte para o LocalWebservice.
list

Liste os Serviços locais associados ao Workspace correspondente.

Os resultados retornados podem ser filtrados usando parâmetros.
regen_key

Regenerar uma das chaves do serviço Web.

Observação

Não há suporte para o 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 as dependências locais, mas não recria a imagem subjacente. Assim, as alterações nas dependências conda/pip ou etapas personalizadas do Docker não serão refletidas no LocalWebservice recarregado. Em vez disso, para lidar com essas alterações, chame o update método.
run

Chame esse LocalWebservice com a entrada fornecida.
serialize

Converta esse 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 do Docker local correspondente.
wait_for_deployment

Sondar a implantação do LocalWebservice em execução.

delete

Exclua este LocalWebservice do computador local.

Essa 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

Nome Description
delete_cache
Obrigatório
bool

Se os arquivos temporários serão excluídos armazenados em cache para o serviço. (Padrão: True)
delete_image
Obrigatório
bool

Se deseja excluir a imagem do Docker do serviço. (Padrão: False)
delete_volume
Obrigatório
bool

Se deseja excluir o volume do Docker do serviço. (Padrão: True)

Exceções

Tipo Description
WebserviceException

deploy_configuration

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

static deploy_configuration(port=None)

Parâmetros

Nome Description
port
int

A porta local na qual expor o ponto de extremidade HTTP do serviço.

Valor padrão: None

Retornos

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 serviço Web com base na configuração do LocalWebservice.

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

Parâmetros

Nome Description
name
str

O nome para fornecer o serviço implantado. Deve ser exclusivo para o workspace.

Valor padrão: None
deployment_config
WebserviceDeploymentConfiguration

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

Valor padrão: None
deployment_target
ComputeTarget

Um ComputeTarget para o qual implantar o serviço Web. Como a ACI não tem nenhum associado ComputeTarget, deixe esse parâmetro como Nenhum para implantar na ACI.

Valor padrão: None

Retornos

Tipo Description
Webservice

Um objeto webservice correspondente ao serviço Web implantado.

Exceções

Tipo Description
WebserviceException

deserialize

Converta um objeto JSON de resposta do Serviço de Gerenciamento de Modelos em um objeto webservice.

Observação

Não há suporte para o LocalWebservice.

deserialize(workspace, webservice_payload)

Parâmetros

Nome Description
cls
Obrigatório
workspace
Obrigatório
Workspace

O objeto de workspace no qual o serviço Web está registrado.
webservice_payload
Obrigatório
dict

Um objeto JSON a ser convertido em um objeto webservice.

Exceções

Tipo Description
azureml.exceptions.NotImplementedError

get_keys

Recupere chaves de autenticação para este serviço Web.

Observação

Não há suporte para o LocalWebservice.

get_keys()

Retornos

Tipo Description

As chaves de autenticação para este serviço Web.

Exceções

Tipo Description
azureml.exceptions.NotImplementedError

get_logs

Recupere logs para este LocalWebservice.

get_logs(num_lines=5000, raw=False)

Parâmetros

Nome Description
num_lines
Obrigatório
int

O número máximo de linhas de log a serem recuperadas. (Padrão: 5000)
raw
Obrigatório
bool

Retorne a saída bruta do contêiner do Docker sem tentar formatá-la. (Padrão: False)

Retornos

Tipo Description
str

Os logs deste LocalWebservice.

Exceções

Tipo Description
WebserviceException

get_token

Recupere o token de autenticação para esse serviço Web, com escopo para o usuário atual.

Observação

Não há suporte para o LocalWebservice.

get_token()

Retornos

Tipo Description
str, datetime

O token de autenticação para esse webservice e quando ele deve ser atualizado depois.

Exceções

Tipo Description
azureml.exceptions.NotImplementedError

list

Liste os Serviços locais associados ao Workspace correspondente.

Os resultados retornados podem ser filtrados usando parâmetros.

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

Parâmetros

Nome Description
workspace
Obrigatório
Workspace

O objeto Workspace associado ao LocalWebservices.
model_name
str

Filtrar lista para incluir apenas LocalWebservices implantados com o nome do modelo específico.

Valor padrão: None
model_id
str

Filtrar lista para incluir apenas LocalWebservices implantados com a ID de modelo específica.

Valor padrão: None
all
bool

Mostrar todos os serviços. Somente os serviços em execução são mostrados por padrão.

Valor padrão: None

Retornos

Tipo Description
list[LocalWebservice]

Uma lista filtrada de LocalWebservices associada ao Workspace fornecido.

Exceções

Tipo Description
WebserviceException

regen_key

Regenerar uma das chaves do serviço Web.

Observação

Não há suporte para o LocalWebservice.

regen_key(key)

Parâmetros

Nome Description
key
Obrigatório
str

Qual chave regenerar. As opções são 'Primário' ou 'Secundário'

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 as dependências locais, mas não recria a imagem subjacente. Assim, as alterações nas dependências conda/pip ou etapas personalizadas do Docker não serão refletidas no LocalWebservice recarregado. Em vez disso, para lidar com essas alterações, chame o update método.

reload(wait=False)

Parâmetros

Nome Description
wait
Obrigató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 esse LocalWebservice com a entrada fornecida.

run(input_data)

Parâmetros

Nome Description
input_data
Obrigatório
<xref:varies>

A entrada com a qual chamar o LocalWebservice.

Retornos

Tipo Description
<xref:varies>

O resultado de chamar o LocalWebservice.

Exceções

Tipo Description
WebserviceException

serialize

Converta esse objeto webservice em um dicionário serializado por JSON.

serialize()

Retornos

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

Nome Description
models
Obrigatório
list[Model]

Uma nova lista de modelos contidos no LocalWebservice.
image_config
Obrigatório
ContainerImageConfig

Opções de configuração de imagem a serem aplicadas ao LocalWebservice.
deployment_config
Obrigatório
LocalWebserviceDeploymentConfiguration

Opções de configuração de implantação a serem aplicadas ao LocalWebservice.
inference_config
Obrigatório
InferenceConfig

Um objeto InferenceConfig usado para fornecer as propriedades de implantação de modelo necessárias.
wait
Obrigatório
bool

Aguarde até que o contêiner do serviço atinja um estado íntegro. (Padrão: False)

Retornos

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 do Docker local correspondente.

update_deployment_state(must_exist=False)

Parâmetros

Nome Description
must_exist
bool

Se o serviço Web já deve existir ao criar o objeto na memória.

Valor padrão: False

wait_for_deployment

Sondar a implantação do LocalWebservice em execução.

wait_for_deployment(show_output=False)

Parâmetros

Nome Description
show_output
Obrigató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.

Retornos

Tipo Description
int

Número da porta.

scoring_uri

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

Retornos

Tipo Description
str

URI de pontuação.

swagger_uri

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

Retornos

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'