Tutoriel : Créer et partager une requête Azure Resource Graph dans le portail Azure

Azure Resource Graph Explorer vous permet d’enregistrer vos requêtes Resource Graph directement dans le portail Azure. Il existe deux types de requêtes : privé et partagé. Une requête privée est enregistrée dans les paramètres de votre portail Azure. Alors qu’une requête partagée est une ressource Azure Resource Manager qui peut être gérée avec le contrôle d’accès en fonction du rôle Azure (Azure RBAC) et protégée par des verrous de ressources. Les deux types de requêtes sont chiffrées au repos.

En enregistrant des requêtes dans le portail Azure, vous gagnez du temps que vous pouvez autrement passer à la recherche de vos requêtes préférées ou couramment utilisées. Lorsque vous partagez des requêtes, vous aidez votre équipe à réaliser des objectifs de cohérence et d’efficacité grâce à la répétition.

Dans ce tutoriel, vous allez effectuer les tâches suivantes :

Prerequisites

Pour suivre ce tutoriel, vous avez besoin d’un abonnement Azure. Si vous n’en avez pas, créez un compte gratuit avant de commencer.

Créer et supprimer une requête privée

Les requêtes privées sont accessibles et visibles uniquement pour le compte qui les crée. À mesure qu’ils sont enregistrés dans les paramètres du portail Azure d’un compte, ils peuvent être créés, utilisés et supprimés uniquement à partir du portail Azure. Une requête privée n’est pas une ressource Resource Manager. Pour créer une requête privée, procédez comme suit :

1. Dans le menu du portail, sélectionnez Tous les services ou utilisez la zone de recherche Azure en haut de toutes les pages. Recherchez et sélectionnez ensuite l’Explorateur du Graph de Ressources.

2. Sous l’onglet Requête 1 de la page Explorateur Azure Resource Graph, entrez la requête suivante :

   Resources
   | where type =~ 'Microsoft.Compute/virtualMachines'
   | summarize count() by tostring(properties.storageProfile.osDisk.osType)
   

   Sélectionnez Exécuter la requête pour afficher les résultats de la requête dans le volet inférieur.

   Pour plus d’informations sur cette requête, consultez Exemples : compter les machines virtuelles par type de système d’exploitation.

3. Sélectionnez Enregistrer ou Enregistrer sous, entrez Nombre de machines virtuelles par système d’exploitation en tant que nom, laissez le type requête privée, puis sélectionnez Enregistrer en bas du volet Enregistrer la requête. Le titre de l’onglet passe de la requête 1 au nombre de machines virtuelles par système d’exploitation.

4. Quittez l’Explorateur Azure Resource Graph dans le portail Azure, puis revenez-y. Notez que la requête enregistrée n’est plus affichée et que l’onglet Requête 1 a retourné.

5. Sélectionnez Ouvrir une requête. Vérifiez que le type est une requête privée. Le nom enregistré nombre de machines virtuelles par système d’exploitation apparaît désormais dans la liste Nom de la requête . Lorsque vous sélectionnez le lien de titre de la requête enregistrée, il est chargé dans un nouvel onglet avec le nom de cette requête.

   Note

   Lorsqu’une requête enregistrée est ouverte et que l’onglet affiche son nom, la sélection du bouton Enregistrer la met à jour avec les modifications apportées. Pour créer une requête enregistrée à partir de cette requête ouverte, sélectionnez Enregistrer sous et continuer comme si vous enregistrez une nouvelle requête.

6. Pour supprimer la requête enregistrée, sélectionnez à nouveau Ouvrir une requête , puis vérifiez que le champ Type est défini sur Requête privée. Sur la ligne de la requête enregistrée Count VMs by OS , sélectionnez Supprimer (icône Corbeille). Dans la boîte de dialogue de confirmation, sélectionnez Oui pour terminer la suppression de la requête. Fermez ensuite le volet Ouvrir une requête .

Créer une requête partagée

Contrairement à une requête privée, une requête partagée est une ressource Resource Manager. Cela signifie que la requête est enregistrée dans un groupe de ressources, peut être gérée et contrôlée avec Azure RBAC et peut même être protégée avec des verrous de ressources. En tant que ressource, toute personne disposant des autorisations appropriées peut voir et l’utiliser. Pour créer une requête partagée, procédez comme suit :

1. Dans le menu du portail, sélectionnez Tous les services ou utilisez la zone de recherche Azure en haut de toutes les pages pour rechercher et sélectionner l’Explorateur Resource Graph.

2. Sous l’onglet Requête 1 de la page Explorateur Azure Resource Graph, entrez la requête suivante :

   Resources
   | where type =~ 'Microsoft.Compute/virtualMachines'
   | summarize count() by tostring(properties.storageProfile.osDisk.osType)
   

   Sélectionnez Exécuter la requête pour afficher les résultats de la requête dans le volet inférieur.

   Pour plus d’informations sur cette requête, consultez Exemples : compter les machines virtuelles par type de système d’exploitation.

3. Sélectionnez Enregistrer ou Enregistrer sous.

   

4. Dans le volet Enregistrer la requête , entrez Nombre de machines virtuelles par système d’exploitation pour le nom.

5. Remplacez le type par requête partagée, définissez la description sur Nombre de machines virtuelles par type de système d’exploitation et définissez l’abonnement pour spécifier l’emplacement où la ressource de requête est créée.

