Quickstart: Resource Graph-query uitvoeren met behulp van Azure CLI
In deze quickstart wordt beschreven hoe u een Azure Resource Graph-query uitvoert met behulp van de Azure CLI en de Resource Graph-extensie. In het artikel wordt ook beschreven hoe u de resultaten van de query sorteert (sorteert) en beperkt. U kunt een query uitvoeren voor resources in uw tenant, beheergroepen of abonnementen. Wanneer u klaar bent, kunt u de extensie verwijderen.
Vereisten
- Als u geen Azure-account hebt, maak dan een gratis account aan voordat u begint.
- Azure CLI moet versie 2.22.0 of hoger zijn voor de Resource Graph-extensie.
- Een Bash-shellomgeving waar u Azure CLI-opdrachten kunt uitvoeren. Git Bash bijvoorbeeld in een Visual Studio Code-terminalsessie .
De extensie installeren
Als u azure CLI wilt inschakelen om query's uit te voeren op resources met behulp van Azure Resource Graph, moet de Resource Graph-extensie zijn geïnstalleerd. De eerste keer dat u een query uitvoert met az graph
een prompt, wordt weergegeven om de extensie te installeren. Gebruik anders de volgende stappen om een handmatige installatie uit te voeren.
Geef de beschikbare extensies en versies weer:
az extension list-available --output table
De extensie installeren:
az extension add --name resource-graph
Controleer of de extensie is geïnstalleerd:
az extension list --output table
De syntaxis van de extensie weergeven:
az graph query --help
Ga voor meer informatie over Azure CLI-extensies naar Extensies gebruiken en beheren met de Azure CLI.
Verbinding maken met Azure
Maak vanuit een Visual Studio Code-terminalsessie verbinding met Azure. Als u meer dan één abonnement hebt, voert u de opdrachten uit om context in te stellen op uw abonnement. Vervang <subscriptionID>
door de id van uw Azure-abonnement.
az login
# Run these commands if you have multiple subscriptions
az account list --output table
az account set --subscription <subscriptionID>
Een query uitvoeren
Nadat de Azure CLI-extensie is toegevoegd aan uw omgeving, kunt u een query op basis van een tenant uitvoeren. De query in dit voorbeeld retourneert vijf Azure-resources met de name
en type
van elke resource. Als u een query wilt uitvoeren op een beheergroep of abonnement, gebruikt u de --management-groups
of --subscriptions
argumenten.
Voer een Azure Resource Graph-query uit:
az graph query --graph-query 'Resources | project name, type | limit 5'
In dit queryvoorbeeld wordt geen sorteeraanpassing zoals
order by
. Als u de query meerdere keren uitvoert, kan dit een andere set resources opleveren voor elke aanvraag.Werk de query bij naar
order by
dename
eigenschap:az graph query --graph-query 'Resources | project name, type | limit 5 | order by name asc'
Net als bij de vorige query kan het voor elke aanvraag een andere set resources opleveren als u deze query meerdere keren uitvoert. De volgorde van de queryopdrachten is belangrijk. In dit voorbeeld komt
order by
nalimit
. De query beperkt de resultaten tot vijf resources en bestelt deze resultaten vervolgens op naam.Werk de query bij naar
order by
dename
eigenschap en vervolgenslimit
de uitvoer naar vijf resultaten:az graph query --graph-query 'Resources | project name, type | order by name asc | limit 5'
Als deze query meerdere keren wordt uitgevoerd zonder wijzigingen in uw omgeving, zijn de resultaten consistent en gerangschikt door de
name
eigenschap, maar nog steeds beperkt tot vijf resultaten. Met de query worden de resultaten op naam gesorteerd en wordt de uitvoer beperkt tot vijf resources.
Resources opschonen
Voer de volgende opdracht uit om de Resource Graph-extensie te verwijderen:
az extension remove --name resource-graph
Afmelden bij uw Azure CLI-sessie:
az logout
Volgende stappen
In deze quickstart hebt u Azure Resource Graph-query's uitgevoerd met behulp van de extensie voor Azure CLI. Ga verder naar de pagina met details van de querytaal voor meer informatie over de taal van Resource Graph.