az graph

Référence

Remarque

Cette référence fait partie de l’extension resource-graph pour Azure CLI (version 2.22.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az graph . En savoir plus sur les 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	Statut
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	Expérimental
az graph shared-query create	Créez une requête partagée.	Extension	Expérimental
az graph shared-query delete	Supprimez une requête partagée.	Extension	Expérimental
az graph shared-query list	Répertorier toutes les requêtes partagées dans un groupe de ressources.	Extension	Expérimental
az graph shared-query show	Afficher les propriétés d’une requête partagée.	Extension	Expérimental

az graph query

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

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

az graph query --graph-query
               [--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

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

valeurs acceptées: false, true

valeur par défaut: False

--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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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