6. Cochez la case Publier dans le groupe de ressources resource-graph-queries et définissez l'Emplacement du groupe de ressources sur (USA) USA Centre-Ouest.

7. Sélectionnez Enregistrer en bas du volet Enregistrer la requête . Le titre de l’onglet passe de la requête 1 au nombre de machines virtuelles par système d’exploitation. La première fois que le groupe de ressources resource-graph-queries est utilisé, l’enregistrement prend plus de temps que prévu à mesure que le groupe de ressources est créé.

   

   Note

   Vous pouvez décocher la case Publier dans le groupe de ressources resource-graph-query si vous souhaitez fournir le nom d’un groupe de ressources existant dans lequel enregistrer la requête partagée. L’utilisation du groupe de ressources nommé par défaut pour les requêtes facilite la découverte des requêtes partagées. Il rend également l’objectif de ce groupe de ressources plus apparent. Toutefois, vous pouvez choisir de sélectionner un groupe de ressources existant pour des raisons de sécurité en fonction des autorisations existantes.

8. Quittez l’Explorateur Azure Resource Graph dans le portail Azure, puis revenez-y. Notez que la requête enregistrée n’est plus affichée et que l’onglet Requête 1 a retourné.

9. Sélectionnez Ouvrir une requête. Vérifiez que le type est défini sur Requête partagée et que la combinaison d’abonnement et de groupe de ressources correspond à l’emplacement où vous avez enregistré la requête. L’élément Count VMs by OS enregistré apparaît désormais dans la liste Nom de la requête . Sélectionnez le lien de titre de la requête enregistrée pour le charger dans un nouvel onglet avec le nom de cette requête. En tant que requête partagée, elle affiche une icône dans l’onglet en regard du titre, indiquant qu’elle est partagée.

   

   Note

   Lorsqu’une requête enregistrée est ouverte et que l’onglet affiche son nom, le bouton Enregistrer le met à jour avec les modifications apportées. Pour créer une requête enregistrée, sélectionnez Enregistrer sous et continuez comme si vous enregistrez une nouvelle requête.

Découvrir des requêtes partagées

Étant donné qu’une requête partagée est une ressource Resource Manager, il existe plusieurs façons de en trouver une :

• À partir de l’Explorateur Resource Graph. Sélectionnez Ouvrir une requête et définissez le type sur Requête partagée.
• À partir de la page du portail des requêtes Resource Graph.
• À partir du groupe de ressources dans lequel la requête partagée a été enregistrée.
• Via une requête vers Resource Graph.

Afficher les requêtes du Graphique de ressources

Dans le portail Azure, la page requêtes Resource Graph affiche les requêtes partagées auxquelles le compte connecté a accès. Cette page active le filtrage par nom, abonnement, groupe de ressources et autres propriétés de la requête Resource Graph. Vous pouvez également baliser, exporter et supprimer des requêtes Resource Graph à l’aide de cette interface.

La sélection de l’une des requêtes ouvre la page de requête Resource Graph. Comme d’autres ressources Resource Manager, cette page offre une vue d’ensemble interactive avec le journal d’activité, le contrôle d’accès et les balises. Vous pouvez également appliquer un verrou de ressource directement à partir de cette page.

Accédez à la page requêtes Resource Graph dans le menu du portail en sélectionnant Tous les services ou en utilisant la zone de recherche Azure en haut de toutes les pages. Recherchez et sélectionnez l’Explorateur de Graphique des Ressources.

Répertorier les ressources des groupes de ressources

La requête Resource Graph est répertoriée en même temps que d’autres ressources qui font partie d’un groupe de ressources. La sélection de la requête Resource Graph ouvre la page de cette requête. Les points de suspension et les options du menu contextuel, accessible en sélectionnant et en maintenant l’appui (ou via un clic droit), fonctionnent de la même manière que sur la page Requête Resource Graph.

Interroger Resource Graph

Vous trouverez des requêtes Resource Graph par le biais d’une requête vers Resource Graph. La requête Resource Graph suivante limite par type Microsoft.ResourceGraph/queries, puis utilise project pour répertorier uniquement le nom, l’heure modifié et la requête elle-même :

Resources
| where type == "microsoft.resourcegraph/queries"
| project name, properties.timeModified, properties.query

Exécuter une requête partagée

Une requête partagée Resource Graph peut être exécutée avec la {{shared-query-uri}} syntaxe (préversion). Pour plus d’informations, consultez la syntaxe de requête partagée.

Supprimer une requête partagée

Si une requête partagée n’est plus nécessaire, supprimez-la. En supprimant une requête partagée, vous supprimez la ressource Resource Manager correspondante. Les tableaux de bord sur lesquels le graphique de résultats avait été épinglé affichent désormais un message d’erreur. Lorsque ce message d’erreur s’affiche, utilisez le bouton Supprimer du tableau de bord pour nettoyer votre tableau de bord.

Vous pouvez supprimer une requête partagée via les interfaces suivantes :

• Page Requêtes Resource Graph
• Page de requête Resource Graph
• Page Ouvrir une requête dans l’Explorateur Resource Graph
• Page Groupes de ressources

Nettoyer les ressources

Une fois ce didacticiel terminé, supprimez les requêtes privées et partagées que vous avez créées si vous ne le souhaitez plus.

Étapes suivantes

Dans ce tutoriel, vous avez créé des requêtes privées et partagées. Pour en savoir plus sur la langue Resource Graph, passez à la page de détails du langage de requête.