az discovery tool

Note

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

Gestire gli strumenti.

Comandi

Nome	Descrizione	Tipo	Status
az discovery tool create	Creare uno strumento.	Extension	GA
az discovery tool delete	Eliminare uno strumento.	Extension	GA
az discovery tool list	Elencare le risorse dello strumento in base all'ID sottoscrizione.	Extension	GA
az discovery tool show	Ottenere uno strumento.	Extension	GA
az discovery tool update	Aggiornare uno strumento.	Extension	GA
az discovery tool wait	Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.	Extension	GA

az discovery tool create

Creare uno strumento.

az discovery tool create --name --tool-name
                         --resource-group
                         [--acquire-policy-token]
                         [--change-reference]
                         [--definition-content]
                         [--environment-variables]
                         [--location]
                         [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                         [--tags]
                         [--version]

Esempio

Creare uno strumento dal contenuto della definizione inline.

az discovery tool create --resource-group MyResourceGroup --name MyTool --location eastus --version 1.0.0 --definition-content '{"name":"mytool","description":"Utility tool","version":"1.0.0","category":"testing","infra":[{"infra_type":"container","name":"worker","image":{"acr":"myregistry.azurecr.io/mytool:1.0.0"},"compute":{"min_resources":{"cpu":"1","ram":"2Gi","gpu":"0","storage":"0"},"max_resources":{"cpu":"2","ram":"4Gi","storage":"0"},"recommended_sku":["Standard_D4s_v6"],"pool_type":"static","pool_size":1}}]}'

Parametri necessari

--name --tool-name -n

Nome dello strumento.

--resource-group -g

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà	Valore
Gruppo di parametri:	Global Policy Arguments

--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà	Valore
Gruppo di parametri:	Global Policy Arguments

--definition-content

Contenuto JSON per la definizione di una risorsa Support shorthand-syntax, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà	Valore
Gruppo di parametri:	Properties Arguments

--environment-variables

Variabili di ambiente per rendere disponibile supporto sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà	Valore
Gruppo di parametri:	Properties Arguments

--location -l

Posizione geografica in cui si trova la risorsa Se non specificato, verrà usata la posizione del gruppo di risorse.

Proprietà	Valore
Gruppo di parametri:	Resource Arguments

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà	Valore
Valori accettati:	0, 1, f, false, n, no, t, true, y, yes

--tags

Tag delle risorse. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà	Valore
Gruppo di parametri:	Resource Arguments

--version

Versione di una definizione di risorsa.

Proprietà	Valore
Gruppo di parametri:	Properties Arguments

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--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 log di debug completi.

Proprietà	Valore
Valore predefinito:	False

az discovery tool delete

Eliminare uno strumento.

az discovery tool delete [--acquire-policy-token]
                         [--change-reference]
                         [--ids]
                         [--name --tool-name]
                         [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                         [--resource-group]
                         [--subscription]
                         [--yes]

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà	Valore
Gruppo di parametri:	Global Policy Arguments

--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà	Valore
Gruppo di parametri:	Global Policy Arguments

--ids

Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--name --tool-name -n

Nome dello strumento.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà	Valore
Valori accettati:	0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

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

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--subscription

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

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--yes -y

Non richiedere conferma.

Proprietà	Valore
Valore predefinito:	False

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

az discovery tool list

Elencare le risorse dello strumento in base all'ID sottoscrizione.

az discovery tool list [--max-items]
                       [--next-token]
                       [--resource-group]

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--max-items

Numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è maggiore del valore specificato, nell'output del comando viene fornito un token. Per riprendere la paginazione, specificare il valore del token in --next-token argomento di un comando successivo.

Proprietà	Valore
Gruppo di parametri:	Pagination Arguments

--next-token

Token per specificare dove iniziare la paginazione. Si tratta del valore del token di una risposta troncata in precedenza.

Proprietà	Valore
Gruppo di parametri:	Pagination Arguments

--resource-group -g

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

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--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 log di debug completi.

Proprietà	Valore
Valore predefinito:	False

az discovery tool show

Ottenere uno strumento.

az discovery tool show [--ids]
                       [--name --tool-name]
                       [--resource-group]
                       [--subscription]

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--ids

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--name --tool-name -n

Nome dello strumento.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--resource-group -g

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

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--subscription

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

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

az discovery tool update

Aggiornare uno strumento.

az discovery tool update [--acquire-policy-token]
                         [--add]
                         [--change-reference]
                         [--definition-content]
                         [--environment-variables]
                         [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                         [--ids]
                         [--name --tool-name]
                         [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                         [--remove]
                         [--resource-group]
                         [--set]
                         [--subscription]
                         [--tags]
                         [--version]

Esempio

Aggiornare la versione di uno strumento.

az discovery tool update --resource-group MyResourceGroup --name MyTool --version 2.0.0

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà	Valore
Gruppo di parametri:	Global Policy Arguments

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

Proprietà	Valore
Gruppo di parametri:	Generic Update Arguments

--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà	Valore
Gruppo di parametri:	Global Policy Arguments

--definition-content

Contenuto JSON per la definizione di una risorsa Support shorthand-syntax, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà	Valore
Gruppo di parametri:	Properties Arguments

--environment-variables

Variabili di ambiente per rendere disponibile supporto sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà	Valore
Gruppo di parametri:	Properties Arguments

--force-string

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

Proprietà	Valore
Gruppo di parametri:	Generic Update Arguments
Valori accettati:	0, 1, f, false, n, no, t, true, y, yes

--ids

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--name --tool-name -n

Nome dello strumento.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà	Valore
Valori accettati:	0, 1, f, false, n, no, t, true, y, yes

--remove

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

Proprietà	Valore
Gruppo di parametri:	Generic Update Arguments

--resource-group -g

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

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--set

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

Proprietà	Valore
Gruppo di parametri:	Generic Update Arguments

--subscription

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

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--tags

Tag delle risorse. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà	Valore
Gruppo di parametri:	Resource Arguments

--version

Versione di una definizione di risorsa.

Proprietà	Valore
Gruppo di parametri:	Properties Arguments

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

az discovery tool wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

az discovery tool wait [--acquire-policy-token]
                       [--change-reference]
                       [--created]
                       [--custom]
                       [--deleted]
                       [--exists]
                       [--ids]
                       [--interval]
                       [--name --tool-name]
                       [--resource-group]
                       [--subscription]
                       [--timeout]
                       [--updated]

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà	Valore
Gruppo di parametri:	Global Policy Arguments

--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà	Valore
Gruppo di parametri:	Global Policy Arguments

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

Proprietà	Valore
Gruppo di parametri:	Wait Condition Arguments
Valore predefinito:	False

--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Proprietà	Valore
Gruppo di parametri:	Wait Condition Arguments

--deleted

Attendere l'eliminazione.

Proprietà	Valore
Gruppo di parametri:	Wait Condition Arguments
Valore predefinito:	False

--exists

Attendere che la risorsa esista.

Proprietà	Valore
Gruppo di parametri:	Wait Condition Arguments
Valore predefinito:	False

--ids

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--interval

Intervallo di polling in secondi.

Proprietà	Valore
Gruppo di parametri:	Wait Condition Arguments
Valore predefinito:	30

--name --tool-name -n

Nome dello strumento.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--resource-group -g

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

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--subscription

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

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--timeout

Attesa massima in secondi.

Proprietà	Valore
Gruppo di parametri:	Wait Condition Arguments
Valore predefinito:	3600

--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

Proprietà	Valore
Gruppo di parametri:	Wait Condition Arguments
Valore predefinito:	False

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

Commenti e suggerimenti

Questa pagina è stata utile?