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

  • Articolo

Questa guida introduttiva descrive come eseguire una query di Azure Resource Graph usando l'estensione per l'interfaccia della riga di comando di Azure. 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

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>

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. È possibile installare manualmente l'estensione con la procedura seguente. In caso contrario, la prima volta che si esegue una query con az graph viene richiesto di installare l'estensione.

  1. Elencare le estensioni e le versioni disponibili:

    az extension list-available --output table

  2. Installare l'estensione :

    az extension add --name resource-graph

  3. Verificare che l'estensione sia stata installata:

    az extension list --output table

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

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 al gruppo di gestione o alla sottoscrizione, usare gli --management-groups argomenti o --subscriptions .

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

  2. Aggiornare la query alla order byname proprietà :

    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.

  3. Aggiornare la query alla order byname proprietà 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 name proprietà, 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, vedere l'articolo dettagli del linguaggio di query.

Informazioni sul linguaggio di query di Azure Resource Graph