az graph

Note

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. Erfahren Sie mehr über 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.	Extension	GA
az graph shared-query	Verwalten der freigegebenen Abfrage des Azure-Ressourcendiagramms.	Extension	Experimental
az graph shared-query create	Erstellen sie eine freigegebene Abfrage.	Extension	Experimental
az graph shared-query delete	Löschen einer freigegebenen Abfrage.	Extension	Experimental
az graph shared-query list	Listet alle freigegebenen Abfragen in einer Ressourcengruppe auf.	Extension	Experimental
az graph shared-query show	Zeigt die Eigenschaften einer freigegebenen Abfrage an.	Extension	Experimental

az graph query

Fragen Sie die von Azure Resource Manager verwalteten Ressourcen ab.

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

az graph query --graph-query --q
               [--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

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--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.

Eigenschaft	Wert
Standardwert:	False
Zulässige Werte:	false, true

--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 verbleibenden Objekte 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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

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

--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

Feedback

War diese Seite hilfreich?