Compartilhar via

az ml connection

  • Versão Prévia
  • Referência

Observação

Essa referência faz parte da extensão ml para a CLI do Azure (versão 2.15.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando de conexão az ml. Saiba mais sobre extensões.

Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gerenciar a conexão do espaço de trabalho do Azure ML e seus derivados mais específicos.

A conexão do Azure ML fornece uma maneira segura de armazenar informações de autenticação e configuração necessárias para se conectar e interagir com os recursos externos.

Comandos

Nome Description Tipo Status
az ml connection create

Crie uma conexão.

 Extensão Visualizar
az ml connection delete

Excluir uma conexão.

 Extensão Visualizar
az ml connection list

Liste todas as conexões.

 Extensão Visualizar
az ml connection show

Mostrar detalhes de uma conexão.

 Extensão Visualizar
az ml connection update

Atualizar uma conexão.

 Extensão Visualizar

az ml connection create

Versão Prévia

O grupo de comandos 'ml connection' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Crie uma conexão.

A conexão permite armazenar informações de autenticação e configuração necessárias para se conectar e interagir com os recursos externos.

az ml connection create --file
                        --resource-group
                        --workspace-name
                        [--name]
                        [--populate-secrets]
                        [--set]

Exemplos

Crie uma conexão a partir de um arquivo de especificação YAML.

az ml connection create --file connection.yml --resource-group my-resource-group --workspace-name my-workspace

Crie uma conexão a partir de um arquivo de especificação YAML e mostre a chave de API na conexão retornada para verificação.

az ml connection create --file connection.yml --resource-group my-resource-group --workspace-name my-workspace --populate-secrets

Parâmetros Exigidos

--file -f

Caminho local para o arquivo YAML que contém a especificação de conexão do Azure ML.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--workspace-name -w

Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>o .

Parâmetros Opcionais

--name -n

Nome do ambiente.

--populate-secrets -p

Para conexões baseadas em chave de API, tente preencher as credenciais retornadas com o valor secreto real. Não faz nada para conexões não baseadas em chave de API.

valor padrão: False
--set

Atualize um objeto especificando um caminho de propriedade e um valor a serem definidos. Exemplo: --set property1.property2=.

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 connection delete

Versão Prévia

O grupo de comandos 'ml connection' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Excluir uma conexão.

az ml connection delete --name
                        --resource-group
                        --workspace-name
                        [--yes]

Parâmetros Exigidos

--name -n

Nome do ambiente.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--workspace-name -w

Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>o .

Parâmetros Opcionais

--yes -y

Não solicite confirmação.

valor padrão: False
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 connection list

Versão Prévia

O grupo de comandos 'ml connection' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Liste todas as conexões.

A lista de conexões em um espaço de trabalho.

az ml connection list --resource-group
                      --workspace-name
                      [--max-results]
                      [--populate-secrets]
                      [--type]

Exemplos

Listar todas as conexões em um espaço de trabalho

az ml connection list --resource-group my-resource-group --workspace-name my-workspace

Listar todas as conexões em um espaço de trabalho e mostrar a chave de API para conexões aplicáveis

az ml connection list --resource-group my-resource-group --workspace-name my-workspace --populate-secrets

Liste todas as conexões em um espaço de trabalho usando o argumento --query para executar uma consulta JMESPath nos resultados dos comandos.

az ml connection list --query "[].{Name:name}"  --output table --resource-group my-resource-group --workspace-name my-workspace

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--workspace-name -w

Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>o .

Parâmetros Opcionais

--max-results -r

Número máximo de resultados a serem retornados.

--populate-secrets -p

Para conexões baseadas em chave de API, tente preencher as credenciais retornadas com o valor secreto real. Não faz nada para conexões não baseadas em chave de API.

valor padrão: False
--type -t

O tipo de conexão do Azure ML para lista.

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 connection show

Versão Prévia

O grupo de comandos 'ml connection' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Mostrar detalhes de uma conexão.

az ml connection show --name
                      --resource-group
                      --workspace-name
                      [--populate-secrets]

Exemplos

Mostrar detalhes de uma conexão, incluindo sua chave de API.

az ml connection show --resource-group my-resource-group --name my-connection-name --workspace-name my-workspace --populate-secrets

Parâmetros Exigidos

--name -n

Nome do ambiente.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--workspace-name -w

Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>o .

Parâmetros Opcionais

--populate-secrets -p

Para conexões baseadas em chave de API, tente preencher as credenciais retornadas com o valor secreto real. Não faz nada para conexões não baseadas em chave de API.

valor padrão: False
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 connection update

Versão Prévia

O grupo de comandos 'ml connection' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Atualizar uma conexão.

az ml connection update --name
                        --resource-group
                        --workspace-name
                        [--add]
                        [--force-string]
                        [--populate-secrets]
                        [--remove]
                        [--set]

Exemplos

atualizar uma conexão a partir de um arquivo de especificação YAML.

az ml connection update --resource-group my-resource-group --name my-connection-name --workspace-name my-workspace

Parâmetros Exigidos

--name -n

Nome do ambiente.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--workspace-name -w

Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>o .

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valores de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

valor padrão: []
--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter para JSON.

valor padrão: False
--populate-secrets -p

Para conexões baseadas em chave de API, tente preencher as credenciais retornadas com o valor secreto real. Não faz nada para conexões não baseadas em chave de API.

valor padrão: False
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OU --remove propertyToRemove.

valor padrão: []
--set

Atualize um objeto especificando um caminho de propriedade e um valor a serem definidos. Exemplo: --set property1.property2=<value>.

valor padrão: []
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.