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.

Interrogez les ressources gérées par Azure Resource Manager.

Exécutez « az graph query --help » pour obtenir une aide détaillée.

Commandes

Nom	Description	Type	État
az graph query	Interrogez les ressources gérées par Azure Resource Manager.	Extension	GA
az graph shared-query	Gérer la requête partagée du graphe de ressources Azure.	Extension	Experimental
az graph shared-query create	Créez une requête partagée.	Extension	Experimental
az graph shared-query delete	Supprimez une requête partagée.	Extension	Experimental
az graph shared-query list	Répertorier toutes les requêtes partagées dans un groupe de ressources.	Extension	Experimental
az graph shared-query show	Afficher les propriétés d’une requête partagée.	Extension	Experimental

az graph query

Interrogez les ressources gérées par Azure Resource Manager.

Consultez https://aka.ms/AzureResourceGraph-QueryLanguage pour en savoir plus sur le langage de requête et parcourir des exemples.

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

Exemples

Interrogez les ressources demandant un sous-ensemble de champs de ressources.

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

Interrogez les ressources avec la sélection de champs, le filtrage et la synthèse.

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

Demandez un sous-ensemble de résultats, ignorez 20 éléments et obtenez les 10 suivants.

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

Choisissez des abonnements à interroger.

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

Choisissez des groupes d’administration à interroger.

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

Interrogez avec le jeton skip.

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

Paramètres obligatoires

--graph-query --q -q

Requête Resource Graph à exécuter.

Paramètres facultatifs

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

Indique si la requête doit réussir lorsque seul un nombre partiel d’abonnement en dessous peut être traité par le serveur.

Propriété	Valeur
Valeur par défaut:	False
Valeurs acceptées:	false, true

--first

Nombre maximal d’objets à retourner. Plage acceptée : 1 à 1000.

--management-groups -m

Liste des groupes d’administration à exécuter une requête.

--skip

Ignore les premiers objets N, puis obtient les objets restants.

--skip-token

Ignorez le jeton pour obtenir la page suivante de la requête le cas échéant.

--subscriptions -s

Liste des abonnements à exécuter une requête. Par défaut, tous les abonnements accessibles sont interrogés.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Output format.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété	Valeur
Valeur par défaut:	False