Condividi tramite


az ml service

Nota

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

Gestire i servizi operativi.

Comandi

Nome Descrizione Tipo Stato
az ml service delete

Eliminare un servizio dall'area di lavoro.

Estensione Disponibilità generale
az ml service get-access-token

Ottenere un token per inviare richieste a un servizio.

Estensione Disponibilità generale
az ml service get-keys

Ottenere le chiavi per inviare richieste a un servizio.

Estensione Disponibilità generale
az ml service get-logs

Ottenere i log per un servizio.

Estensione Disponibilità generale
az ml service list

Elencare i servizi nell'area di lavoro.

Estensione Disponibilità generale
az ml service regen-key

Rigenerare le chiavi per un servizio.

Estensione Disponibilità generale
az ml service run

Eseguire un servizio nell'area di lavoro.

Estensione Disponibilità generale
az ml service show

Visualizzare i dettagli per un servizio nell'area di lavoro.

Estensione Disponibilità generale
az ml service update

Aggiornare un servizio nell'area di lavoro.

Estensione Disponibilità generale

az ml service delete

Eliminare un servizio dall'area di lavoro.

az ml service delete --name
                     [--path]
                     [--resource-group]
                     [--subscription-id]
                     [--workspace-name]
                     [-v]

Parametri necessari

--name -n

Nome del servizio da eliminare.

Parametri facoltativi

--path

Percorso di una cartella del progetto. Impostazione predefinita: directory corrente.

--resource-group -g

Gruppo di risorse corrispondente all'area di lavoro specificata.

--subscription-id

Specifica l'ID sottoscrizione.

--workspace-name -w

Nome dell'area di lavoro contenente il servizio da eliminare.

-v

Flag di dettaglio.

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 service get-access-token

Ottenere un token per inviare richieste a un servizio.

az ml service get-access-token --name
                               [--path]
                               [--resource-group]
                               [--subscription-id]
                               [--workspace-name]
                               [-v]

Parametri necessari

--name -n

Service Name.

Parametri facoltativi

--path

Percorso di una cartella del progetto. Impostazione predefinita: directory corrente.

--resource-group -g

Gruppo di risorse corrispondente all'area di lavoro specificata.

--subscription-id

Specifica l'ID sottoscrizione.

--workspace-name -w

Nome dell'area di lavoro contenente il servizio da visualizzare.

-v

Flag di dettaglio.

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 service get-keys

Ottenere le chiavi per inviare richieste a un servizio.

az ml service get-keys --name
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]
                       [-v]

Parametri necessari

--name -n

Service Name.

Parametri facoltativi

--path

Percorso di una cartella del progetto. Impostazione predefinita: directory corrente.

--resource-group -g

Gruppo di risorse corrispondente all'area di lavoro specificata.

--subscription-id

Specifica l'ID sottoscrizione.

--workspace-name -w

Nome dell'area di lavoro contenente il servizio da visualizzare.

-v

Flag di dettaglio.

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 service get-logs

Ottenere i log per un servizio.

az ml service get-logs --name
                       [--init]
                       [--num_lines]
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]
                       [-v]

Parametri necessari

--name -n

Service Name.

Parametri facoltativi

--init -i

Ottenere i log del contenitore init anziché il contenitore di assegnazione dei punteggi.

valore predefinito: False
--num_lines -l

Numero di righe di log da restituire dalla parte finale (il valore predefinito è 5000).

valore predefinito: 5000
--path

Percorso di una cartella del progetto. Impostazione predefinita: directory corrente.

--resource-group -g

Gruppo di risorse corrispondente all'area di lavoro specificata.

--subscription-id

Specifica l'ID sottoscrizione.

--workspace-name -w

Nome dell'area di lavoro contenente il servizio da visualizzare.

-v

Flag di dettaglio.

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

Elencare i servizi nell'area di lavoro.

az ml service list [--compute-type]
                   [--image-digest]
                   [--model-id]
                   [--model-name]
                   [--path]
                   [--property]
                   [--resource-group]
                   [--subscription-id]
                   [--tag]
                   [--workspace-name]
                   [-v]

Parametri facoltativi

--compute-type -c

Se specificato, mostrerà solo i servizi con il tipo di calcolo specificato. Le opzioni sono 'ACI', 'servizio Azure Kubernetes'.

--image-digest

Se specificato, mostrerà solo i servizi con il digest dell'immagine specificato.

--model-id

Se specificato, mostrerà solo i servizi con l'ID modello specificato.

