Zelfstudie: Een Azure Resource Graph-query maken en delen in Azure Portal

Met Azure Resource Graph Explorer kunt u uw Resource Graph-query's rechtstreeks opslaan in Azure Portal. Er zijn twee typen query's: Privé en Gedeeld. Een privéquery wordt opgeslagen in de instellingen van de Azure-portal. Een gedeelde query is een Azure Resource Manager-resource die kan worden beheerd met op rollen gebaseerd toegangsbeheer van Azure (Azure RBAC) en beveiligd met resourcevergrendelingen. Beide typen query's worden in rusttoestand versleuteld.

Door query's op te slaan in Azure Portal, bespaart u de tijd die u anders zou besteden aan het zoeken naar uw favoriete of veelgebruikte query's. Wanneer u query's deelt, helpt u uw team bij het realiseren van doelstellingen van consistentie en efficiëntie door middel van herhaling.

In deze zelfstudie voert u de volgende taken uit:

Vereiste voorwaarden

U hebt een Azure-abonnement nodig om deze zelfstudie te voltooien. Als u nog geen account hebt, maakt u een gratis account voordat u begint.

Een privéquery maken en verwijderen

Privéquery's zijn alleen toegankelijk en zichtbaar voor het account waarmee ze worden gemaakt. Wanneer ze worden opgeslagen in de Azure Portal-instellingen van een account, kunnen ze alleen worden gemaakt, gebruikt en verwijderd vanuit Azure Portal. Een privéquery is geen Resource Manager-resource. Voer de volgende stappen uit om een nieuwe privéquery te maken:

1. Selecteer in het portalmenu Alle services of gebruik het zoekvak van Azure boven aan alle pagina's. Zoek en selecteer Resource Graph Explorer.

2. Voer op het tabblad Query 1 op de pagina Azure Resource Graph Explorer de volgende query in:

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

   Selecteer Query uitvoeren om de queryresultaten weer te geven in het onderste deelvenster.

   Zie Voorbeelden - Aantal virtuele machines per type besturingssysteem voor meer informatie over deze query.

3. Selecteer Opslaan of Opslaan als, voer aantal VM's per besturingssysteem in als de naam, laat het type als privéquery staan en selecteer Opslaan onder aan het deelvenster Query opslaan . De titel van het tabblad verandert van Query 1 in Aantal VM's per besturingssysteem.

4. Ga weg van Azure Resource Graph Explorer in Azure Portal en ga vervolgens terug naar azure. U ziet dat de opgeslagen query niet meer wordt weergegeven en dat het tabblad Query 1 is geretourneerd.

5. Selecteer Een Query Openen. Zorg ervoor dat het type privéquery is. De opgeslagen naamaantal VM's per besturingssysteem wordt nu weergegeven in de lijst Querynaam . Wanneer u de titelkoppeling van de opgeslagen query selecteert, wordt deze geladen in een nieuw tabblad met de naam van die query.

   Opmerking

   Wanneer een opgeslagen query is geopend en op het tabblad de naam wordt weergegeven, wordt de knop Opslaan bijgewerkt met eventuele wijzigingen die zijn aangebracht. Als u een nieuwe opgeslagen query wilt maken op basis van deze geopende query, selecteert u Opslaan als en gaat u verder alsof u een gloednieuwe query opslaat.

6. Als u de opgeslagen query wilt verwijderen, selecteert u Opnieuw een query openen en controleert u of het veld Type is ingesteld op Persoonlijke query. Selecteer Count VMs by OS (prullenbakpictogram) in de rij van de opgeslagen query. Selecteer Ja in het bevestigingsdialoogvenster om de query te verwijderen. Sluit vervolgens het deelvenster 'Een query openen'.

Een gedeelde query maken

In tegenstelling tot een privéquery is een gedeelde query een Resource Manager-resource. Dit betekent dat de query wordt opgeslagen in een resourcegroep, kan worden beheerd en gecontroleerd met Azure RBAC, en zelfs kan worden beschermd met resource locks. Als resource kan iedereen met de juiste machtigingen deze zien en gebruiken. Voer de volgende stappen uit om een nieuwe gedeelde query te maken:

1. Selecteer alle services in het portalmenu of gebruik het Zoekvak van Azure boven aan alle pagina's om Resource Graph Explorer te zoeken en te selecteren.

2. Voer op het tabblad Query 1 op de pagina Azure Resource Graph Explorer de volgende query in:

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

   Selecteer Query uitvoeren om de queryresultaten weer te geven in het onderste deelvenster.

   Zie Voorbeelden - Aantal virtuele machines per type besturingssysteem voor meer informatie over deze query.

3. Selecteer Opslaan of Opslaan als.

   

4. Voer in het deelvenster Query opslaanhet aantal VM's per besturingssysteem in voor de naam.

5. Wijzig het type in Gedeelde query, stel de beschrijving in op Aantal virtuele machines op type besturingssysteem en stel Abonnement in om op te geven waar de queryresource wordt gemaakt.

6. Laat het selectievakje Publiceren naar resourcegrafiekquery's in de resourcegroep ingeschakeld en de locatie van de resourcegroep is ingesteld op (US) VS - west-centraal.

