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.
Vergewissern Sie sich, dass die neueste Azure CLI (mindestens 2.0.76) installiert ist. Falls es noch nicht installiert ist, befolgen Sie diese Anweisungen.
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
Ü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
.
Führen Sie Ihre erste Azure Resource Graph-Abfrage mit der
graph
-Erweiterung und demquery
-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.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
nachlimit
. Durch diese Befehlsreihenfolge werden die Abfrageergebnisse zuerst eingeschränkt und dann sortiert.Aktualisieren Sie die Abfrage, sodass zuerst eine Sortierung (
order by
) nach der Eigenschaft Name vorgenommen wird, und begrenzen Sie die Ergebnisse mithilfe vonlimit
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.