Guida introduttiva: Eseguire una query di Resource Graph con l'interfaccia della riga di comando di Azure

Articolo
07/08/2024

Questa guida introduttiva descrive come eseguire una query di Azure Resource Graph usando l'interfaccia della riga di comando di Azure e l'estensione Resource Graph. L'articolo illustra anche come ordinare (ordinare) e limitare i risultati della query. È possibile eseguire una query per le risorse nel tenant, nei gruppi di gestione o nelle sottoscrizioni. Al termine, è possibile rimuovere l'estensione.

Prerequisiti

Se non si ha un account Azure, creare un account gratuito prima di iniziare.
L'interfaccia della riga di comando di Azure deve essere versione 2.22.0 o successiva per l'estensione Resource Graph.
Ambiente della shell Bash in cui è possibile eseguire i comandi dell'interfaccia della riga di comando di Azure. Ad esempio, Git Bash in una sessione del terminale di Visual Studio Code .

Installare l'estensione

Per abilitare l'interfaccia della riga di comando di Azure per eseguire query sulle risorse usando Azure Resource Graph, è necessario installare l'estensione Resource Graph. La prima volta che si esegue una query con az graph un prompt viene visualizzato per installare l'estensione. In caso contrario, seguire questa procedura per eseguire un'installazione manuale.

Elencare le estensioni e le versioni disponibili:
```
az extension list-available --output table
```
Installare l'estensione :
```
az extension add --name resource-graph
```
Verificare che l'estensione sia stata installata:
```
az extension list --output table
```
Visualizzare la sintassi dell'estensione:
```
az graph query --help
```
Per altre informazioni sulle estensioni dell'interfaccia della riga di comando di Azure, vedere Usare e gestire le estensioni con l'interfaccia della riga di comando di Azure.

Connect to Azure

Da una sessione del terminale di Visual Studio Code connettersi ad Azure. Se si dispone di più sottoscrizioni, eseguire i comandi per impostare il contesto sulla sottoscrizione. Sostituire <subscriptionID> con l'ID della sottoscrizione di Azure.

az login

# Run these commands if you have multiple subscriptions
az account list --output table
az account set --subscription <subscriptionID>

Eseguire una query

Dopo aver aggiunto l'estensione dell'interfaccia della riga di comando di Azure all'ambiente, è possibile eseguire una query basata su tenant. La query in questo esempio restituisce cinque risorse di Azure con name e type di ogni risorsa. Per eseguire query in base gruppo di gestione o sottoscrizione, usare gli argomenti --management-groups o --subscriptions.

Eseguire una query di Azure Resource Graph:
```
az graph query --graph-query 'Resources | project name, type | limit 5'
```
Questo esempio di query non usa un modificatore di ordinamento come order by. Se si esegue la query più volte, potrebbe restituire un set diverso di risorse per ogni richiesta.
Aggiornare la query applicando order by alla proprietà name:
```
az graph query --graph-query 'Resources | project name, type | limit 5 | order by name asc'
```
Analogamente alla query precedente, se si esegue questa query più volte, potrebbe restituire un set diverso di risorse per ogni richiesta. L'ordine dei comandi della query è importante. In questo esempio order by segue limit. La query limita i risultati a cinque risorse e quindi ordina i risultati in base al nome.
Aggiornare la query per order by la proprietà name e quindi limit l'output a cinque risultati:
```
az graph query --graph-query 'Resources | project name, type | order by name asc | limit 5'
```
Se questa query viene eseguita più volte senza modifiche all'ambiente, i risultati sono coerenti e ordinati in base alla proprietà name, ma sono comunque limitati a cinque risultati. La query ordina i risultati in base al nome e quindi limita l'output a cinque risorse.

Pulire le risorse

Per rimuovere l'estensione Resource Graph, eseguire il comando seguente:

az extension remove --name resource-graph

Per disconnettersi dalla sessione dell'interfaccia della riga di comando di Azure:

az logout

Passaggi successivi

In questo argomento di avvio rapido sono state eseguite query di Azure Resource Graph usando l'estensione per l'interfaccia della riga di comando di Azure. Per altre informazioni sul linguaggio di Resource Graph, passare alla pagina dei dettagli del linguaggio di query.

Informazioni sul linguaggio di query di Azure Resource Graph

Condividi tramite