Compartilhar via

az ml connection

  • Versão Prévia
  • Referência

Nota

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

Esse grupo de comandos está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gerencie a conexão do workspace 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

Listar todas as conexões.

 Extensão Visualizar
az ml connection show

Mostrar detalhes de uma conexão.

 Extensão Visualizar
az ml connection update

Atualize uma conexão.

 Extensão Visualizar

az ml connection create

Versão Prévia

O grupo de comandos 'ml connection' está em versão prévia 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 com base em 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 workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<name>.

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 do segredo 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 ser definido. Exemplo: --set property1.property2=value.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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 versão prévia 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 workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<name>.

Parâmetros Opcionais

--yes -y

Não solicite confirmação.

Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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 versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Listar todas as conexões.

A lista de conexões em um workspace.

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

Exemplos

Listar todas as conexões em um workspace

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

Listar todas as conexões em um workspace 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 workspace 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 workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<name>.

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 do segredo 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 a ser listada.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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 versão prévia 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 workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<name>.

Parâmetros Opcionais

--populate-secrets -p

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

Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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 versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Atualize uma conexão.

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

Exemplos

atualize uma conexão 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 workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<name>.

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor 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 em JSON.

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

Para conexões baseadas em chave de API, tente preencher as credenciais retornadas com o valor do segredo 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> OR --remove propertyToRemove.

Valor padrão: []
--set

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

Valor padrão: []
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.