Partager via


Démarrage rapide : Exécuter une requête Resource Graph à l’aide d’Azure CLI

Ce guide de démarrage rapide explique comment exécuter une requête Azure Resource Graph à l’aide d’Azure CLI et de l’extension Resource Graph. L’article montre également comment classer (trier) et limiter les résultats de la requête. Vous pouvez exécuter une requête pour les ressources de votre locataire, des groupes d’administration ou des abonnements. Lorsque vous avez terminé, vous pouvez supprimer l’extension.

Prérequis

  • Si vous ne disposez pas d’un compte Azure, créez-en un gratuitement avant de commencer.
  • Azure CLI doit être version 2.22.0 ou ultérieure pour l’extension Resource Graph.
  • Un environnement d’interpréteur de commandes Bash dans lequel vous pouvez exécuter des commandes Azure CLI. Par exemple, Git Bash dans une session de terminal Visual Studio Code.

Connexion à Azure

Depuis une session de terminal Visual Studio Code, connectez-vous à Azure. Si vous avez plusieurs abonnements, exécutez les commandes pour définir le contexte sur votre abonnement. Remplacez <subscriptionID> par l’identifiant de votre abonnement Azure.

az login

# Run these commands if you have multiple subscriptions
az account list --output table
az account set --subscription <subscriptionID>

Installer l’extension

Pour permettre à Azure CLI d’interroger les ressources à l’aide d’Azure Resource Graph, l’extension Resource Graph doit être installée. La première fois que vous exécutez une requête avec az graph, une invite s’affiche pour installer l’extension. Sinon, procédez comme suit pour effectuer une installation manuelle.

  1. Répertoriez les extensions et versions disponibles :

    az extension list-available --output table
    
  2. Installez l’extension :

    az extension add --name resource-graph
    
  3. Vérifiez que l’extension a été installée :

    az extension list --output table
    
  4. Affichez la syntaxe de l’extension :

    az graph query --help
    

    Pour plus d’informations sur les extensions Azure CLI, voir Utiliser et gérer des extensions avec Azure CLI.

Exécuter une requête

Une fois l’extension Azure CLI ajoutée à votre environnement, vous pouvez exécuter une requête basée sur un locataire. La requête de cet exemple retourne cinq ressources Azure avec les name et les type de chaque ressource. Pour effectuer une requête par groupe d’administration ou par abonnement, utilisez les arguments --management-groups ou --subscriptions.

  1. Exécutez une requête Azure Resource Graph :

    az graph query --graph-query 'Resources | project name, type | limit 5'
    

    Cet exemple de requête n’utilise pas de modificateur de tri comme order by. Si vous exécutez la requête plusieurs fois, il se peut que vous obteniez un ensemble de ressources différent pour chaque requête.

  2. Mettre à jour la requête pour order by le name bien :

    az graph query --graph-query 'Resources | project name, type | limit 5 | order by name asc'
    

    Comme pour la requête précédente, si vous exécutez cette requête plusieurs fois, il se peut que vous obteniez un ensemble de ressources différent pour chaque requête. L’ordre des commandes de requête est important. Dans cet exemple, order by vient après limit. La requête limite les résultats à cinq ressources, puis trie ces résultats par nom.

  3. Mettez à jour la requête en fonction de order by la name propriété, puis la limit sortie en fonction des cinq résultats :

    az graph query --graph-query 'Resources | project name, type | order by name asc | limit 5'
    

    Si cette requête est exécutée plusieurs fois sans modification de votre environnement, les résultats sont cohérents et classés par propriété name, mais restent limités à cinq résultats. La requête classe les résultats par nom et limite ensuite le résultat à cinq ressources.

Nettoyer les ressources

Pour supprimer l’extension Resource Graph, exécutez la commande suivante :

az extension remove --name resource-graph

Pour vous déconnecter de votre session Azure CLI :

az logout

Étapes suivantes

Dans ce démarrage rapide, vous avez exécuté des requêtes Azure Resource Graph à l’aide de l’extension pour Azure CLI. Pour en savoir plus, accédez à l’article sur les détails du langage de requête.