Avvio rapido: Creare una query condivisa di Resource Graph usando l'interfaccia della riga di comando di Azure

Articolo
12/04/2024

Questa guida introduttiva descrive come creare una query condivisa di Azure Resource Graph con l'interfaccia della riga di comando di Azure e l'estensione Resource Graph. I comandi az graph shared-query sono una funzionalità sperimentale di az graph query.

Una query condivisa può essere eseguita dall'interfaccia della riga di comando di Azure con i comandi della funzionalità sperimentale oppure è possibile eseguire la query condivisa dal portale di Azure. Una query condivisa è un oggetto Azure Resource Manager a cui è possibile concedere autorizzazioni o che è possibile eseguire in Azure Resource Graph Explorer. Al termine, è possibile rimuovere l'estensione Resource Graph.

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>

Creare una query condivisa

Creare un gruppo di risorse e un oggetto condiviso che riepiloga il conteggio di tutte le risorse raggruppate in base alla posizione.

Creare un gruppo di risorse per archiviare la query condivisa di Azure Resource Graph.
```
az group create --name "demoSharedQuery" --location westus2
```

Creare la query condivisa.

az graph shared-query create --name "Summarize resources by location" \
  --description "This shared query summarizes resources by location for a pinnable map graphic." \
  --graph-query "Resources | summarize count() by location" \
  --resource-group demoSharedQuery

Elencare tutte le query condivise nel gruppo di risorse.

az graph shared-query list --resource-group demoSharedQuery

Limitare i risultati a una query condivisa specifica.

az graph shared-query show --resource-group "demoSharedQuery" \
  --name "Summarize resources by location"

Eseguire la query condivisa

È possibile usare la sintassi della funzionalità sperimentale dell'interfaccia della riga di comando di Azure o il portale di Azure per eseguire la query condivisa.

Usare la funzionalità sperimentale per eseguire query condivise

Eseguire la query condivisa nell'interfaccia della riga di comando di Azure con la sintassi {{shared-query-uri}} in un comando az graph query. Si ottiene l'ID risorsa della query condivisa e lo si archivia in una variabile. La variabile viene usata quando si esegue la query condivisa.

sharedqueryid=$(az graph shared-query show --resource-group "demoSharedQuery" \
  --name "Summarize resources by location" \
  --query id \
  --output tsv)

az graph query --graph-query "{{$sharedqueryid}}"

È possibile usare il parametro subscriptions per limitare i risultati.

az graph query --graph-query "{{$sharedqueryid}}" --subscriptions 11111111-1111-1111-1111-111111111111

Eseguire la query condivisa dal portale

È possibile verificare che la query condivisa funzioni usando Azure Resource Graph Explorer. Per modificare l'ambito, usare il menu Ambito sul lato sinistro della pagina.

Accedi al portale di Azure.
Immettere il grafico delle risorse nel campo di ricerca nella parte superiore della pagina.
Selezionare Resource Graph Explorer.
Selezionare Apri query.
Modificare il valore di Tipo e impostarlo su Query condivise.
Selezionare la query Conteggio macchine virtuali per sistema operativo.
Selezionare Esegui query e l'output della visualizzazione nella scheda Risultati .
Selezionare Grafici e quindi Mappa per visualizzare la mappa della posizione.

È anche possibile eseguire la query dal gruppo di risorse.

In Azure passare al gruppo di risorse demoSharedQuery.
Nella scheda Panoramica selezionare la query Conta macchine virtuali per sistema operativo.
Selezionare la scheda Risultati .
Selezionare Grafici e quindi Mappa per visualizzare la mappa della posizione.

Pulire le risorse

Per rimuovere la query condivisa:

az graph shared-query delete --name "Summarize resources by location" --resource-group demoSharedQuery

Quando un gruppo di risorse viene eliminato, il gruppo di risorse e tutte le relative risorse vengono eliminate. Per rimuovere il gruppo di risorse:

az group delete --name demoSharedQuery

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 questa guida di avvio rapido è stata aggiunta l'estensione Resource Graph all'ambiente dell'interfaccia della riga di comando di Azure ed è stata creata una query condivisa. 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