az graph

Referentie

Notitie

Deze verwijzing maakt deel uit van de resourcegrafiekextensie voor de Azure CLI (versie 2.22.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az graph-opdracht uitvoert. Meer informatie over extensies.

Voer een query uit op de resources die worden beheerd door Azure Resource Manager.

Voer az graph query --help uit voor gedetailleerde hulp.

Opdracht

Name	Description	Type	Status
az graph query	Voer een query uit op de resources die worden beheerd door Azure Resource Manager.	Toestel	GA
az graph shared-query	Gedeelde query van Azure-resourcegrafiek beheren.	Toestel	Experimenteel
az graph shared-query create	Maak een gedeelde query.	Toestel	Experimenteel
az graph shared-query delete	Een gedeelde query verwijderen.	Toestel	Experimenteel
az graph shared-query list	Alle gedeelde query's in een resourcegroep weergeven.	Toestel	Experimenteel
az graph shared-query show	De eigenschappen van een gedeelde query weergeven.	Toestel	Experimenteel

az graph query

Voer een query uit op de resources die worden beheerd door Azure Resource Manager.

Zie https://aka.ms/AzureResourceGraph-QueryLanguage voor meer informatie over querytaal en bladervoorbeelden.

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

Voorbeelden

Query's uitvoeren op resources die een subset van resourcevelden aanvragen.

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

Query's uitvoeren op resources met veldselectie, filteren en samenvatten.

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

Vraag een subset met resultaten aan, waarbij 20 items worden overgeslagen en de volgende 10 worden opgehaald.

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

Kies abonnementen om een query uit te voeren.

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

Kies beheergroepen die u wilt opvragen.

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

Voer een query uit met het token voor overslaan.

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

Vereiste parameters

--graph-query --q -q

Resource Graph-query die moet worden uitgevoerd.

Optionele parameters

--allow-partial-scopes -a

Geeft aan of de query moet slagen wanneer slechts een gedeeltelijk aantal onderliggende abonnementen kan worden verwerkt door de server.

geaccepteerde waarden: false, true

standaardwaarde: False

--first

Het maximum aantal objecten dat moet worden geretourneerd. Geaccepteerd bereik: 1-1000.

--management-groups -m

Lijst met beheergroepen waarop een query moet worden uitgevoerd.

--skip

Negeert de eerste N-objecten en haalt vervolgens de resterende objecten op.

--skip-token

Sla het token over om de volgende pagina van de query op te halen, indien van toepassing.

--subscriptions -s

Lijst met abonnementen waarvoor query's moeten worden uitgevoerd. Standaard worden alle toegankelijke abonnementen opgevraagd.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.