Schnellstart: Erstellen einer freigegebenen Resource Graph-Abfrage mithilfe der Azure-Befehlszeilenschnittstelle

Artikel
12/04/2024

In diesem Schnellstart wird beschrieben, wie Sie eine freigegebene Azure Resource Graph-Abfrage mit der Azure-Befehlszeilenschnittstelle und der Resource Graph-Erweiterung erstellen. Die Befehle az graph shared-query sind ein experimentelles Feature von az graph query.

Eine freigegebene Abfrage kann über die Azure-Befehlszeilenschnittstelle mit den Befehlen des experimentellen Features ausgeführt werden. Sie können die freigegebene Abfrage auch über das Azure-Portal ausführen. Bei einer freigegebenen Abfrage handelt es sich um ein Azure Resource Manager-Objekt, dem Sie Berechtigung für den Azure Resource Graph-Tester gewähren oder das Sie im Azure Resource Graph-Tester ausführen können. Wenn Sie fertig sind, können Sie die Resource Graph-Erweiterung entfernen.

Voraussetzungen

Sollten Sie kein Azure-Konto haben, erstellen Sie zunächst ein kostenloses Konto.
Für die Resource Graph-Erweiterung wird mindestens die Version 2.22.0 der Azure CLI benötigt.
Eine Bash-Shellumgebung, in der Sie Azure CLI-Befehle ausführen können. Beispielsweise Git Bash in einer Visual Studio Code-Terminalsitzung.

Installieren Sie die -Erweiterung.

Damit die Azure CLI Ressourcen unter Verwendung von Azure Resource Graph abfragen kann, muss die Resource Graph-Erweiterung installiert sein. Wenn Sie eine Abfrage zum ersten Mal mit az graph ausführen, werden Sie aufgefordert, die Erweiterung zu installieren. Führen Sie andernfalls die folgenden Schritte aus, um eine manuelle Installation auszuführen.

Listen Sie die verfügbaren Erweiterungen und Versionen auf:
```
az extension list-available --output table
```
Installieren Sie die Erweiterung:
```
az extension add --name resource-graph
```
Überprüfen Sie, ob die Erweiterung installiert wurde:
```
az extension list --output table
```
Zeigen Sie die Syntax der Erweiterung an:
```
az graph query --help
```

Weitere Informationen zu Azure CLI-Erweiterungen finden Sie unter Verwenden und Verwalten von Erweiterungen mit der Azure CLI.

Herstellen einer Verbindung mit Azure

Stellen Sie in einer Visual Studio Code-Terminalsitzung eine Verbindung mit Azure her. Wenn Sie über mehrere Abonnements verfügen, führen Sie die Befehle aus, um den Kontext für Ihr Abonnement festzulegen. Ersetzen Sie <subscriptionID> durch Ihre Azure-Abonnement-ID.

az login

# Run these commands if you have multiple subscriptions
az account list --output table
az account set --subscription <subscriptionID>

Erstellen einer freigegebenen Abfrage

Erstellen Sie eine Ressourcengruppe und eine freigegebene Abfrage, die die Anzahl aller Ressourcen gruppiert nach dem Ort zusammenfasst.

Erstellen Sie eine Ressourcengruppe zum Speichern der freigegebenen Azure Resource Graph-Abfrage.
```
az group create --name "demoSharedQuery" --location westus2
```

Erstellen Sie die freigegebene Abfrage.

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

Listen Sie alle freigegebenen Abfragen in der Ressourcengruppe auf.
```
az graph shared-query list --resource-group demoSharedQuery
```

Grenzen Sie die Ergebnisse auf eine bestimmte freigegebene Abfrage ein.

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

Ausführen der freigegebenen Abfrage

Sie können die Syntax des experimentellen Features der Azure-Befehlszeilenschnittstelle oder das Azure-Portal verwenden, um die freigegebene Abfrage auszuführen.

Verwenden des experimentellen Features zum Ausführen einer freigegebenen Abfrage

Führen Sie die freigegebene Abfrage in der Azure-Befehlszeilenschnittstelle mit der {{shared-query-uri}}-Syntax in einem az graph query-Befehl aus. Sie erhalten die Ressourcen-ID Ihrer freigegebenen Abfrage, die Sie in einer Variable speichern. Sie verwenden die Variable beim Ausführen der freigegebenen Abfrage.

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

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

Sie können den subscriptions-Parameter verwenden, um die Ergebnisse einzugrenzen.

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

Ausführen der freigegebenen Abfrage über das Portal

Sie können mit dem Azure Resource Graph-Tester überprüfen, ob die freigegebene Abfrage funktioniert. Um den Bereich zu ändern, verwenden Sie links auf der Seite das Menü Bereich.

Melden Sie sich beim Azure-Portal an.
Geben Sie oben auf der Seite in das Suchfeld Resource Graph ein.
Wählen Sie Resource Graph-Tester aus.
Klicken Sie auf Abfrage öffnen.
Ändern Sie Typ in Freigegebene Abfragen.
Wählen Sie die Abfrage VMs nach Betriebssystem zählen aus.
Wählen Sie Abfrage ausführen und auf der Registerkarte Ergebnisse die Ansicht „Ausgabe“ aus.
Wählen Sie Diagramme und dann Karte aus, um die Standortkarte anzuzeigen.

Sie können die Abfrage auch aus Ihrer Ressourcengruppe ausführen.

Wechseln Sie in Azure zur Ressourcengruppe demoSharedQuery.
Wählen Sie auf der Registerkarte Übersicht die Abfrage VMs nach Betriebssystem zählen aus.
Wählen Sie die Registerkarte Ergebnisse aus.
Wählen Sie Diagramme und dann Karte aus, um die Standortkarte anzuzeigen.

Bereinigen von Ressourcen

So entfernen Sie die freigegebene Abfrage

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

Wenn eine Ressourcengruppe gelöscht wird, werden die Ressourcengruppe und alle zugehörigen Ressourcen gelöscht. So entfernen Sie die Ressourcengruppe:

az group delete --name demoSharedQuery

Führen Sie den folgenden Befehl aus, um die Resource Graph-Erweiterung zu entfernen:

az extension remove --name resource-graph

Abmeldung von Ihrer Azure CLI-Sitzung:

az logout

Nächste Schritte

In diesem Schnellstart haben Sie Ihrer Azure CLI-Umgebung die Resource Graph-Erweiterung hinzugefügt und eine freigegebene 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.

Grundlegendes zur Azure Resource Graph-Abfragesprache

Freigeben über