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 instalará automaticamente na primeira vez que você executar um comando az ml service. Saiba mais sobre extensões.
Gerenciar serviços operacionalizados.
Comandos
| Nome | Description | Tipo | Status |
|---|---|---|---|
| az ml service delete |
Exclua um serviço do workspace. |
Extension | GA |
| az ml service get-access-token |
Obtenha um token para emitir solicitações de um serviço. |
Extension | GA |
| az ml service get-keys |
Obtenha chaves para emitir solicitações em um serviço. |
Extension | GA |
| az ml service get-logs |
Obtenha logs para um serviço. |
Extension | GA |
| az ml service list |
Listar serviços no workspace. |
Extension | GA |
| az ml service regen-key |
Regenerar chaves para um serviço. |
Extension | GA |
| az ml service run |
Execute um serviço no workspace. |
Extension | GA |
| az ml service show |
Mostrar detalhes de um serviço no workspace. |
Extension | GA |
| az ml service update |
Atualize um serviço no workspace. |
Extension | GA |
az ml service delete
Exclua um serviço do workspace.
az ml service delete --name
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[]
Parâmetros Exigidos
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 se tornar obrigatórios para que o comando seja executado com sucesso.
Caminho para uma pasta de projeto. Padrão: diretório atual.
Grupo de recursos correspondente ao workspace fornecido.
Especifica a ID da assinatura.
Nome do workspace que contém o serviço a ser excluído.
Sinalizador de verbosidade.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | 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 Exigidos
Nome do serviço.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Caminho para uma pasta de projeto. Padrão: diretório atual.
Grupo de recursos correspondente ao workspace fornecido.
Especifica a ID da assinatura.
Nome do workspace que contém o serviço a ser mostrado.
Sinalizador de verbosidade.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az ml service get-keys
Obtenha chaves para emitir solicitações em um serviço.
az ml service get-keys --name
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[]
Parâmetros Exigidos
Nome do serviço.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Caminho para uma pasta de projeto. Padrão: diretório atual.
Grupo de recursos correspondente ao workspace fornecido.
Especifica a ID da assinatura.
Nome do workspace que contém o serviço a ser mostrado.
Sinalizador de verbosidade.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az ml service get-logs
Obtenha logs para um serviço.
az ml service get-logs --name
[--init]
[--num_lines]
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[]
Parâmetros Exigidos
Nome do serviço.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Obtenha logs do contêiner de inicialização em vez do contêiner de pontuação.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Número de linhas de log a serem retornadas da parte final (o padrão é 5000).
| Propriedade | Valor |
|---|---|
| Valor padrão: | 5000 |
Caminho para uma pasta de projeto. Padrão: diretório atual.
Grupo de recursos correspondente ao workspace fornecido.
Especifica a ID da assinatura.
Nome do workspace que contém o serviço a ser mostrado.
Sinalizador de verbosidade.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az ml service list
Listar serviços no workspace.
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 se tornar obrigatórios para que o comando seja executado com sucesso.
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 especificada.
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 de propriedade --.
| Propriedade | Valor |
|---|---|
| Valor padrão: | [] |
Grupo de recursos correspondente ao workspace fornecido.
Especifica a ID da assinatura.
Se fornecido, filtrará com base na chave/valor fornecido (e.g. key ou key=value). Várias marcas podem ser especificadas com várias opções de --tag.
| Propriedade | Valor |
|---|---|
| Valor padrão: | [] |
Nome do workspace que contém os serviços a serem listados.
Sinalizador de verbosidade.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az ml service regen-key
Regenerar chaves para um serviço.
az ml service regen-key --key
--name
[--path]
[--resource-group]
[--set-key]
[--subscription-id]
[--workspace-name]
[]
Parâmetros Exigidos
Qual chave regenerar, se a regen for especificada. Opções: Primário, Secundário.
Nome do serviço.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Caminho para uma pasta de projeto. Padrão: diretório atual.
Grupo de recursos correspondente ao workspace fornecido.
Forneça o valor de autenticação para a chave especificada.
Especifica a ID da assinatura.
Nome do workspace que contém o serviço a ser mostrado.
Sinalizador de verbosidade.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az ml service run
Execute um serviço no workspace.
az ml service run --name
[--input-data]
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[]
Parâmetros Exigidos
O nome do serviço no qual pontuar.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
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 workspace fornecido.
Especifica a ID da assinatura.
Nome do workspace que contém o serviço a ser executado.
Sinalizador de verbosidade.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az ml service show
Mostrar detalhes de um serviço no workspace.
az ml service show --name
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[]
Parâmetros Exigidos
Nome do serviço Web a ser mostrado.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Caminho para uma pasta de projeto. Padrão: diretório atual.
Grupo de recursos correspondente ao workspace fornecido.
Especifica a ID da assinatura.
Nome do workspace que contém o serviço a ser mostrado.
Sinalizador de verbosidade.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az ml service update
Atualize um serviço no workspace.
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 Exigidos
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 se tornar obrigatórios para que o comando seja executado com sucesso.
Propriedade key/value a ser adicionada (e.g. key=value). Várias propriedades podem ser especificadas com várias opções de --add-property.
| Propriedade | Valor |
|---|---|
| Valor padrão: | [] |
Marca de chave/valor a ser adicionada (e.g. key=valor). Várias marcas podem ser especificadas com várias opções de --add-tag.
| Propriedade | Valor |
|---|---|
| Valor padrão: | [] |
Habilitar ou não a autenticação de chave para este serviço Web. Usa False como padrão.
Habilitar ou não o AppInsights para esse serviço Web. Usa False como padrão.
Com que frequência o dimensionador automático deve tentar dimensionar esse serviço Web. O padrão é 1.
Se deseja ou não habilitar o dimensionamento automático para este serviço Web. O padrão será True se num_replicas for None.
A utilização de destino (em porcentagem de 100) que o dimensionador automático deve tentar manter para esse serviço Web. O padrão é 70.
O número máximo de contêineres a serem usados ao dimensionar automaticamente esse serviço Web. O padrão é 10.
O número mínimo de contêineres a serem usados ao dimensionar automaticamente esse serviço Web. O padrão é 1.
Uma imagem personalizada a ser usada como imagem base. Se nenhuma imagem base for fornecida, a imagem base será usada com base em determinado parâmetro de runtime.
Registro de imagem que contém a imagem base.
O número de núcleos de cpu a serem alocados para esse serviço Web. Pode ser um decimal. O padrão é 0.1.
O número máximo de núcleos de CPU que esse serviço Web tem permissão para usar. Pode ser um decimal.
Caminho para o arquivo local que contém uma definição de ambiente conda a ser usada para a imagem.
Habilitar ou não a coleta de dados de modelo para este serviço Web. Usa False como padrão.
(Versão prévia) Especifica o destino de computação com a extensão do AzureML instalada para hospedar o ponto de extremidade e a implantação online do Kubernetes migrados.
Versão do CUDA a ser instalada para imagens que precisam de suporte para GPU. A imagem de 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 de Kubernetes do Azure. As versões com suporte são 9.0, 9.1 e 10.0. Se 'enable_gpu' for definido, esse padrão será '9.1'.
Caminho para um arquivo JSON que contém metadados de implantação.
Descrição do serviço.
O nome dns para este serviço Web.
Caminho para o arquivo local que contém etapas adicionais do Docker a serem executadas ao configurar a imagem.
Diretório para o Ambiente do Azure Machine Learning para implantação. É o mesmo caminho de diretório fornecido no comando 'az ml environment scaffold'.
Se deseja ou não habilitar o suporte à GPU na imagem. A imagem de 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 de Kubernetes do Azure. Usa False como padrão.
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 existente do Azure Machine Learning para implantação.
Quando um Pod é iniciado e a investigação de atividade falha, o Kubernetes tentará --tempos de limite de falha antes de desistir. O padrão é 3. O valor mínimo é 1.
A quantidade de memória (em GB) a ser alocada para esse serviço Web. Pode ser um decimal.
A quantidade máxima de memória (em GB) que esse serviço Web tem permissão para usar. Pode ser um decimal.
O número de núcleos de gpu a serem alocados para esse serviço Web. O padrão é 1.
Caminho para um arquivo JSON ou YAML que contém a configuração de inferência.
Número de segundos após o início do contêiner antes do início das investigações de atividade. O padrão é 310.
(Versão prévia) Migrar ou não o serviço Web do AKS para o ponto de extremidade online e a implantação do Kubernetes. Usa False como padrão.
Uma chave de autenticação primária a ser usada para este serviço Web.
Uma chave de autenticação secundária a ser usada para este serviço Web.
A região do Azure na qual implantar esse serviço Web. Se não for especificado, o local do workspace 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=container-instances.
O tempo máximo 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 |
|---|---|
| Valor padrão: | [] |
Caminho para um arquivo JSON que contém metadados de registro de modelo. Vários modelos podem ser fornecidos usando vários parâmetros de -f.
| Propriedade | Valor |
|---|---|
| Valor padrão: | [] |
Sinalizador para não esperar por chamadas assíncronas.
O número de contêineres a serem alocados para esse serviço Web. Sem padrão, se esse parâmetro não for definido, o dimensionador automático será habilitado por padrão.
Caminho para uma pasta de projeto. Padrão: diretório atual.
A frequência (em segundos) para realizar a investigação de atividade. Padrão para 10 segundos. O valor mínimo é 1.
A porta local na qual expor o ponto de extremidade HTTP do serviço.
Chave da marca a ser removida. Várias marcas podem ser especificadas com várias opções --remove-tag.
| Propriedade | Valor |
|---|---|
| Valor padrão: | [] |
O número máximo de solicitações simultâneas por nó para permitir esse serviço Web. O padrão é 1.
Grupo de recursos correspondente ao workspace fornecido.
Qual runtime usar para a imagem. Os runtimes atuais com suporte são 'spark-py' e 'python'spark-py|python|python-slim.
O cname para se o SSL estiver habilitado. Aplicável somente ao atualizar um serviço ACI.
Um tempo limite a ser aplicado para a pontuação de chamadas para esse serviço Web. O padrão é 60000.
Caminho para pastas que contêm todos os arquivos para criar a imagem.
Se deseja ou não habilitar o SSL para este serviço Web. Usa False como padrão.
O arquivo de chave necessário se o SSL estiver habilitado.
O arquivo de certificado necessário se o SSL estiver habilitado.
O mínimo de sucessos consecutivos para que a investigação de atividade seja considerada bem-sucedida após apresentar falha. O padrão é 1. O valor mínimo é 1.
Especifica a ID da assinatura.
Número de segundos após o qual a investigação de vida atinge o tempo limite. O padrão é 2 segundos. O valor mínimo é 1.
Habilitar ou não a autenticação de token para esse serviço Web. Disponível somente para serviços Web do AKS. Usa False como padrão.
Nome do workspace que contém o serviço a ser atualizado.
Sinalizador de verbosidade.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |