az graph

Referenz

Hinweis

Diese Referenz ist Teil der Ressourcendiagrammerweiterung für die Azure CLI (Version 2.22.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az graph-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Fragen Sie die von Azure Resource Manager verwalteten Ressourcen ab.

Führen Sie "az graph query --help" aus, um detaillierte Hilfe zu finden.

Befehle

Name	Beschreibung	Typ	Status
az graph query	Fragen Sie die von Azure Resource Manager verwalteten Ressourcen ab.	Durchwahl	Allgemein verfügbar
az graph shared-query	Verwalten der freigegebenen Abfrage des Azure-Ressourcendiagramms.	Durchwahl	Experimentell
az graph shared-query create	Erstellen sie eine freigegebene Abfrage.	Durchwahl	Experimentell
az graph shared-query delete	Löschen einer freigegebenen Abfrage.	Durchwahl	Experimentell
az graph shared-query list	Listet alle freigegebenen Abfragen in einer Ressourcengruppe auf.	Durchwahl	Experimentell
az graph shared-query show	Zeigt die Eigenschaften einer freigegebenen Abfrage an.	Durchwahl	Experimentell

az graph query

Fragen Sie die von Azure Resource Manager verwalteten Ressourcen ab.

Weitere Informationen zur Abfragesprache und zum Durchsuchen von Beispielen finden Sie https://aka.ms/AzureResourceGraph-QueryLanguage hier.

az graph query --graph-query
               [--allow-partial-scopes {false, true}]
               [--first]
               [--management-groups]
               [--skip]
               [--skip-token]
               [--subscriptions]

Beispiele

Abfragen von Ressourcen, die eine Teilmenge von Ressourcenfeldern anfordern.

az graph query -q "project id, name, type, location, tags"

Abfragen von Ressourcen mit Feldauswahl, Filtern und Zusammenfassungen.

az graph query -q "project id, type, location | where type =~ 'Microsoft.Compute/virtualMachines' | summarize count() by location | top 3 by count_"

Fordern Sie eine Teilmenge von Ergebnissen an, überspringen Sie 20 Elemente und erhalten Sie die nächsten 10.

az graph query -q "where type =~ "Microsoft.Compute" | project name, tags" --first 10 --skip 20

Wählen Sie Abonnements aus, die Sie abfragen möchten.

az graph query -q "where type =~ "Microsoft.Compute" | project name, tags" --subscriptions 11111111-1111-1111-1111-111111111111 22222222-2222-2222-2222-222222222222

Wählen Sie verwaltungsgruppen aus, die Sie abfragen möchten.

az graph query -q "where type =~ "Microsoft.Compute" | project name, tags" --management-groups aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb --allow-partial-scopes

Abfrage mit dem Skip-Token.

az graph query -q "where type =~ "Microsoft.Compute" | project name, tags" --skip-token skip_token_value_from_previous_query_response

Erforderliche Parameter

--graph-query --q -q

Auszuführende Resource Graph-Abfrage.

Optionale Parameter

--allow-partial-scopes -a

Gibt an, ob die Abfrage erfolgreich sein soll, wenn nur eine teilielle Anzahl von Abonnements darunter vom Server verarbeitet werden kann.

Zulässige Werte: false, true

Standardwert: False

--first

Die maximale Anzahl der zurückzugebenden Objekte. Akzeptierter Bereich: 1-1000.

--management-groups -m

Liste der Verwaltungsgruppen, für die Abfrage ausgeführt werden soll.

--skip

Ignoriert die ersten N-Objekte und ruft dann die objekte neu Standard ab.

--skip-token

Überspringen Sie das Token, um ggf. die nächste Seite der Abfrage abzurufen.

--subscriptions -s

Liste der Abonnements, für die Abfrage ausgeführt werden soll. Standardmäßig werden alle barrierefreien Abonnements abgefragt.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc

Standardwert: json

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.