az graph

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.