--model-name

Se specificato, mostrerà solo i servizi con il nome del modello specificato.

--path

Percorso di una cartella del progetto. Impostazione predefinita: directory corrente.

--property

Se specificato, filtra in base alla chiave/valore specificata (e.g. key o key=value). È possibile specificare più proprietà con più opzioni --property.

valore predefinito: []
--resource-group -g

Gruppo di risorse corrispondente all'area di lavoro specificata.

--subscription-id

Specifica l'ID sottoscrizione.

--tag

Se specificato, filtra in base alla chiave/valore specificata (e.g. key o key=value). È possibile specificare più tag con più opzioni --tag.

valore predefinito: []
--workspace-name -w

Nome dell'area di lavoro contenente i servizi da elencare.

-v

Flag di dettaglio.

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 service regen-key

Rigenerare le chiavi per un servizio.

az ml service regen-key --key
                        --name
                        [--path]
                        [--resource-group]
                        [--set-key]
                        [--subscription-id]
                        [--workspace-name]
                        [-v]

Parametri necessari

--key -k

Chiave da rigenerare, se si specifica regen. Opzioni: primario, secondario.

--name -n

Service Name.

Parametri facoltativi

--path

Percorso di una cartella del progetto. Impostazione predefinita: directory corrente.

--resource-group -g

Gruppo di risorse corrispondente all'area di lavoro specificata.

--set-key -s

Specificare il valore di autenticazione per la chiave specificata.

--subscription-id

Specifica l'ID sottoscrizione.

--workspace-name -w

Nome dell'area di lavoro contenente il servizio da visualizzare.

-v

Flag di dettaglio.

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

Eseguire un servizio nell'area di lavoro.

az ml service run --name
                  [--input-data]
                  [--path]
                  [--resource-group]
                  [--subscription-id]
                  [--workspace-name]
                  [-v]

Parametri necessari

--name -n

Nome del servizio rispetto a cui assegnare un punteggio.

Parametri facoltativi

--input-data -d

Dati da usare per chiamare il servizio Web.

--path

Percorso di una cartella del progetto. Impostazione predefinita: directory corrente.

--resource-group -g

Gruppo di risorse corrispondente all'area di lavoro specificata.

--subscription-id

Specifica l'ID sottoscrizione.

--workspace-name -w

Nome dell'area di lavoro contenente il servizio da eseguire.

-v

Flag di dettaglio.

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

Visualizzare i dettagli per un servizio nell'area di lavoro.

az ml service show --name
                   [--path]
                   [--resource-group]
                   [--subscription-id]
                   [--workspace-name]
                   [-v]

Parametri necessari

--name -n

Nome del servizio Web da visualizzare.

Parametri facoltativi

--path

Percorso di una cartella del progetto. Impostazione predefinita: directory corrente.

--resource-group -g

Gruppo di risorse corrispondente all'area di lavoro specificata.

--subscription-id

Specifica l'ID sottoscrizione.

--workspace-name -w

Nome dell'area di lavoro contenente il servizio da visualizzare.

-v

Flag di dettaglio.

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

Aggiornare un servizio nell'area di lavoro.

az ml service update --name
                     [--add-property]
                     [--add-tag]
                     [--ae]
                     [--ai]
                     [--ar]
                     [--as]
                     [--at]
                     [--autoscale-max-replicas]
                     [--autoscale-min-replicas]
                     [--base-image]
                     [--base-image-registry]
                     [--cc]
                     [--ccl]
                     [--cf]
                     [--collect-model-data]
                     [--compute-target]
                     [--cuda-version]
                     [--dc]
                     [--description]
                     [--dn]
                     [--ds]
                     [--ed]
                     [--eg]
                     [--entry-script]
                     [--environment-name]
                     [--environment-version]
                     [--failure-threshold]
                     [--gb]
                     [--gbl]
                     [--gc]
                     [--ic]
                     [--id]
                     [--is-migration]
                     [--kp]
                     [--ks]
                     [--lo]
                     [--max-request-wait-time]
                     [--model]
                     [--model-metadata-file]
                     [--no-wait]
                     [--nr]
                     [--path]
                     [--period-seconds]
                     [--po]
                     [--remove-tag]
                     [--replica-max-concurrent-requests]
                     [--resource-group]
                     [--rt]
                     [--sc]
                     [--scoring-timeout-ms]
                     [--sd]
                     [--se]
                     [--sk]
                     [--sp]
                     [--st]
                     [--subscription-id]
                     [--timeout-seconds]
                     [--token-auth-enabled]
                     [--workspace-name]
                     [-v]

