az graph

Note

This reference is part of the resource-graph extension for the Azure CLI (version 2.22.0 or higher). The extension will automatically install the first time you run an az graph command. Learn more about extensions.

Dotazujte se na prostředky spravované Pomocí Azure Resource Manageru.

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é Pomocí Azure Resource Manageru.	Extension	GA
az graph shared-query	Správa sdíleného dotazu v Azure Resource Graphu	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é Pomocí Azure Resource Manageru.

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

az graph query --graph-query --q
               [--allow-partial-scopes {false, true}]
               [--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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

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

Output format.

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