Compartilhar via

az ml service

  • Referência

Observação

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.

Gerenciar serviços operacionalizados.

Comandos

Nome Description Tipo Status
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 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

Regenerar 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

Atualizar 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 Exigidos

--name -n

O nome do serviço a ser excluído.

Parâmetros Opcionais

--path

Caminho para uma pasta de projeto. Padrão: diretório atual.

--resource-group -g

Grupo de recursos correspondente ao espaço de trabalho fornecido.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho que contém o serviço a ser excluído.

-v

Bandeira de verbosidade.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. 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 Exigidos

--name -n

Nome do serviço.

Parâmetros Opcionais

--path

Caminho para uma pasta de projeto. Padrão: diretório atual.

--resource-group -g

Grupo de recursos correspondente ao espaço de trabalho fornecido.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho que contém o serviço a ser mostrado.

-v

Bandeira de verbosidade.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

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]
                       [-v]

Parâmetros Exigidos

--name -n

Nome do serviço.

Parâmetros Opcionais

--path

Caminho para uma pasta de projeto. Padrão: diretório atual.

--resource-group -g

Grupo de recursos correspondente ao espaço de trabalho fornecido.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho que contém o serviço a ser mostrado.

-v

Bandeira de verbosidade.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. 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 Exigidos

--name -n

Nome do serviço.

Parâmetros Opcionais

--init -i

Obtenha logs do contêiner de inicialização em vez do contêiner de pontuação.

valor padrão: False
--num_lines -l

Número de linhas de log a serem retornadas da cauda (o padrão é 5000).

valor padrão: 5000
--path

Caminho para uma pasta de projeto. Padrão: diretório atual.

--resource-group -g

Grupo de recursos correspondente ao espaço de trabalho fornecido.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho que contém o serviço a ser mostrado.

-v

Bandeira de verbosidade.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. 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

--compute-type -c

Se fornecido, mostrará apenas os serviços que têm o tipo de computação especificado. (As opções são 'ACI', 'AKS').

--image-digest

Se fornecido, mostrará apenas os serviços que têm o resumo de imagem especificado.

--model-id

Se fornecido, mostrará apenas os serviços que têm a ID do modelo especificado.

--model-name

Se fornecido, mostrará apenas os serviços que têm o nome do modelo especificado.

--path

Caminho para uma pasta de projeto. Padrão: diretório atual.

--property

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.

valor padrão: []
--resource-group -g

Grupo de recursos correspondente ao espaço de trabalho fornecido.

--subscription-id

Especifica a ID da assinatura.

--tag

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.

valor padrão: []
--workspace-name -w

Nome do espaço de trabalho que contém os serviços a serem listados.

-v

Bandeira de verbosidade.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

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]
                        [-v]

Parâmetros Exigidos

--key -k

Qual chave regenerar, se regen for especificado. Opções: Primária, Secundária.

--name -n

Nome do serviço.

Parâmetros Opcionais

--path

Caminho para uma pasta de projeto. Padrão: diretório atual.

--resource-group -g

Grupo de recursos correspondente ao espaço de trabalho fornecido.

--set-key -s

Forneça o valor de autenticação para a chave especificada.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho que contém o serviço a ser mostrado.

-v

Bandeira de verbosidade.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. 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 Exigidos

--name -n

O nome do serviço a ser marcado.

Parâmetros Opcionais

--input-data -d

Os dados a serem usados para chamar o serviço Web.

--path

Caminho para uma pasta de projeto. Padrão: diretório atual.

--resource-group -g

Grupo de recursos correspondente ao espaço de trabalho fornecido.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho que contém o serviço a ser executado.

-v

Bandeira de verbosidade.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. 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 Exigidos

--name -n

Nome do webservice a ser exibido.

Parâmetros Opcionais

--path

Caminho para uma pasta de projeto. Padrão: diretório atual.

--resource-group -g

Grupo de recursos correspondente ao espaço de trabalho fornecido.

--subscription-id

Especifica a ID da assinatura.

--workspace-name -w

