az graph

Note

Tento odkaz je součástí rozšíření resource-graph pro Azure CLI (verze 2.22.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az graph . Přečtěte si další informace o rozšířeních.

Dotazujte se na prostředky spravované Azure Resource Manager.

Pokud potřebujete podrobnou nápovědu, spusťte příkaz az graph query --help.

Příkazy

Name	Description	Typ	Stav
az graph query	Dotazujte se na prostředky spravované Azure Resource Manager.	Extension	GA
az graph shared-query	Správa sdíleného dotazu Azure grafu prostředků	Extension	Experimental
az graph shared-query create	Vytvořte sdílený dotaz.	Extension	Experimental
az graph shared-query delete	Odstraňte sdílený dotaz.	Extension	Experimental
az graph shared-query list	Zobrazí seznam všech sdílených dotazů ve skupině prostředků.	Extension	Experimental
az graph shared-query show	Umožňuje zobrazit vlastnosti sdíleného dotazu.	Extension	Experimental

az graph query

Dotazujte se na prostředky spravované Azure Resource Manager.

Další informace o dotazovacím jazyce a procházení příkladů najdete v https://aka.ms/AzureResourceGraph-QueryLanguage.

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

Příklady

Dotazování prostředků, které požadují podmnožinu polí zdrojů

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

Dotazování prostředků pomocí výběru polí, filtrování a shrnutí

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

Požádejte o podmnožinu výsledků, přeskočení 20 položek a získání dalších 10 položek.

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

Zvolte předplatná, která se mají dotazovat.

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

Zvolte skupiny pro správu, které se mají dotazovat.

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

Zadejte dotaz pomocí tokenu skip.

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

Povinné parametry

--graph-query --q -q

Dotaz Resource Graphu, který se má provést.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--acquire-policy-token

Získání tokenu Azure Policy automaticky pro tuto operaci prostředku

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

--allow-partial-scopes -a

Označuje, jestli by dotaz měl být úspěšný, pokud server může zpracovat pouze částečný počet předplatných.

Vlastnost	Hodnota
Default value:	False
Přípustné hodnoty:	false, true

--change-reference

Související referenční ID odkazu na změnu pro tuto operaci prostředku.

Vlastnost	Hodnota
Skupina parametrů:	Global Policy Arguments

--first

Maximální počet objektů, které se mají vrátit. Akceptovaný rozsah: 1–1000.

--management-groups -m

Seznam skupin pro správu pro spouštění dotazů

--skip

Ignoruje první N objekty a získá zbývající objekty.

--skip-token

Pokud je to možné, přeskočte token a získejte další stránku dotazu.

--subscriptions -s

Seznam předplatných ke spuštění dotazu Ve výchozím nastavení se dotazují všechna přístupná předplatná.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False