Condividi tramite

az ml connection

  • Anteprima
  • Riferimento

Nota

Questo riferimento fa parte dell'estensione ml per l'interfaccia della riga di comando di Azure (versione 2.15.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az ml connection . Altre informazioni sulle estensioni.

Questo gruppo di comandi è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Gestire la connessione all'area di lavoro di Azure ML e i relativi derivati più specifici.

La connessione di Azure ML offre un modo sicuro per archiviare le informazioni di autenticazione e configurazione necessarie per connettersi e interagire con le risorse esterne.

Comandi

Nome Descrizione Tipo Stato
az ml connection create

Crea una connessione.

 Estensione Anteprima
az ml connection delete

Eliminare una connessione.

 Estensione Anteprima
az ml connection list

Elencare tutte le connessioni.

 Estensione Anteprima
az ml connection show

Mostra i dettagli di una connessione.

 Estensione Anteprima
az ml connection update

Aggiornare una connessione.

 Estensione Anteprima

az ml connection create

Anteprima

Il gruppo di comandi 'ml connection' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Crea una connessione.

La connessione consente di archiviare le informazioni di autenticazione e configurazione necessarie per connettersi e interagire con le risorse esterne.

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

Esempio

Creare una connessione da un file di specifica YAML.

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

Creare una connessione da un file di specifica YAML e visualizzare la chiave API nella connessione restituita per la verifica.

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

Parametri necessari

--file -f

Percorso locale del file YAML contenente la specifica di connessione di Azure ML.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--workspace-name -w

Nome dell'area di lavoro di Azure ML. È possibile configurare l'area di lavoro predefinita usando az configure --defaults workspace=<name>.

Parametri facoltativi

--name -n

Nome dell'ambiente.

--populate-secrets -p

Per le connessioni basate su chiave API, provare a popolare le credenziali restituite con il valore del segreto effettivo. Non esegue alcuna operazione per le connessioni non basate su chiave API.

valore predefinito: False
--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az ml connection delete

Anteprima

Il gruppo di comandi 'ml connection' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Eliminare una connessione.

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

Parametri necessari

--name -n

Nome dell'ambiente.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--workspace-name -w

Nome dell'area di lavoro di Azure ML. È possibile configurare l'area di lavoro predefinita usando az configure --defaults workspace=<name>.

Parametri facoltativi

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az ml connection list

Anteprima

Il gruppo di comandi 'ml connection' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Elencare tutte le connessioni.

Elenco di connessioni in un'area di lavoro.

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

Esempio

Elencare tutte le connessioni in un'area di lavoro

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

Elencare tutte le connessioni in un'area di lavoro e visualizzare la chiave API per le connessioni applicabili

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

Elencare tutte le connessioni in un'area di lavoro usando l'argomento --query per eseguire una query JMESPath sui risultati dei comandi.

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

Parametri necessari

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--workspace-name -w

Nome dell'area di lavoro di Azure ML. È possibile configurare l'area di lavoro predefinita usando az configure --defaults workspace=<name>.

Parametri facoltativi

--max-results -r

Numero massimo di risultati da restituire.

--populate-secrets -p

Per le connessioni basate su chiave API, provare a popolare le credenziali restituite con il valore del segreto effettivo. Non esegue alcuna operazione per le connessioni non basate su chiave API.

valore predefinito: False
--type -t

Tipo di connessione di Azure ML da elencare.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az ml connection show

Anteprima

Il gruppo di comandi 'ml connection' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Mostra i dettagli di una connessione.

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

Esempio

Mostra i dettagli di una connessione, inclusa la relativa chiave API.

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

Parametri necessari

--name -n

Nome dell'ambiente.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--workspace-name -w

Nome dell'area di lavoro di Azure ML. È possibile configurare l'area di lavoro predefinita usando az configure --defaults workspace=<name>.

Parametri facoltativi

--populate-secrets -p

Per le connessioni basate su chiave API, provare a popolare le credenziali restituite con il valore del segreto effettivo. Non esegue alcuna operazione per le connessioni non basate su chiave API.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az ml connection update

Anteprima

Il gruppo di comandi 'ml connection' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiornare una connessione.

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

Esempio

aggiornare una connessione da un file di specifica YAML.

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

Parametri necessari

--name -n

Nome dell'ambiente.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--workspace-name -w

Nome dell'area di lavoro di Azure ML. È possibile configurare l'area di lavoro predefinita usando az configure --defaults workspace=<name>.

Parametri facoltativi

--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, string or JSON string>.

valore predefinito: []
--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

valore predefinito: False
--populate-secrets -p

Per le connessioni basate su chiave API, provare a popolare le credenziali restituite con il valore del segreto effettivo. Non esegue alcuna operazione per le connessioni non basate su chiave API.

valore predefinito: False
--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove> OR --remove propertyToRemove.

valore predefinito: []
--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=<value>.

valore predefinito: []
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.