Partilhar via

az ml connection

  • Pré-visualizar
  • Referência

Observação

Essa referência faz parte da extensão de de 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 az ml connection. Saiba mais sobre extensões.

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

Gerencie 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

Name Description Tipo Status
az ml connection create

Crie uma conexão.

 Extensão Previsualizar
az ml connection delete

Exclua uma conexão.

 Extensão Previsualizar
az ml connection list

Liste todas as conexões.

 Extensão Previsualizar
az ml connection show

Mostrar detalhes de uma conexão.

 Extensão Previsualizar
az ml connection update

Atualize uma conexão.

 Extensão Previsualizar

az ml connection create

Pré-visualizar

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

Crie uma conexão.

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 da 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 Obrigatórios

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

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.

Default value: False
--set

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

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
Default value: json
--query

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

--subscription

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

--verbose

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

az ml connection delete

Pré-visualizar

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

Exclua uma conexão.

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

Parâmetros Obrigatórios

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

Parâmetros Opcionais

--yes -y

Não solicite confirmação.

Default value: False
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
Default value: json
--query

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

--subscription

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

--verbose

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

az ml connection list

Pré-visualizar

O grupo de comandos 'ml connection' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: 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 da 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 Obrigatórios

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

Parâmetros Opcionais

--max-results -r

Número máximo de resultados a retornar.

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

Default value: False
--type -t

O tipo de conexão do Azure ML com a lista.

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
Default value: json
--query

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

--subscription

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

--verbose

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

az ml connection show

Pré-visualizar

O grupo de comandos 'ml connection' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: 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 Obrigatórios

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

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.

Default value: False
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
Default value: json
--query

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

--subscription

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

--verbose

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

az ml connection update

Pré-visualizar

O grupo de comandos 'ml connection' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: 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

atualizar 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 Obrigatórios

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

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

Default value: []
--force-string

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

Default value: 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.

Default value: False
--remove

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

Default value: []
--set

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

Default value: []
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
Default value: json
--query

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

--subscription

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

--verbose

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