az ml service
Nota
Essa referência faz parte da extensão azure-cli-ml para a CLI do Azure (versão 2.0.28 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az ml service . Saiba mais sobre extensões.
Gerir serviços operacionalizados.
Comandos
Name | Description | Tipo | Estado |
---|---|---|---|
az ml service delete |
Exclua um serviço do espaço de trabalho. |
Extensão | GA |
az ml service get-access-token |
Obtenha um token para emitir solicitações de um serviço. |
Extensão | GA |
az ml service get-keys |
Obtenha chaves para emitir solicitações em relação a um serviço. |
Extensão | GA |
az ml service get-logs |
Obter logs para um serviço. |
Extensão | GA |
az ml service list |
Listar serviços no espaço de trabalho. |
Extensão | GA |
az ml service regen-key |
Regenere chaves para um serviço. |
Extensão | GA |
az ml service run |
Execute um serviço no espaço de trabalho. |
Extensão | GA |
az ml service show |
Mostrar detalhes de um serviço no espaço de trabalho. |
Extensão | GA |
az ml service update |
Atualize um serviço no espaço de trabalho. |
Extensão | GA |
az ml service delete
Exclua um serviço do espaço de trabalho.
az ml service delete --name
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[-v]
Parâmetros Obrigatórios
O nome do serviço a ser excluído.
Parâmetros Opcionais
Caminho para uma pasta de projeto. Padrão: diretório atual.
Grupo de recursos correspondente ao espaço de trabalho fornecido.
Especifica a ID da assinatura.
Nome do espaço de trabalho que contém o serviço a ser excluído.
Bandeira de verbosidade.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az ml service get-access-token
Obtenha um token para emitir solicitações de um serviço.
az ml service get-access-token --name
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[-v]
Parâmetros Obrigatórios
Nome do serviço.
Parâmetros Opcionais
Caminho para uma pasta de projeto. Padrão: diretório atual.
Grupo de recursos correspondente ao espaço de trabalho fornecido.
Especifica a ID da assinatura.
Nome do espaço de trabalho que contém o serviço a ser exibido.
Bandeira de verbosidade.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az ml service get-keys
Obtenha chaves para emitir solicitações em relação a um serviço.
az ml service get-keys --name
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[-v]
Parâmetros Obrigatórios
Nome do serviço.
Parâmetros Opcionais
Caminho para uma pasta de projeto. Padrão: diretório atual.
Grupo de recursos correspondente ao espaço de trabalho fornecido.
Especifica a ID da assinatura.
Nome do espaço de trabalho que contém o serviço a ser exibido.
Bandeira de verbosidade.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az ml service get-logs
Obter logs para um serviço.
az ml service get-logs --name
[--init]
[--num_lines]
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[-v]
Parâmetros Obrigatórios
Nome do serviço.
Parâmetros Opcionais
Obtenha logs do contêiner init em vez do contêiner de pontuação.
Número de linhas de log a serem retornadas da cauda (o padrão é 5000).
Caminho para uma pasta de projeto. Padrão: diretório atual.
Grupo de recursos correspondente ao espaço de trabalho fornecido.
Especifica a ID da assinatura.
Nome do espaço de trabalho que contém o serviço a ser exibido.
Bandeira de verbosidade.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az ml service list
Listar serviços no espaço de trabalho.
az ml service list [--compute-type]
[--image-digest]
[--model-id]
[--model-name]
[--path]
[--property]
[--resource-group]
[--subscription-id]
[--tag]
[--workspace-name]
[-v]
Parâmetros Opcionais
Se fornecido, mostrará apenas os serviços que têm o tipo de computação especificado. (As opções são 'ACI', 'AKS').
Se fornecido, mostrará apenas os serviços que têm o resumo de imagem especificado.
Se fornecido, mostrará apenas os serviços que têm a ID do modelo especificado.
Se fornecido, mostrará apenas os serviços que têm o nome do modelo especificado.
Caminho para uma pasta de projeto. Padrão: diretório atual.
Se fornecido, filtrará com base na chave/valor fornecido (e.g. key ou key=value). Várias propriedades podem ser especificadas com várias opções --property.
Grupo de recursos correspondente ao espaço de trabalho fornecido.
Especifica a ID da assinatura.
Se fornecido, filtrará com base na chave/valor fornecido (e.g. key ou key=value). Várias tags podem ser especificadas com várias opções --tag.
Nome do espaço de trabalho que contém os serviços a serem listados.
Bandeira de verbosidade.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az ml service regen-key
Regenere chaves para um serviço.
az ml service regen-key --key
--name
[--path]
[--resource-group]
[--set-key]
[--subscription-id]
[--workspace-name]
[-v]
Parâmetros Obrigatórios
Qual chave regenerar, se regen for especificado. Opções: Primária, Secundária.
Nome do serviço.
Parâmetros Opcionais
Caminho para uma pasta de projeto. Padrão: diretório atual.
Grupo de recursos correspondente ao espaço de trabalho fornecido.
Forneça o valor de autenticação para a chave especificada.
Especifica a ID da assinatura.
Nome do espaço de trabalho que contém o serviço a ser exibido.
Bandeira de verbosidade.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az ml service run
Execute um serviço no espaço de trabalho.
az ml service run --name
[--input-data]
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[-v]
Parâmetros Obrigatórios
O nome do serviço para pontuar contra.
Parâmetros Opcionais
Os dados a serem usados para chamar o serviço Web.
Caminho para uma pasta de projeto. Padrão: diretório atual.
Grupo de recursos correspondente ao espaço de trabalho fornecido.
Especifica a ID da assinatura.
Nome do espaço de trabalho que contém o serviço a ser executado.
Bandeira de verbosidade.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az ml service show
Mostrar detalhes de um serviço no espaço de trabalho.
az ml service show --name
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[-v]
Parâmetros Obrigatórios
Nome do serviço Web a ser exibido.
Parâmetros Opcionais
Caminho para uma pasta de projeto. Padrão: diretório atual.
Grupo de recursos correspondente ao espaço de trabalho fornecido.
Especifica a ID da assinatura.
Nome do espaço de trabalho que contém o serviço a ser exibido.
Bandeira de verbosidade.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az ml service update
Atualize um serviço no espaço de trabalho.
az ml service update --name
[--add-property]
[--add-tag]
[--ae]
[--ai]
[--ar]
[--as]
[--at]
[--autoscale-max-replicas]
[--autoscale-min-replicas]
[--base-image]
[--base-image-registry]
[--cc]
[--ccl]
[--cf]
[--collect-model-data]
[--compute-target]
[--cuda-version]
[--dc]
[--description]
[--dn]
[--ds]
[--ed]
[--eg]
[--entry-script]
[--environment-name]
[--environment-version]
[--failure-threshold]
[--gb]
[--gbl]
[--gc]
[--ic]
[--id]
[--is-migration]
[--kp]
[--ks]
[--lo]
[--max-request-wait-time]
[--model]
[--model-metadata-file]
[--no-wait]
[--nr]
[--path]
[--period-seconds]
[--po]
[--remove-tag]
[--replica-max-concurrent-requests]
[--resource-group]
[--rt]
[--sc]
[--scoring-timeout-ms]
[--sd]
[--se]
[--sk]
[--sp]
[--st]
[--subscription-id]
[--timeout-seconds]
[--token-auth-enabled]
[--workspace-name]
[-v]
Parâmetros Obrigatórios
O nome do serviço a ser atualizado.
Parâmetros Opcionais
Propriedade chave/valor a ser adicionada (e.g. key=value). Várias propriedades podem ser especificadas com várias opções --add-property.
Tag chave/valor a ser adicionada (e.g. key=value). Várias tags podem ser especificadas com várias opções --add-tag.
Ativar ou não a autenticação de chave para este WebService. O padrão é False.
Habilitar ou não o AppInsights para este WebService. O padrão é False.
Com que frequência o autoscaler deve tentar dimensionar este WebService. O padrão é 1.
Ativar ou não o dimensionamento automático para este WebService. O padrão é True se num_replicas for Nenhum.
A utilização alvo (em percentagem de 100) que o autoscaler deve tentar manter para este WebService. O padrão é 70.
O número máximo de contêineres a serem usados ao dimensionar automaticamente este WebService. O padrão é 10.
O número mínimo de contêineres a serem usados ao dimensionar automaticamente este WebService. O padrão é 1.
Uma imagem personalizada para ser usada como imagem base. Se nenhuma imagem base for fornecida, a imagem base será usada com base em determinado parâmetro de tempo de execução.
Registro de imagem que contém a imagem base.
O número de núcleos de cpu a alocar para este WebService. Pode ser decimal. O padrão é 0.1.
O número máximo de núcleos de CPU que este Webservice tem permissão para usar. Pode ser decimal.
Caminho para o arquivo local que contém uma definição de ambiente conda a ser usada para a imagem.
Se deve ou não habilitar a coleta de dados de modelo para este WebService. O padrão é False.
(Pré-visualização) Especifica o destino de computação com a extensão AzureML instalada para hospedar o ponto de extremidade e a implantação online do Kubernetes migrado.
Versão do CUDA para instalar para imagens que precisam de suporte de GPU. A imagem da GPU deve ser usada nos Serviços do Microsoft Azure, como Instâncias de Contêiner do Azure, Computação do Azure Machine Learning, Máquinas Virtuais do Azure e Serviço Kubernetes do Azure. As versões suportadas são 9.0, 9.1 e 10.0. Se 'enable_gpu' estiver definido, o padrão será '9.1'.
Caminho para um arquivo JSON contendo metadados de implantação.
Descrição do serviço.
O nome dns para este WebService.
Caminho para o arquivo local contendo etapas adicionais do Docker a serem executadas ao configurar a imagem.
Diretório para o Ambiente de Aprendizado de Máquina do Azure para implantação. É o mesmo caminho de diretório fornecido no comando 'az ml environment scaffold'.
Se deve ou não ativar o suporte à GPU na imagem. A imagem da GPU deve ser usada nos Serviços do Microsoft Azure, como Instâncias de Contêiner do Azure, Computação do Azure Machine Learning, Máquinas Virtuais do Azure e Serviço Kubernetes do Azure. O padrão é False.
Caminho para o arquivo local que contém o código a ser executado para o serviço (caminho relativo de source_directory se for fornecido).
Nome do Ambiente do Azure Machine Learning para implantação.
Versão de um Ambiente de Aprendizado de Máquina do Azure existente para implantação.
Quando um Pod é iniciado e a sonda de vivacidade falha, o Kubernetes tentará --failure-threshold times antes de desistir. O padrão é 3. O valor mínimo é 1.
A quantidade de memória (em GB) a alocar para este WebService. Pode ser decimal.
A quantidade máxima de memória (em GB) que este Webservice tem permissão para usar. Pode ser decimal.
O número de núcleos de gpu a alocar para este WebService. A predefinição é 1.
Caminho para um arquivo JSON ou YAML contendo configuração de inferência.
Número de segundos após o início do recipiente antes que as sondas de vivacidade sejam iniciadas. O padrão é 310.
(Pré-visualização) Migrar ou não o serviço Web AKS para o endpoint e a implantação online do Kubernetes. O padrão é False.
Uma chave de autenticação primária a ser usada para este WebService.
Uma chave de autenticação secundária a ser usada para este WebService.
A região do Azure na qual implantar este WebService. Se não for especificado, o local do espaço de trabalho será usado. Mais detalhes sobre as regiões disponíveis podem ser encontrados aqui: https://azure.microsoft.com/en-us/global-infrastructure/services/?regions=all& products=instâncias de contêiner.
A quantidade máxima de tempo que uma solicitação permanecerá na fila (em milissegundos) antes de retornar um erro 503. O padrão é 500.
A ID do modelo a ser implantado. Vários modelos podem ser especificados com argumentos -m adicionais. Os modelos precisam ser registrados primeiro.
Caminho para um arquivo JSON contendo metadados de registro de modelo. Vários modelos podem ser fornecidos usando vários parâmetros -f.
Sinalizar para não esperar por chamadas assíncronas.
O número de contêineres a serem alocados para este WebService. Não há padrão, se esse parâmetro não estiver definido, o autoscaler será habilitado por padrão.
Caminho para uma pasta de projeto. Padrão: diretório atual.
Com que frequência (em segundos) realizar a sonda de vivacidade. O padrão é de 10 segundos. O valor mínimo é 1.
A porta local na qual expor o ponto de extremidade HTTP do serviço.
Chave da tag a ser removida. Várias tags podem ser especificadas com várias opções --remove-tag.
O número máximo de solicitações simultâneas por nó para permitir este WebService. O padrão é 1.
Grupo de recursos correspondente ao espaço de trabalho fornecido.
Qual tempo de execução usar para imagem. Os tempos de execução atuais suportados são 'spark-py' e 'python'spark-py|python|python-slim.
O cname para se o SSL estiver habilitado. Aplicável apenas ao atualizar um serviço ACI.
Um tempo limite a ser imposto para marcar chamadas para este WebService. O padrão é 60000.
Caminho para pastas que contêm todos os arquivos para criar a imagem.
Ativar ou não o SSL para este WebService. O padrão é False.
O arquivo de chave necessário se o SSL estiver habilitado.
O arquivo cert necessário se o SSL estiver habilitado.
Sucessos consecutivos mínimos para que a sonda de vivacidade seja considerada bem-sucedida depois de ter falhado. O padrão é 1. O valor mínimo é 1.
Especifica a ID da assinatura.
Número de segundos após os quais a sonda de vivacidade expira. O padrão é de 2 segundos. O valor mínimo é 1.
Habilitar ou não a autenticação de token para este WebService. Disponível apenas para serviços web AKS. O padrão é False.
Nome do espaço de trabalho que contém o serviço a ser atualizado.
Bandeira de verbosidade.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.