az graph

Riferimento

Nota

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

Eseguire query sulle risorse gestite da Azure Resource Manager.

Eseguire "az graph query --help" per ottenere informazioni dettagliate.

Comandi

Nome	Descrizione	Tipo	Status
az graph query	Eseguire query sulle risorse gestite da Azure Resource Manager.	Estensione	GA
az graph shared-query	Gestire una query condivisa di Azure Resource Graph.	Estensione	Sperimentale
az graph shared-query create	Creare una query condivisa.	Estensione	Sperimentale
az graph shared-query delete	Eliminare una query condivisa.	Estensione	Sperimentale
az graph shared-query list	Elencare tutte le query condivise in un gruppo di risorse.	Estensione	Sperimentale
az graph shared-query show	Visualizzare le proprietà di una query condivisa.	Estensione	Sperimentale

az graph query

Eseguire query sulle risorse gestite da Azure Resource Manager.

Per altre informazioni sul linguaggio di query e sugli esempi di esplorazione, vedere https://aka.ms/AzureResourceGraph-QueryLanguage.

az graph query --graph-query --q
               [--allow-partial-scopes {false, true}]
               [--first]
               [--management-groups]
               [--skip]
               [--skip-token]
               [--subscriptions]

Esempio

Eseguire query su risorse che richiedono un subset di campi delle risorse.

az graph query -q "project id, name, type, location, tags"

Eseguire query su risorse con selezione dei campi, filtro e riepilogo.

az graph query -q "project id, type, location | where type =~ 'Microsoft.Compute/virtualMachines' | summarize count() by location | top 3 by count_"

Richiedere un subset di risultati, ignorando 20 elementi e ottenendo i successivi 10.

az graph query -q "where type =~ "Microsoft.Compute" | project name, tags" --first 10 --skip 20

Scegliere le sottoscrizioni da eseguire per la query.

az graph query -q "where type =~ "Microsoft.Compute" | project name, tags" --subscriptions 11111111-1111-1111-1111-111111111111 22222222-2222-2222-2222-222222222222

Scegliere i gruppi di gestione su cui eseguire query.

az graph query -q "where type =~ "Microsoft.Compute" | project name, tags" --management-groups aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb --allow-partial-scopes

Eseguire una query con il token skip.

az graph query -q "where type =~ "Microsoft.Compute" | project name, tags" --skip-token skip_token_value_from_previous_query_response

Parametri necessari

--graph-query --q -q

Query di Resource Graph da eseguire.

Parametri facoltativi

--allow-partial-scopes -a

Indica se la query deve avere esito positivo quando è possibile elaborare solo un numero parziale di sottoscrizioni da parte del server.

Valori accettati: false, true

Valore predefinito: False

--first

Numero massimo di oggetti da restituire. Intervallo accettato: 1-1000.

--management-groups -m

Elenco di gruppi di gestione su cui eseguire query.

--skip

Ignora i primi N oggetti e quindi ottiene gli oggetti rimanenti.

--skip-token

Ignorare il token per ottenere la pagina successiva della query, se applicabile.

--subscriptions -s

Elenco di sottoscrizioni su cui eseguire query. Per impostazione predefinita, vengono eseguite query su tutte le sottoscrizioni accessibili.

Parametri globali

--debug

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

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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