az ml service
Note
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 de serviço az ml. Saiba mais sobre extensões.
Gerir serviços operacionalizados.
Comandos
| Name | Description | Tipo | Status |
|---|---|---|---|
| az ml service delete |
Exclua um serviço do espaço de trabalho. |
Extension | disponibilidade geral |
| az ml service get-access-token |
Obtenha um token para emitir solicitações de um serviço. |
Extension | disponibilidade geral |
| az ml service get-keys |
Obtenha chaves para emitir solicitações em relação a um serviço. |
Extension | disponibilidade geral |
| az ml service get-logs |
Obter logs para um serviço. |
Extension | disponibilidade geral |
| az ml service list |
Listar serviços no espaço de trabalho. |
Extension | disponibilidade geral |
| az ml service regen-key |
Regenere chaves para um serviço. |
Extension | disponibilidade geral |
| az ml service run |
Execute um serviço no espaço de trabalho. |
Extension | disponibilidade geral |
| az ml service show |
Mostrar detalhes de um serviço no espaço de trabalho. |
Extension | disponibilidade geral |
| az ml service update |
Atualize um serviço no espaço de trabalho. |
Extension | disponibilidade geral |
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]
[]
Parâmetros Obrigatórios
O nome do serviço a ser excluído.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
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.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
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]
[]
Parâmetros Obrigatórios
Nome do serviço.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
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.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
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]
[]
Parâmetros Obrigatórios
Nome do serviço.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
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.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
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]
[]
Parâmetros Obrigatórios
Nome do serviço.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
Obtenha logs do contêiner init em vez do contêiner de pontuação.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Número de linhas de log a serem retornadas da cauda (o padrão é 5000).
| Propriedade | Valor |
|---|---|
| Default value: | 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.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
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]
[]
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
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.
| Propriedade | Valor |
|---|---|
| Default value: | [] |
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.
| Propriedade | Valor |
|---|---|
| Default value: | [] |
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.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
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]
[]
Parâmetros Obrigatórios
Qual chave regenerar, se regen for especificado. Opções: Primária, Secundária.
Nome do serviço.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
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.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
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]
[]
Parâmetros Obrigatórios
O nome do serviço para pontuar contra.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
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.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
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]
[]
Parâmetros Obrigatórios
Nome do serviço Web a ser exibido.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
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.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az ml service update
Atualize um serviço no espaço de trabalho.
az ml service update --name
[--add-property]
[--add-tag]
[--ae --auth-enabled]
[--ai --enable-app-insights]
[--ar --autoscale-refresh-seconds]
[--as --autoscale-enabled]
[--at --autoscale-target-utilization]
[--autoscale-max-replicas --ma]
[--autoscale-min-replicas --mi]
[--base-image --bi]
[--base-image-registry --ir]
[--cc --cpu-cores]
[--ccl --cpu-cores-limit]
[--cf --conda-file]
[--collect-model-data --md]
[--compute-target]
[--cuda-version --cv]
[--dc --deploy-config-file]
[--description]
[--dn --dns-name-label]
[--ds --extra-docker-file-steps]
[--ed --environment-directory]
[--eg --enable-gpu]
[--entry-script --es]
[--environment-name]
[--environment-version --ev]
[--failure-threshold --ft]
[--gb --memory-gb]
[--gbl --memory-gb-limit]
[--gc --gpu-cores]
[--ic --inference-config-file]
[--id --initial-delay-seconds]
[--is-migration]
[--kp --primary-key]
[--ks --secondary-key]
[--lo --location]
[--max-request-wait-time --mr]
[--model]
[--model-metadata-file]
[--no-wait]
[--nr --num-replicas]
[--path]
[--period-seconds --ps]
[--po --port]
[--remove-tag]
[--replica-max-concurrent-requests --rm]
[--resource-group]
[--rt --runtime]
[--sc --ssl-cname]
[--scoring-timeout-ms --tm]
[--sd --source-directory]
[--se --ssl-enabled]
[--sk --ssl-key-pem-file]
[--sp --ssl-cert-pem-file]
[--st --success-threshold]
[--subscription-id]
[--timeout-seconds --ts]
[--token-auth-enabled]
[--workspace-name]
[]
Parâmetros Obrigatórios
O nome do serviço a ser atualizado.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
Propriedade chave/valor a ser adicionada (e.g. key=value). Várias propriedades podem ser especificadas com várias opções --add-property.
| Propriedade | Valor |
|---|---|
| Default value: | [] |
Tag chave/valor a ser adicionada (e.g. key=value). Várias tags podem ser especificadas com várias opções --add-tag.
| Propriedade | Valor |
|---|---|
| Default value: | [] |
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. O padrã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.
| Propriedade | Valor |
|---|---|
| Default value: | [] |
Caminho para um arquivo JSON contendo metadados de registro de modelo. Vários modelos podem ser fornecidos usando vários parâmetros -f.
| Propriedade | Valor |
|---|---|
| Default value: | [] |
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.
| Propriedade | Valor |
|---|---|
| Default value: | [] |
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.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |