Condividi tramite

az ml batch-deployment

  • 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 batch-deployment. Altre sulle estensioni.

Gestire le distribuzioni batch di Azure ML.

Le distribuzioni di Azure ML offrono un'interfaccia semplice per la creazione e la gestione delle distribuzioni di modelli.

Comandi

Nome Descrizione Tipo Status
az ml batch-deployment create

Creare una distribuzione. Se la distribuzione esiste già, verrà sovrascritta con le nuove impostazioni.

 Estensione GA
az ml batch-deployment delete

Eliminare una distribuzione.

 Estensione GA
az ml batch-deployment list

Elencare le distribuzioni.

 Estensione GA
az ml batch-deployment list-jobs

Elencare i processi di assegnazione dei punteggi batch per una distribuzione batch.

 Estensione GA
az ml batch-deployment show

Visualizzare una distribuzione.

 Estensione GA
az ml batch-deployment update

Aggiornare una distribuzione.

 Estensione GA

az ml batch-deployment create

Creare una distribuzione. Se la distribuzione esiste già, verrà sovrascritta con le nuove impostazioni.

az ml batch-deployment create --file
                              --resource-group
                              --workspace-name
                              [--endpoint-name]
                              [--name]
                              [--no-wait]
                              [--set]
                              [--set-default]
                              [--skip-script-validation]

Esempio

Creare una distribuzione da un file di specifica YAML

az ml batch-deployment create --file deployment.yaml --resource-group my-resource-group --workspace-name my-workspace

Parametri necessari

--file -f

Percorso locale del file YAML contenente la specifica di distribuzione batch di Azure ML. La documentazione di riferimento YAML per la distribuzione batch è disponibile in: https://aka.ms/ml-cli-v2-deployment-batch-yaml-reference.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando 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

--endpoint-name -e

Nome dell'endpoint batch.

--name -n

Nome della distribuzione.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata. Il valore predefinito è False.

Valore predefinito: False
--set

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

--set-default

Imposta l'endpoint defaults.deployment_name su questa distribuzione dopo la corretta creazione, non funziona con --no-wait.

Valore predefinito: False
--skip-script-validation

Consente all'utente di ignorare la convalida dello script di assegnazione dei punteggi della distribuzione.

Valore predefinito: False
Parametri globali
--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az ml batch-deployment delete

Eliminare una distribuzione.

az ml batch-deployment delete --endpoint-name
                              --name
                              --resource-group
                              --workspace-name
                              [--no-wait]
                              [--yes]

Esempio

Eliminare una distribuzione con conferma

az ml batch-deployment delete --name my-deployment --endpoint-name my-endpoint --yes --resource-group my-resource-group --workspace-name my-workspace

Parametri necessari

--endpoint-name -e

Nome dell'endpoint batch.

--name -n

Nome della distribuzione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando 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

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata. Il valore predefinito è False.

Valore predefinito: False
--yes -y

Non richiedere conferma.

Valore predefinito: False
Parametri globali
--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az ml batch-deployment list

Elencare le distribuzioni.

az ml batch-deployment list --endpoint-name
                            --resource-group
                            --workspace-name

Esempio

Elencare la distribuzione in un endpoint

az ml batch-deployment list --endpoint-name my-endpoint --resource-group my-resource-group --workspace-name my-workspace

Parametri necessari

--endpoint-name -e

Nome dell'endpoint.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando 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 globali
--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az ml batch-deployment list-jobs

Elencare i processi di assegnazione dei punteggi batch per una distribuzione batch.

az ml batch-deployment list-jobs --endpoint-name
                                 --name
                                 --resource-group
                                 --workspace-name

Esempio

Elencare i processi di assegnazione dei punteggi batch per una distribuzione specifica

az ml batch-deployment list-jobs --name my-batch-endpoint --endpoint-name my-endpoint --resource-group my-resource-group --workspace-name my-workspace

Parametri necessari

--endpoint-name -e

Nome dell'endpoint batch.

--name -n

Nome della distribuzione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando 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 globali
--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az ml batch-deployment show

Visualizzare una distribuzione.

az ml batch-deployment show --endpoint-name
                            --name
                            --resource-group
                            --workspace-name

Esempio

Visualizzare una distribuzione

az ml batch-deployment show --name my-deployment --endpoint-name my-endpoint --resource-group my-resource-group --workspace-name my-workspace

Parametri necessari

--endpoint-name -e

Nome dell'endpoint batch.

--name -n

Nome della distribuzione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando 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 globali
--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az ml batch-deployment update

Aggiornare una distribuzione.

az ml batch-deployment update --resource-group
                              --workspace-name
                              [--add]
                              [--endpoint-name]
                              [--file]
                              [--force-string]
                              [--name]
                              [--no-wait]
                              [--remove]
                              [--set]

Esempio

Aggiornare una distribuzione da un file di specifica YAML

az ml batch-deployment update --file deployment.yaml --resource-group my-resource-group --workspace-name my-workspace

Parametri necessari

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando 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: []
--endpoint-name -e

Nome dell'endpoint batch.

--file -f

Percorso locale del file YAML contenente la specifica di distribuzione batch di Azure ML. La documentazione di riferimento YAML per la distribuzione batch è disponibile in: https://aka.ms/ml-cli-v2-deployment-batch-yaml-reference.

--force-string

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

Valore predefinito: False
--name -n

Nome della distribuzione.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata. Il valore predefinito è False.

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

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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