Nome do espaço de trabalho que contém o serviço a ser mostrado.

-v

Bandeira de verbosidade.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az ml service update

Atualizar 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 Exigidos

--name -n

O nome do serviço a ser atualizado.

Parâmetros Opcionais

--add-property

Propriedade chave/valor a ser adicionada (e.g. key=valor ). Várias propriedades podem ser especificadas com várias opções --add-property.

valor padrão: []
--add-tag

Tag chave/valor a ser adicionada (e.g. key=valor). Várias tags podem ser especificadas com várias opções --add-tag.

valor padrão: []
--ae --auth-enabled

Se a autenticação de chave deve ou não ser habilitada para esse serviço Web. Usa False como padrão.

--ai --enable-app-insights

Se o AppInsights deve ser habilitado ou não para esse serviço Web. Usa False como padrão.

--ar --autoscale-refresh-seconds

Com que frequência o dimensionador automático deve tentar dimensionar esse serviço Web. O valor padrão é 1.

--as --autoscale-enabled

Se o dimensionamento automático deve ou não ser habilitado para este serviço Web. O valor padrão será True se num_replicas for None.

--at --autoscale-target-utilization

A utilização de destino (em percentual de 100) que o dimensionador automático deve tentar manter para esse serviço Web. O valor padrão é 70.

--autoscale-max-replicas --ma

O número máximo de contêineres usados no dimensionamento automático desse serviço Web. O valor padrão é 10.

--autoscale-min-replicas --mi

O número mínimo de contêineres a serem usados no dimensionamento automático desse serviço Web. O valor padrão é 1.

--base-image --bi

Uma imagem personalizada a ser usada como imagem base. Se nenhuma imagem base for fornecida, a imagem base será usada com base no parâmetro de runtime determinado.

--base-image-registry --ir

Registro de imagem que contém a imagem base.

--cc --cpu-cores

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.

--ccl --cpu-cores-limit

O número máximo de núcleos de CPU que esse serviço Web tem permissão para usar. Pode ser um decimal.

--cf --conda-file

Caminho para o arquivo local que contém uma definição de ambiente conda a ser usada para a imagem.

--collect-model-data --md

Se a coleta de dados de modelo deve ou não ser habilitada para esse serviço Web. Usa False como padrão.

--compute-target

(Visualização) Especifica o destino de computação com a extensão AzureML instalada para hospedar o ponto de extremidade online e a implantação migrados do Kubernetes.

--cuda-version --cv

Versão do CUDA a ser instalada para imagens que precisam de suporte a GPU. A imagem de GPU precisa ser usada em serviços do Microsoft Azure, como Instâncias de Contêiner do Azure, Computação do 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' estiver definido, o padrão será '9.1'.

--dc --deploy-config-file

Caminho para um arquivo JSON que contém metadados de implantação.

--description -d

Descrição do serviço.

--dn --dns-name-label

O nome dns para este Webservice.

--ds --extra-docker-file-steps

Caminho para o arquivo local que contém etapas adicionais do Docker a serem executadas durante a configuração da imagem.

--ed --environment-directory

Diretório do Ambiente de Aprendizado de Máquina do Azure para implantação. É o mesmo caminho de diretório fornecido no comando 'az ml environment scaffold'.

--eg --enable-gpu

Se o suporte à GPU deve ou não ser habilitado na imagem. A imagem de GPU precisa ser usada em serviços do Microsoft Azure, como Instâncias de Contêiner do Azure, Computação do Machine Learning, Máquinas Virtuais do Azure e Serviço de Kubernetes do Azure. Usa False como padrão.

--entry-script --es

Caminho para o arquivo local que contém o código a ser executado para o serviço (caminho relativo de source_directory se um for fornecido).

--environment-name -e

Nome do Ambiente de Aprendizado de Máquina do Azure para implantação.

--environment-version --ev

Versão de um Ambiente de Aprendizado de Máquina do Azure existente para implantação.

--failure-threshold --ft

Quando um Pod é iniciado e o teste de vivacidade falha, o Kubernetes tenta --failure-threshold vezes antes de desistir. O valor padrão é 3. O valor mínimo é 1.

