Quickstart: Gedeelde Resource Graph-query maken met behulp van Azure CLI

Artikel
06/28/2024

In deze quickstart wordt beschreven hoe u een gedeelde Azure Resource Graph-query maakt met Azure CLI en de Resource Graph-extensie. De opdrachten az graph shared-query zijn een experimentele functie van az graph-query.

Een gedeelde query kan worden uitgevoerd vanuit Azure CLI met de opdrachten van de experimentele functie of u kunt de gedeelde query uitvoeren vanuit Azure Portal. Een gedeelde query is een Azure Resource Manager-object dat u kunt machtigen of uitvoeren in Azure Resource Graph Explorer. Wanneer u klaar bent, kunt u de Resource Graph-extensie verwijderen.

Vereisten

Als u geen Azure-account hebt, maak dan een gratis account aan voordat u begint.
Azure CLI moet versie 2.22.0 of hoger zijn voor de Resource Graph-extensie.
Een Bash-shellomgeving waar u Azure CLI-opdrachten kunt uitvoeren. Git Bash bijvoorbeeld in een Visual Studio Code-terminalsessie .

De extensie installeren

Als u azure CLI wilt inschakelen om query's uit te voeren op resources met behulp van Azure Resource Graph, moet de Resource Graph-extensie zijn geïnstalleerd. De eerste keer dat u een query uitvoert met az graph een prompt, wordt weergegeven om de extensie te installeren. Gebruik anders de volgende stappen om een handmatige installatie uit te voeren.

Geef de beschikbare extensies en versies weer:
```
az extension list-available --output table
```
De extensie installeren:
```
az extension add --name resource-graph
```
Controleer of de extensie is geïnstalleerd:
```
az extension list --output table
```
De syntaxis van de extensie weergeven:
```
az graph query --help
```

Ga voor meer informatie over Azure CLI-extensies naar Extensies gebruiken en beheren met de Azure CLI.

Verbinding maken met Azure

Maak vanuit een Visual Studio Code-terminalsessie verbinding met Azure. Als u meer dan één abonnement hebt, voert u de opdrachten uit om context in te stellen op uw abonnement. Vervang <subscriptionID> door de id van uw Azure-abonnement.

az login

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

Een gedeelde query maken

Maak een resourcegroep en een gedeelde groep die het aantal resources samenvat dat is gegroepeerd op locatie.

Maak een resourcegroep om de gedeelde Azure Resource Graph-query op te slaan.
```
az group create --name "demoSharedQuery" --location westus2
```

Maak de gedeelde 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 demoSharedQuery

Alle gedeelde query's in de resourcegroep weergeven.

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

Beperk de resultaten tot een specifieke gedeelde query.

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

De gedeelde query uitvoeren

U kunt de experimentele azure CLI-functiesyntaxis of Azure Portal gebruiken om de gedeelde query uit te voeren.

Experimentele functie gebruiken om een gedeelde query uit te voeren

Voer de gedeelde query uit in Azure CLI met de {{shared-query-uri}} syntaxis in een az graph query opdracht. U krijgt de resource-id van uw gedeelde query en slaat deze op in een variabele. De variabele wordt gebruikt wanneer u de gedeelde query uitvoert.

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

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

U kunt de subscriptions parameter gebruiken om de resultaten te beperken.

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

De gedeelde query uitvoeren vanuit de portal

U kunt controleren of de gedeelde query werkt met behulp van Azure Resource Graph Explorer. Als u het bereik wilt wijzigen, gebruikt u het menu Bereik aan de linkerkant van de pagina.

Meld u aan bij het Azure Portal.
Voer resourcegrafiek in het zoekveld boven aan de pagina in.
Selecteer Resource Graph Explorer.
Select Query openen.
Wijzig Type in Gedeelde query's.
Selecteer de query Aantal VM's per besturingssysteem.
Selecteer Query uitvoeren en de weergave-uitvoer op het tabblad Resultaten .
Selecteer Grafieken en selecteer vervolgens Kaart om de locatiekaart weer te geven.

U kunt de query ook uitvoeren vanuit uw resourcegroep.

Ga in Azure naar de resourcegroep, demoSharedQuery.
Selecteer op het tabblad Overzicht de query Aantal VM's per besturingssysteem.
Selecteer het tabblad Resultaten .
Selecteer Grafieken en selecteer vervolgens Kaart om de locatiekaart weer te geven.

Resources opschonen

De gedeelde query verwijderen:

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

Wanneer een resourcegroep wordt verwijderd, worden de resourcegroep en alle bijbehorende resources verwijderd. Ga als volgt te werk om de resourcegroep te verwijderen:

az group delete --name demoSharedQuery

Voer de volgende opdracht uit om de Resource Graph-extensie te verwijderen:

az extension remove --name resource-graph

Afmelden bij uw Azure CLI-sessie:

az logout

Volgende stappen

In deze quickstart hebt u de Resource Graph-extensie toegevoegd aan uw Azure CLI-omgeving en een gedeelde query gemaakt. Ga verder naar de pagina met details van de querytaal voor meer informatie over de taal van Resource Graph.

Informatie over de querytaal van Azure Resource Graph

Delen via