Lire en anglais

Partager via

Guide de démarrage rapide : Créer une requête partagée Resource Graph avec Azure CLI

  • Article

Ce guide de démarrage rapide explique comment créer une requête partagée Azure Resource Graph à l’aide d’Azure CLI et de l’extension Resource Graph. Les commandes az graph shared-query sont une fonctionnalité expérimentale de az graph query.

Une requête partagée peut être exécutée à partir d’Azure CLI avec les commandes de la fonctionnalité expérimentale, ou vous pouvez exécuter la requête partagée à partir du Portail Azure. Une requête partagée est un objet Azure Resource Manager auquel vous pouvez accorder des autorisations ou que vous pouvez exécuter dans l’Explorateur Azure Resource Graph. Lorsque vous avez terminé, vous pouvez supprimer l’extension Resource Graph.

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.

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 :

    Azure CLI 
    az extension list-available --output table

  2. Installez l’extension :

    Azure CLI 
    az extension add --name resource-graph

  3. Vérifiez que l’extension a été installée :

    Azure CLI 
    az extension list --output table

  4. Affichez la syntaxe de l’extension :

    Azure CLI 
    az graph query --help

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

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.

Azure CLI 
az login

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

Créer une requête partagée

Créez un groupe de ressources et un partage qui résume le nombre de toutes les ressources regroupées par emplacement.

  1. Créez un groupe de ressources pour stocker la requête partagée Azure Resource Graph.

    Azure CLI 
    az group create --name "demoSharedQuery" --location westus2

  2. Créez la requête partagée.

    Azure CLI 
    az graph shared-query create --name "Summarize resources by location" \
  --description "This shared query summarizes resources by location for a pinnable map graphic." \
  --graph-query "Resources | summarize count() by location" \
  --resource-group demoSharedQuery

  3. Répertoriez toutes les requêtes partagées dans le groupe de ressources.

    Azure CLI 
    az graph shared-query list --resource-group demoSharedQuery

  4. Limitez les résultats à une requête partagée spécifique.

    Azure CLI 
    az graph shared-query show --resource-group "demoSharedQuery" \
  --name "Summarize resources by location"

Exécuter la requête partagée

Vous pouvez utiliser la syntaxe de fonctionnalité expérimentale Azure CLI ou le Portail Azure pour exécuter la requête partagée.

Utiliser la fonctionnalité expérimentale pour exécuter la requête partagée

Exécutez la requête partagée dans Azure CLI à l’aide de la syntaxe {{shared-query-uri}} dans une commande az graph query. Vous obtenez l’ID de ressource de votre requête partagée et la stockez dans une variable. La variable est utilisée lorsque vous exécutez la requête partagée.

Azure CLI 
sharedqueryid=$(az graph shared-query show --resource-group "demoSharedQuery" \
  --name "Summarize resources by location" \
  --query id \
  --output tsv)

az graph query --graph-query "{{$sharedqueryid}}"

Vous pouvez utiliser le paramètre subscriptions pour limiter les résultats.

Azure CLI 
az graph query --graph-query "{{$sharedqueryid}}" --subscriptions 11111111-1111-1111-1111-111111111111

Exécuter la requête partagée depuis le Portail

Vous pouvez vérifier que la requête partagée fonctionne à l’aide de l’Explorateur Azure Resource Graph. Pour modifier l’étendue, utilisez le menu Étendue sur le côté gauche de la page.

  1. Connectez-vous au portail Azure.
  2. Entrez resource graph dans le champ de recherche en haut de la page.
  3. Sélectionnez Explorateur Resource Graph.
  4. Sélectionnez Ouvrir une requête.
  5. Remplacez le Type par Requêtes partagées.
  6. Sélectionnez la requête Compter les machines virtuelles par système d’exploitation.
  7. Sélectionnez Exécuter la requête et la sortie d’affichage sous l’onglet Résultats.
  8. Sélectionnez Graphiques, puis Carte pour afficher la carte de localisation..

Vous pouvez également exécuter la requête à partir de votre groupe de ressources.

  1. Dans Azure, accédez au groupe de ressources demoSharedQuery.
  2. Sous l’onglet Vue d’ensemble, sélectionnez la requête Compter les machines virtuelles par système d’exploitation.
  3. Sélectionnez l’onglet Résultats.
  4. Sélectionnez Graphiques, puis Carte pour afficher la carte de localisation..

Nettoyer les ressources

Supprimez la requête partagée :

Azure CLI 
az graph shared-query delete --name "Summarize resources by location" --resource-group demoSharedQuery

Lorsqu’un groupe de ressources est supprimé, le groupe de ressources et toutes ses ressources sont supprimés. Pour supprimer le groupe de ressources :

Azure CLI 
az group delete --name demoSharedQuery

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

Azure CLI 
az extension remove --name resource-graph

Pour vous déconnecter de votre session Azure CLI :

Azure CLI 
az logout

Étapes suivantes

Dans ce guide de démarrage rapide, vous avez ajouté l’extension Resource Graph à votre environnement Azure CLI et vous avez créé une requête partagée. Pour plus d’informations sur le langage Resource Graph, passez à la page des détails du langage de requête.

Présentation du langage de requête Azure Resource Graph