--gb --memory-gb

A quantidade de memória (em GB) alocada para esse serviço Web. Pode ser um decimal.

--gbl --memory-gb-limit

A quantidade máxima de memória (em GB) que esse serviço Web tem permissão para usar. Pode ser um decimal.

--gc --gpu-cores

O número de núcleos gpu a serem alocados para este Webservice. O padrão é UTF-1.

--ic --inference-config-file

Caminho para um arquivo JSON ou YAML que contém a configuração de inferência.

--id --initial-delay-seconds

Número de segundos depois que o contêiner é iniciado antes que as investigações de atividade sejam iniciadas. O valor padrão é 310.

--is-migration

(Visualização) Migrar ou não o serviço Web AKS para o endpoint e a implantação online do Kubernetes. Usa False como padrão.

--kp --primary-key

Uma chave de autenticação primária a ser usada para esse serviço Web.

--ks --secondary-key

Uma chave de autenticação secundária usada para esse serviço Web.

--lo --location

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=instâncias de contêiner.

--max-request-wait-time --mr

A quantidade máxima de tempo que uma solicitação permanece na fila (em milissegundos) antes de retornar um erro 503. O valor padrão é 500.

--model -m

A ID do modelo a ser implantado. Vários modelos podem ser especificados com argumentos -m adicionais. Os modelos precisam ser registrados primeiro.

valor padrão: []
--model-metadata-file -f

Caminho para um arquivo JSON que contém metadados de registro de modelo. Vários modelos podem ser fornecidos usando vários parâmetros -f.

valor padrão: []
--no-wait

Sinalize para não aguardar chamadas assíncronas.

--nr --num-replicas

O número de contêineres alocados para este serviço Web. Não há valor padrão. Se esse parâmetro não for definido, o dimensionador automático será habilitado por padrão.

--path

Caminho para uma pasta de projeto. Padrão: diretório atual.

--period-seconds --ps

A frequência (em segundos) para realizar a investigação de atividade. O padrão é 10 segundos. O valor mínimo é 1.

--po --port

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

--remove-tag

Chave da tag a ser removida. Várias tags podem ser especificadas com várias opções --remove-tag.

valor padrão: []
--replica-max-concurrent-requests --rm

O número máximo de solicitações simultâneas por nó para permitir esse Webservice. O valor padrão é 1.

--resource-group -g

Grupo de recursos correspondente ao espaço de trabalho fornecido.

--rt --runtime

Qual tempo de execução usar para imagem. Os tempos de execução suportados atualmente são 'spark-py' e 'python'spark-py|python|python-slim.

--sc --ssl-cname

O cname a ser usado se o SSL estiver habilitado. Aplicável somente ao atualizar um serviço ACI.

--scoring-timeout-ms --tm

Um tempo limite para aplicar chamadas de pontuação para esse serviço Web. O valor padrão é 60000.

--sd --source-directory

Caminho para pastas que contêm todos os arquivos para criar a imagem.

--se --ssl-enabled

Se o SSL deve ser habilitado ou não para esse serviço Web. Usa False como padrão.

--sk --ssl-key-pem-file

O arquivo de chave necessário se o SSL estiver habilitado.

--sp --ssl-cert-pem-file

O arquivo de certificado necessário se o SSL estiver habilitado.

--st --success-threshold

O mínimo de sucessos consecutivos para que a investigação de atividade seja considerada bem-sucedida após apresentar falha. O valor padrão é 1. O valor mínimo é 1.

--subscription-id

Especifica a ID da assinatura.

--timeout-seconds --ts

Número de segundos após os quais a investigação de atividade expira. O valor padrão é 2 segundo. O valor mínimo é 1.

--token-auth-enabled

Habilitar ou não a autenticação de token para este Webservice. Disponível apenas para serviços web AKS. Usa False como padrão.

--workspace-name -w

Nome do espaço de trabalho que contém o serviço a ser atualizado.

-v

Bandeira de verbosidade.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.