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

Article
06/28/2024

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.

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.

Répertoriez les extensions et versions disponibles :
```
az extension list-available --output table
```
Installez l’extension :
```
az extension add --name resource-graph
```
Vérifiez que l’extension a été installée :
```
az extension list --output table
```
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.

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.

Créez un groupe de ressources pour stocker la requête partagée Azure Resource Graph.
```
az group create --name "demoSharedQuery" --location westus2
```

Créez la requête partagée.

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

Répertoriez toutes les requêtes partagées dans le groupe de ressources.
```
az graph shared-query list --resource-group demoSharedQuery
```

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

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.

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.

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.

Connectez-vous au portail Azure.
Entrez resource graph dans le champ de recherche en haut de la page.
Sélectionnez Explorateur Resource Graph.
Sélectionnez Ouvrir une requête.
Remplacez le Type par Requêtes partagées.
Sélectionnez la requête Compter les machines virtuelles par système d’exploitation.
Sélectionnez Exécuter la requête et la sortie d’affichage sous l’onglet Résultats.

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

Dans Azure, accédez au groupe de ressources demoSharedQuery.
Sous l’onglet Vue d’ensemble, sélectionnez la requête Compter les machines virtuelles par système d’exploitation.
Sélectionnez l’onglet Résultats.

Nettoyer les ressources

Pour supprimer le groupe de ressources et la requête partagée :

az group delete --name demoSharedQuery

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

Partager via