LocalWebservice Classe
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
-
LocalWebservice
Construtor
LocalWebservice(*args, **kwargs)
Parâmetros
- workspace
- Workspace
O objeto da área de trabalho que contém quaisquer objetos de Modelo que serão obtidos.
- workspace
- Workspace
O objeto da área de trabalho que contém quaisquer objetos de Modelo que serão obtidos.
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 webservice 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 através de 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 recria a imagem subjacente. Assim, 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 processar 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
- delete_cache
- bool
Se pretende eliminar ficheiros temporários em cache para o serviço. (Predefinição: Verdadeiro)
- delete_image
- bool
Se pretende eliminar a imagem do Docker do serviço. (Predefinição: Falso)
- delete_volume
- bool
Se pretende eliminar o volume do Docker do serviço. (Predefinição: Verdadeiro)
Exceções
deploy_configuration
Crie um objeto de configuração para implementar um Webservice local.
static deploy_configuration(port=None)
Parâmetros
Devoluções
Um objeto de configuração a utilizar ao implementar um objeto webservice.
Tipo de retorno
Exceções
deploy_to_cloud
Implemente um webservice com base na configuração do LocalWebservice.
deploy_to_cloud(name=None, deployment_config=None, deployment_target=None)
Parâmetros
- name
- str
O nome a atribuir ao serviço implementado. Tem de ser exclusivo da área de trabalho.
- deployment_config
- WebserviceDeploymentConfiguration
Um WebserviceDeploymentConfiguration utilizado para configurar o webservice. Se não for fornecido um, será utilizado um objeto de configuração vazio com base no destino pretendido.
- deployment_target
- ComputeTarget
Um ComputeTarget para o qual implementar o Webservice. Como o ACI não tem nenhum ComputeTargetassociado, deixe este parâmetro como Nenhum para implementar no ACI.
Devoluções
Um objeto webservice correspondente ao webservice implementado.
Tipo de retorno
Exceções
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
- cls
Exceções
get_keys
Obtenha chaves de autenticação para este webservice.
Nota
Não suportado para LocalWebservice.
get_keys()
Devoluções
As chaves de autenticação para este webservice.
Exceções
get_logs
Obtenha registos para este LocalWebservice.
get_logs(num_lines=5000, raw=False)
Parâmetros
- raw
- bool
Devolva a saída de contentor do Docker não processada sem tentar formatá-la. (Predefinição: Falso)
Devoluções
Os registos deste LocalWebservice.
Tipo de retorno
Exceções
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
O token de autenticação para este webservice e quando deve ser atualizado depois.
Tipo de retorno
Exceções
list
Liste os Serviços Web Locais associados à Área de Trabalho correspondente.
Os resultados devolvidos podem ser filtrados através de parâmetros.
static list(workspace, model_name=None, model_id=None, all=None)
Parâmetros
- model_name
- str
Filtre a lista para incluir apenas LocalWebservices implementados com o nome de modelo específico.
- model_id
- str
Filtre a lista para incluir apenas LocalWebservices implementados com o ID de modelo específico.
- all
- bool
Mostrar todos os serviços. Apenas os serviços em execução são apresentados por predefinição.
Devoluções
Uma lista filtrada de LocalWebservices associados à Área de Trabalho fornecida.
Tipo de retorno
Exceções
regen_key
Regenerar uma das chaves do Webservice.
Nota
Não suportado para LocalWebservice.
regen_key(key)
Parâmetros
Exceções
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 recria a imagem subjacente. Assim, 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 processar essas alterações, chame o update método .
reload(wait=False)
Parâmetros
- wait
- bool
Aguarde que o contentor do serviço atinja um bom estado de funcionamento. (Predefinição: Falso)
Exceções
run
Chame este LocalWebservice com a entrada fornecida.
run(input_data)
Parâmetros
- input_data
- <xref:varies>
A entrada com a qual chamar o LocalWebservice.
Devoluções
O resultado da chamada localWebservice.
Tipo de retorno
Exceções
serialize
Converta este objeto Webservice num dicionário serializado JSON.
serialize()
Devoluções
Representação serializada do objeto Webservice.
Tipo de retorno
Exceções
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
- image_config
- ContainerImageConfig
Opções de configuração de imagens a aplicar ao LocalWebservice.
- deployment_config
- LocalWebserviceDeploymentConfiguration
Opções de configuração de implementação a aplicar ao LocalWebservice.
- inference_config
- InferenceConfig
Um objeto InferenceConfig utilizado para fornecer as propriedades de implementação do modelo necessárias.
- wait
- bool
Aguarde que o contentor do serviço atinja um bom estado de funcionamento. (Predefinição: Falso)
Tipo de retorno
Exceções
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
- must_exist
- bool
Se o webservice já tem de existir ao criar o objeto dentro da memória.
Exceções
wait_for_deployment
Consulte a implementação LocalWebservice em execução.
wait_for_deployment(show_output=False)
Parâmetros
Exceções
Atributos
port
scoring_uri
Obtenha o URI de classificação de webservice local.
Devoluções
URI de classificação.
Tipo de retorno
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'
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários