Partilhar via


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

--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 de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

--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 exibido.

-v

Bandeira de verbosidade.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

--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 exibido.

-v

Bandeira de verbosidade.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

--name -n

Nome do serviço.

Parâmetros Opcionais

--init -i

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

valor predefinido: False
--num_lines -l

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

valor predefinido: 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 exibido.

-v

Bandeira de verbosidade.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

--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 predefinido: []
--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 predefinido: []
--workspace-name -w

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

-v

Bandeira de verbosidade.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

--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 exibido.

-v

Bandeira de verbosidade.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

--name -n

O nome do serviço para pontuar contra.

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 de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

--name -n

Nome do serviço Web 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 exibido.

-v

Bandeira de verbosidade.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

--name -n

O nome do serviço a ser atualizado.

Parâmetros Opcionais

--add-property

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

valor predefinido: []
--add-tag

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

valor predefinido: []
--ae --auth-enabled

Ativar ou não a autenticação de chave para este WebService. O padrão é False.

--ai --enable-app-insights

Habilitar ou não o AppInsights para este WebService. O padrão é False.

--ar --autoscale-refresh-seconds

Com que frequência o autoscaler deve tentar dimensionar este WebService. O padrão é 1.

--as --autoscale-enabled

Ativar ou não o dimensionamento automático para este WebService. O padrão é True se num_replicas for Nenhum.

--at --autoscale-target-utilization

A utilização alvo (em percentagem de 100) que o autoscaler deve tentar manter para este WebService. O padrão é 70.

--autoscale-max-replicas --ma

O número máximo de contêineres a serem usados ao dimensionar automaticamente este WebService. O padrão é 10.

--autoscale-min-replicas --mi

O número mínimo de contêineres a serem usados ao dimensionar automaticamente este WebService. O padrão é 1.

--base-image --bi

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.

--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 alocar para este WebService. Pode ser decimal. O padrão é 0.1.

--ccl --cpu-cores-limit

O número máximo de núcleos de CPU que este Webservice tem permissão para usar. Pode ser 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 deve ou não habilitar a coleta de dados de modelo para este WebService. O padrão é False.

--compute-target

(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.

--cuda-version --cv

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'.

--dc --deploy-config-file

Caminho para um arquivo JSON contendo 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 contendo etapas adicionais do Docker a serem executadas ao configurar a imagem.

--ed --environment-directory

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'.

--eg --enable-gpu

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.

--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 for fornecido).

--environment-name -e

Nome do Ambiente do Azure Machine Learning 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 a sonda de vivacidade falha, o Kubernetes tentará --failure-threshold times antes de desistir. O padrão é 3. O valor mínimo é 1.

--gb --memory-gb

A quantidade de memória (em GB) a alocar para este WebService. Pode ser decimal.

--gbl --memory-gb-limit

A quantidade máxima de memória (em GB) que este Webservice tem permissão para usar. Pode ser decimal.

--gc --gpu-cores

O número de núcleos de gpu a alocar para este WebService. A predefinição é 1.

--ic --inference-config-file

Caminho para um arquivo JSON ou YAML contendo configuração de inferência.

--id --initial-delay-seconds

Número de segundos após o início do recipiente antes que as sondas de vivacidade sejam iniciadas. O padrão é 310.

--is-migration

(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.

--kp --primary-key

Uma chave de autenticação primária a ser usada para este WebService.

--ks --secondary-key

Uma chave de autenticação secundária a ser usada para este WebService.

--lo --location

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.

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

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.

--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 predefinido: []
--model-metadata-file -f

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

valor predefinido: []
--no-wait

Sinalizar para não esperar por chamadas assíncronas.

--nr --num-replicas

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.

--path

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

--period-seconds --ps

Com que frequência (em segundos) realizar a sonda de vivacidade. O padrão é de 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 predefinido: []
--replica-max-concurrent-requests --rm

O número máximo de solicitações simultâneas por nó para permitir este WebService. O 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 atuais suportados são 'spark-py' e 'python'spark-py|python|python-slim.

--sc --ssl-cname

O cname para se o SSL estiver habilitado. Aplicável apenas ao atualizar um serviço ACI.

--scoring-timeout-ms --tm

Um tempo limite a ser imposto para marcar chamadas para este WebService. O padrão é 60000.

--sd --source-directory

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

--se --ssl-enabled

Ativar ou não o SSL para este WebService. O padrão é False.

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

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

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

O arquivo cert necessário se o SSL estiver habilitado.

--st --success-threshold

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.

--subscription-id

Especifica a ID da assinatura.

--timeout-seconds --ts

Número de segundos após os quais a sonda de vivacidade expira. O padrão é de 2 segundos. 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. O padrão é False.

--workspace-name -w

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

-v

Bandeira de verbosidade.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.