Parametri necessari

--name -n

Nome del servizio da aggiornare.

Parametri facoltativi

--add-property

Proprietà chiave/valore da aggiungere (e.g. key=value ). È possibile specificare più proprietà con più opzioni --add-property.

valore predefinito: []
--add-tag

Tag chiave/valore da aggiungere (e.g. key=value ). È possibile specificare più tag con più opzioni --add-tag.

valore predefinito: []
--ae --auth-enabled

Indica se abilitare o meno l'autenticazione della chiave per questo servizio Web. Il valore predefinito è False.

--ai --enable-app-insights

Indica se abilitare o meno AppInsights per questo servizio Web. Il valore predefinito è False.

--ar --autoscale-refresh-seconds

Frequenza con cui il ridimensionamento automatico deve tentare di ridimensionare questo servizio Web. Assume il valore predefinito 1.

--as --autoscale-enabled

Indica se abilitare o meno la scalabilità automatica per questo servizio Web. L'impostazione predefinita è True se num_replicas è Nessuno.

--at --autoscale-target-utilization

L'utilizzo di destinazione (in percentuale su 100) del ridimensionamento automatico deve tentare di mantenere per questo servizio Web. Il valore predefinito è 70.

--autoscale-max-replicas --ma

Numero massimo di contenitori da usare per la scalabilità automatica di questo servizio Web. Il valore predefinito è 10.

--autoscale-min-replicas --mi

Numero minimo di contenitori da usare per la scalabilità automatica di questo servizio Web. Assume il valore predefinito 1.

--base-image --bi

Immagine personalizzata da usare come immagine di base. Se non viene specificata alcuna immagine di base, l'immagine di base verrà usata in base al parametro di runtime specificato.

--base-image-registry --ir

Registro immagini che contiene l'immagine di base.

--cc --cpu-cores

Numero di core cpu da allocare per questo servizio Web. Può essere un decimale. Il valore predefinito è 0.1.

--ccl --cpu-cores-limit

È consentito usare il numero massimo di core CPU per questo servizio Web. Può essere un decimale.

--cf --conda-file

Percorso del file locale contenente una definizione di ambiente conda da usare per l'immagine.

--collect-model-data --md

Indica se abilitare o meno la raccolta dei dati del modello per questo servizio Web. Il valore predefinito è False.

--compute-target

(Anteprima) Specifica la destinazione di calcolo con l'estensione AzureML installata per ospitare l'endpoint online e la distribuzione di Kubernetes migrati.

--cuda-version --cv

Versione di CUDA da installare per le immagini che necessitano del supporto GPU. L'immagine GPU deve essere usata nei servizi di Microsoft Azure, ad esempio Istanze di Azure Container, calcolo di Azure Machine Learning, Macchine virtuali di Azure e servizio Azure Kubernetes. Le versioni supportate sono 9.0, 9.1 e 10.0. Se 'enable_gpu' è impostato, il valore predefinito è '9.1'.

--dc --deploy-config-file

Percorso di un file JSON contenente i metadati di distribuzione.

--description -d

Descrizione del servizio

--dn --dns-name-label

Nome dns per questo servizio Web.

--ds --extra-docker-file-steps

Percorso del file locale contenente passaggi docker aggiuntivi da eseguire durante la configurazione dell'immagine.

--ed --environment-directory

Directory per l'ambiente di Azure Machine Learning per la distribuzione. È lo stesso percorso della directory fornito nel comando 'az ml environment scaffold'.

--eg --enable-gpu

Indica se abilitare o meno il supporto GPU nell'immagine. L'immagine GPU deve essere usata nei servizi di Microsoft Azure, ad esempio Istanze di Azure Container, calcolo di Azure Machine Learning, Macchine virtuali di Azure e servizio Azure Kubernetes. Il valore predefinito è False.

--entry-script --es

Percorso del file locale che contiene il codice da eseguire per il servizio (percorso relativo da source_directory se disponibile).

--environment-name -e

Nome dell'ambiente di Azure Machine Learning per la distribuzione.

--environment-version --ev

Versione di un ambiente di Azure Machine Learning esistente per la distribuzione.

--failure-threshold --ft

All'avvio di un pod e il probe di attività ha esito negativo, Kubernetes proverà --failure-threshold times prima di rinunciare. Il valore predefinito è 3. Il valore minimo è 1.

