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

Article
06/01/2023

La première étape pour utiliser Azure Resource Graph avec Azure CLI consiste à vérifier que l’extension est installée. Ce guide de démarrage rapide décrit le processus d’ajout de l’extension à votre installation Azure CLI. Vous pouvez utiliser l’extension avec Azure CLI dans le cadre d’une installation locale ou par le biais d’Azure Cloud Shell.

Au terme de ce processus, vous aurez ajouté l’extension à l’installation Azure CLI de votre choix et créé une requête partagée Resource Graph.

Prérequis

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

Ajouter l’extension Resource Graph

Pour permettre à Azure CLI d’utiliser Azure Resource Graph, vous devez ajouter l’extension. Cette extension fonctionne avec Azure CLI quel que soit l’endroit où vous l’utilisez : bash sur Windows 10, Cloud Shell (en version autonome et à l’intérieur du portail), image Docker Azure CLI ou installation locale.

Vérifiez que la version la plus récente d’Azure CLI est installée (2.8.0 au minimum). S’il n’est pas installé, suivez ces instructions.
Dans l’environnement Azure CLI de votre choix, utilisez az extension add pour importer l’extension Resource Graph avec la commande suivante :
```
# Add the Resource Graph extension to the Azure CLI environment
az extension add --name resource-graph
```

Vérifiez que l’extension a été installée et qu’il s’agit de la version attendue (au moins 1.1.0) avec az extension list :

# Check the extension list (note that you may have other extensions installed)
az extension list

# Run help for graph query options
az graph query -h

Créer une requête partagée Resource Graph

Une fois l’extension Azure CLI ajoutée à l’environnement de votre choix, vous pouvez créer une requête partagée Resource Graph. La 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. La requête récapitule le nombre total de ressources regroupées par emplacement.

Créez un groupe de ressources avec az group create pour stocker la requête partagée Azure Resource Graph. Ce groupe de ressources est nommé resource-graph-queries et son emplacement est westus2.
```
# Login first with az login if not using Cloud Shell

# Create the resource group
az group create --name 'resource-graph-queries' --location 'westus2'
```

Créez la requête partagée Azure Resource Graph à l’aide de l’extension graph et de la commande az graph shared-query create :

# Create the Azure Resource Graph shared query
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 'resource-graph-queries'

Listez les requêtes partagées dans le nouveau groupe de ressources. La commande az graph shared-query list retourne un tableau de valeurs.

# List all the Azure Resource Graph shared queries in a resource group
az graph shared-query list --resource-group 'resource-graph-queries'

Pour obtenir un seul résultat de requête partagée, utilisez la commande az graph shared-query show.

# Show a specific Azure Resource Graph shared query
az graph shared-query show --resource-group 'resource-graph-queries' \
   --name 'Summarize resources by location'

Exécutez la requête partagée dans Azure CLI à l’aide de la syntaxe {{shared-query-uri}} dans une commande az graph query. Tout d’abord, copiez le champ id à partir du résultat de la commande show précédente. Remplacez le texte shared-query-uri de l’exemple par la valeur provenant du champ id, mais laissez les caractères {{ et }} autour.
```
# Run a Azure Resource Graph shared query
az graph query --graph-query "{{shared-query-uri}}"
```
Notes

La syntaxe {{shared-query-uri}} est une fonctionnalité en préversion.

Une autre façon de rechercher des requêtes partagées Resource Graph consiste à utiliser le portail Azure. Dans le portail, utilisez la barre de recherche pour rechercher « requêtes Resource Graph ». Sélectionnez la requête partagée. Dans la page Vue d’ensemble , l’onglet Requête affiche la requête enregistrée. Le bouton Modifier l’ouvre dans l’Explorateur Resource Graph.

Nettoyer les ressources

Si vous souhaitez supprimer la requête partagée, le groupe de ressources et l’extension Resource Graph de votre environnement Azure CLI, vous pouvez le faire à l’aide des commandes suivantes :

# Delete the Azure Resource Graph shared query
az graph shared-query delete --resource-group 'resource-graph-queries' \
   --name 'Summarize resources by location'

# Remove the resource group
# WARNING: This command deletes ALL resources you've added to this resource group without prompting for confirmation
az group delete --resource-group 'resource-graph-queries' --yes

# Remove the Azure Resource Graph extension from the Azure CLI environment
az extension remove -n resource-graph

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

Obtenir plus d’informations sur le langage de requête

Share via