Schnellstart: Ausführen Ihrer ersten Resource Graph-Abfrage mithilfe der Azure CLI

Der erste Schritt der Verwendung von Azure Resource Graph ist, zu überprüfen, ob die Erweiterung für die Azure-Befehlszeilenschnittstelle installiert ist. Dieser Schnellstart führt Sie durch das Hinzufügen der Erweiterung zu Ihrer Azure-Befehlszeilenschnittstelle. Sie können die Erweiterung mit lokal installierter Azure CLI oder über die Azure Cloud Shell verwenden.

Am Ende dieses Prozesses haben Sie die Erweiterung der Installation der Azure-Befehlszeilenschnittstelle Ihrer Wahl hinzugefügt und Ihre erste Resource Graph-Abfrage durchgeführt.

Voraussetzungen

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Hinzufügen der Resource Graph-Erweiterung

Um die Azure-Befehlszeilenschnittstelle für die Abfrage von Azure Resource Graph zu aktivieren, muss die Erweiterung hinzugefügt werden. Diese Erweiterung funktioniert überall, wo die Azure-Befehlszeilenschnittstelle verwendet werden kann, einschließlich bash unter Windows 10, Cloud Shell (sowohl eigenständig als auch innerhalb des Portals), Azure CLI-Docker-Image oder lokaler Installation.

1. Vergewissern Sie sich, dass die neueste Azure CLI (mindestens 2.0.76) installiert ist. Falls es noch nicht installiert ist, befolgen Sie diese Anweisungen.

2. Importieren Sie sie mit folgendem Befehl in die Azure CLI-Umgebung Ihrer Wahl:

   # Add the Resource Graph extension to the Azure CLI environment
   az extension add --name resource-graph
   

3. Überprüfen Sie, ob die Erweiterung installiert wurde und in der erwarteten Version vorliegt (mindestens 1.0.0):

   # Check the extension list (note that you may have other extensions installed)
   az extension list
   
   # Run help for graph query options
   az graph query -h
   

Ausführen Ihrer ersten Resource Graph-Abfrage

Nachdem die Azure CLI-Erweiterung der gewünschten Umgebung hinzugefügt wurde, können Sie eine einfache mandantenbasierte Resource Graph-Abfrage ausprobieren. Die Abfrage gibt die ersten fünf Azure-Ressourcen mit dem Namen und Ressourcentyp der einzelnen Ressourcen zurück. Verwenden Sie für eine Abfrage nach Verwaltungsgruppe oder Abonnement die Argumente --managementgroups oder --subscriptions.

1. Führen Sie Ihre erste Azure Resource Graph-Abfrage mit der graph-Erweiterung und dem query-Befehl aus:

   # Login first with az login if not using Cloud Shell
   
   # Run Azure Resource Graph query
   az graph query -q 'Resources | project name, type | limit 5'
   

   Hinweis

   Da dieses Abfragebeispiel keinen Sortierungsmodifizierer wie z.B. order by umfasst, ergibt die mehrfache Ausführung dieser Abfrage vermutlich pro Anforderung einen anderen Satz von Ressourcen.

2. Aktualisieren Sie die Abfrage auf order by der Eigenschaft Name:

   # Run Azure Resource Graph query with 'order by'
   az graph query -q 'Resources | project name, type | limit 5 | order by name asc'
   

   Hinweis

   Genau wie bei der ersten Abfrage ergibt die mehrfache Ausführung dieser Abfrage vermutlich pro Anforderung einen anderen Satz von Ressourcen. Die Reihenfolge der Abfragebefehle ist wichtig. In diesem Beispiel kommt order by nach limit. Durch diese Befehlsreihenfolge werden die Abfrageergebnisse zuerst eingeschränkt und dann sortiert.

3. Aktualisieren Sie die Abfrage, sodass zuerst eine Sortierung (order by) nach der Eigenschaft Name vorgenommen wird, und begrenzen Sie die Ergebnisse mithilfe von limit auf die fünf relevantesten Ergebnisse:

   # Run Azure Resource Graph query with `order by` first, then with `limit`
   az graph query -q 'Resources | project name, type | order by name asc | limit 5'
   

Wenn die letzte Abfrage mehrmals ausgeführt wird und in Ihrer Umgebung keine Änderungen vorgenommenen werden, sind die zurückgegebenen Ergebnisse konsistent und nach der Eigenschaft Name sortiert, aber immer noch auf die ersten fünf Ergebnisse begrenzt.

Bereinigen von Ressourcen

Wenn Sie die Resource Graph-Erweiterung aus der Azure CLI-Umgebung entfernen möchten, verwenden Sie hierfür folgenden Befehl:

# Remove the Resource Graph extension from the Azure CLI environment
az extension remove -n resource-graph

Nächste Schritte

In dieser Schnellstartanleitung haben Sie die Resource Graph-Erweiterung Ihrer Azure CLI-Umgebung hinzugefügt und Ihre erste Abfrage ausgeführt. Wenn Sie mehr über die Resource Graph-Sprache erfahren möchten, fahren Sie mit der Seite mit den Details zur Abfragesprache fort.

Erfahren Sie mehr über die Abfragesprache.