--gb --memory-gb

Quantità di memoria (in GB) da allocare per questo servizio Web. Può essere un decimale.

--gbl --memory-gb-limit

La quantità massima di memoria (in GB) consentita per questo servizio Web. Può essere un decimale.

--gc --gpu-cores

Numero di core GPU da allocare per questo servizio Web. Il valore predefinito è 1.

--ic --inference-config-file

Percorso di un file JSON o YAML contenente la configurazione dell'inferenza.

--id --initial-delay-seconds

Il numero di secondi dopo l'avvio del contenitore prima che vengano avviati i probe di attività. Il valore predefinito è 310.

--is-migration

(Anteprima) Indica se eseguire o meno la migrazione del servizio Web del servizio Azure Kubernetes all'endpoint e alla distribuzione online di Kubernetes. Il valore predefinito è False.

--kp --primary-key

Chiave di autenticazione primaria da usare per questo servizio Web.

--ks --secondary-key

Chiave di autenticazione secondaria da usare per questo servizio Web.

--lo --location

L'area di Azure in cui distribuire questo servizio Web. Se non specificata, verrà usata la località dell'area di lavoro. Altri dettagli sulle aree disponibili sono disponibili qui: https://azure.microsoft.com/en-us/global-infrastructure/services/?regions=all& products=container-instances.

--max-request-wait-time --mr

La quantità massima di tempo per cui una richiesta rimarrà nella coda (in millisecondi) prima di restituire un errore 503. Il valore predefinito è 500.

--model -m

ID del modello da distribuire. È possibile specificare più modelli con argomenti -m aggiuntivi. I modelli devono essere registrati per primi.

valore predefinito: []
--model-metadata-file -f

Percorso di un file JSON contenente i metadati di registrazione del modello. È possibile fornire più modelli usando più parametri -f.

valore predefinito: []
--no-wait

Flag per non attendere le chiamate asincrone.

--nr --num-replicas

Numero di contenitori da allocare per questo servizio Web. Nessun valore predefinito, se questo parametro non è impostato, l'utilità di scalabilità automatica è abilitata per impostazione predefinita.

--path

Percorso di una cartella del progetto. Impostazione predefinita: directory corrente.

--period-seconds --ps

La frequenza (in secondi) con cui eseguire il probe di attività. Il valore predefinito è 10 secondi. Il valore minimo è 1.

--po --port

La porta locale su cui esporre l'endpoint HTTP del servizio.

--remove-tag

Chiave del tag da rimuovere. È possibile specificare più tag con più opzioni --remove-tag.

valore predefinito: []
--replica-max-concurrent-requests --rm

Numero massimo di richieste simultanee per nodo da consentire per questo servizio Web. Assume il valore predefinito 1.

--resource-group -g

Gruppo di risorse corrispondente all'area di lavoro specificata.

--rt --runtime

Quale runtime usare per l'immagine. I runtime attualmente supportati sono "spark-py" e "python'spark-py|python|python-slim.

--sc --ssl-cname

Cname per se SSL è abilitato. Applicabile solo quando si aggiorna un servizio ACI.

--scoring-timeout-ms --tm

Timeout da applicare per l'assegnazione dei punteggi alle chiamate a questo servizio Web. Il valore predefinito è 60000.

--sd --source-directory

Percorso delle cartelle che contengono tutti i file per creare l'immagine.

--se --ssl-enabled

Indica se abilitare o meno SSL per questo servizio Web. Il valore predefinito è False.

--sk --ssl-key-pem-file

File di chiave necessario se SSL è abilitato.

--sp --ssl-cert-pem-file

File di certificato necessario se SSL è abilitato.

--st --success-threshold

Il numero minimo di successi consecutivi perché il probe di attività venga considerato riuscito dopo un errore. Assume il valore predefinito 1. Il valore minimo è 1.

--subscription-id

Specifica l'ID sottoscrizione.

--timeout-seconds --ts

Numero di secondi dopo il quale si verifica il timeout del probe di attività. Il valore predefinito è 2 secondi. Il valore minimo è 1.

--token-auth-enabled

Indica se abilitare o meno l'autenticazione del token per questo servizio Web. Disponibile solo per i servizi Web del servizio Azure Kubernetes. Il valore predefinito è False.

--workspace-name -w

Nome dell'area di lavoro contenente il servizio da aggiornare.

-v

Flag di dettaglio.

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.