7. Selecteer Opslaan onderaan het deelvenster Query opslaan. De titel van het tabblad verandert van Query 1 in Aantal VM's per besturingssysteem. De eerste keer dat de resource-graph-queries resourcegroep wordt gebruikt, duurt het opslaan langer dan verwacht omdat de resourcegroep wordt aangemaakt.

   

   Opmerking

   Schakel het selectievakje Publiceren naar resourcegrafiekquery's uit als u de naam van een bestaande resourcegroep wilt opgeven om de gedeelde query op te slaan. Als u de standaard benoemde resourcegroep voor query's gebruikt, kunnen gedeelde query's gemakkelijker worden gedetecteerd. Het maakt ook het doel van die resourcegroep duidelijker. U kunt er echter voor kiezen om een bestaande resourcegroep te selecteren om beveiligingsredenen op basis van bestaande machtigingen.

8. Ga weg van Azure Resource Graph Explorer in Azure Portal en ga vervolgens terug naar azure. U ziet dat de opgeslagen query niet meer wordt weergegeven en dat het tabblad Query 1 is geretourneerd.

9. Selecteer Een Query Openen. Controleer of het type is ingesteld op Gedeelde query en of de combinatie van Abonnement en Resourcegroep overeenkomt met de locatie waar u de query hebt opgeslagen. Het opgeslagen aantal VM's per besturingssysteemitem wordt nu weergegeven in de lijst Querynaam . Selecteer de titelkoppeling van de opgeslagen query om deze te laden in een nieuw tabblad met de naam van die query. Als een gedeelde query wordt er een pictogram weergegeven op het tabblad naast de titel, die deze aangeeft als gedeeld.

   

   Opmerking

   Wanneer een opgeslagen query is geopend en op het tabblad de naam wordt weergegeven, wordt deze bijgewerkt met de knop Opslaan met eventuele wijzigingen die zijn aangebracht. Als u een nieuwe opgeslagen query wilt maken, selecteert u Opslaan als en gaat u door alsof u een gloednieuwe query opslaat.

Gedeelde queries ontdekken

Omdat een gedeelde query een Resource Manager-resource is, zijn er verschillende manieren om er een te vinden:

• Vanuit Resource Graph Explorer. Selecteer Een query openen en stel het type in op Gedeelde query.
• Op de portalpagina met Resource Graph-query's.
• Vanuit de resourcegroep waarin de gedeelde query is opgeslagen.
• Door middel van een query naar Resource Graph.

Resource Graph-queries weergeven

In de Azure-portal worden op de pagina Resource Graph-queries gedeelde query's weergegeven waartoe het aangemelde account toegang heeft. Op deze pagina kunt u filteren op naam, abonnement, resourcegroep en andere eigenschappen van de Resource Graph-query. U kunt ook Resource Graph-query's taggen, exporteren en verwijderen met behulp van deze interface.

Als u een van de query's selecteert, wordt de pagina Resource Graph-query geopend. Net als andere Resource Manager-resources biedt deze pagina een interactief overzicht, samen met het activiteitenlogboek, toegangsbeheer en tags. U kunt ook rechtstreeks vanaf deze pagina een resourcevergrendeling toepassen.

Ga naar de pagina Resource Graph-query's in het portalmenu door Alle services te selecteren of door het Zoekvak van Azure boven aan alle pagina's te gebruiken. Zoek en selecteer Resource Graph Explorer.

Resourcegroepenresources weergeven

De Resource Graph-query wordt weergegeven naast andere resources die deel uitmaken van een resourcegroep. Als u de Resource Graph-query selecteert, wordt de pagina voor die query geopend. De ellipsis en snelmenuopties, geactiveerd door selecteren en vasthouden (of klikken met de rechtermuisknop), werken op dezelfde manier als op de Resource Graph-querypagina.

Query's uitvoeren op Resource Graph

U kunt Resource Graph-query's vinden via een query naar Resource Graph. De volgende Resource Graph-query beperkt zich per type Microsoft.ResourceGraph/queries en wordt vervolgens gebruikt project om alleen de naam, het tijdstip van wijziging en de query zelf op te sommen:

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

Een gedeelde query uitvoeren

Een gedeelde Resource Graph-query kan worden uitgevoerd met de {{shared-query-uri}} syntaxis (preview). Zie de syntaxis van gedeelde query's voor meer informatie.

Een gedeelde query verwijderen

Als een gedeelde query niet meer nodig is, verwijdert u deze. Als u een gedeelde query verwijdert, verwijdert u de bijbehorende Resource Manager-resource. Dashboards waaraan de resultatengrafiek is vastgemaakt, geven nu een foutbericht weer. Wanneer dit foutbericht wordt weergegeven, gebruikt u de knop Verwijderen uit het dashboard om uw dashboard op te schonen.

U kunt een gedeelde query verwijderen via de volgende interfaces:

• pagina Resource Graph-queries
• De Resource Graph-querypagina
• De Openen van een query pagina in Resource Graph Explorer
• Pagina met resourcegroepen

De hulpbronnen opschonen

Wanneer u klaar bent met deze zelfstudie, verwijdert u de privé- en gedeelde query's die u hebt gemaakt als u ze niet meer wilt.

Volgende stappen

In deze handleiding hebt u privé- en gedeelde query's gemaakt. Ga naar de pagina met details over de querytaal om meer te leren over de Resource Graph-taal.