Snabbstart: Skapa resursdiagram med delad fråga med Hjälp av Azure CLI

Artikel
06/28/2024

Den här snabbstarten beskriver hur du skapar en delad Azure Resource Graph-fråga med Azure CLI och Resource Graph-tillägget. Kommandona az graph shared-query är en experimentell funktion i az graph-frågan.

En delad fråga kan köras från Azure CLI med den experimentella funktionens kommandon, eller så kan du köra den delade frågan från Azure-portalen. En delad fråga är ett Azure Resource Manager-objekt som du kan bevilja behörighet till eller köra i Azure Resource Graph Explorer. När du är klar kan du ta bort Resource Graph-tillägget.

Förutsättningar

Om du inte har något Azure-konto skapar du ett kostnadsfritt konto innan du börjar.
Azure CLI måste vara version 2.22.0 eller senare för Resource Graph-tillägget.
En Bash-gränssnittsmiljö där du kan köra Azure CLI-kommandon. Till exempel Git Bash i en terminalsession i Visual Studio Code .

Installera tillägget

För att Azure CLI ska kunna köra frågor mot resurser med Hjälp av Azure Resource Graph måste Resource Graph-tillägget installeras. Första gången du kör en fråga med az graph en fråga visas för att installera tillägget. Annars använder du följande steg för att göra en manuell installation.

Visa en lista över tillgängliga tillägg och versioner:
```
az extension list-available --output table
```
Installera tillägget:
```
az extension add --name resource-graph
```
Kontrollera att tillägget har installerats:
```
az extension list --output table
```
Visa tilläggets syntax:
```
az graph query --help
```

Mer information om Azure CLI-tillägg finns i Använda och hantera tillägg med Azure CLI.

Ansluta till Azure

Anslut till Azure från en terminalsession i Visual Studio Code. Om du har fler än en prenumeration kör du kommandona för att ange kontext till din prenumeration. Ersätt <subscriptionID> med ditt Azure-prenumerations-ID.

az login

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

Skapa en delad fråga

Skapa en resursgrupp och en delad som sammanfattar antalet resurser grupperade efter plats.

Skapa en resursgrupp för att lagra den delade Azure Resource Graph-frågan.
```
az group create --name "demoSharedQuery" --location westus2
```

Skapa den delade frågan.

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

Visa en lista över alla delade frågor i resursgruppen.

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

Begränsa resultatet till en specifik delad fråga.

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

Kör den delade frågan

Du kan använda den experimentella funktionssyntaxen för Azure CLI eller Azure-portalen för att köra den delade frågan.

Använda experimentell funktion för att köra delad fråga

Kör den delade frågan i Azure CLI med syntaxen {{shared-query-uri}} i ett az graph query kommando. Du får resurs-ID för din delade fråga och lagrar den i en variabel. Variabeln används när du kör den delade frågan.

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

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

Du kan använda parametern subscriptions för att begränsa resultatet.

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

Kör den delade frågan från portalen

Du kan kontrollera att den delade frågan fungerar med Azure Resource Graph Explorer. Om du vill ändra omfånget använder du omfångsmenyn till vänster på sidan.

Logga in på Azure-portalen.
Ange resursdiagrammet i sökfältet överst på sidan.
Välj Resource Graph Explorer.
Välj Öppna fråga.
Ändra Typ till Delade frågor.
Välj frågan Räkna virtuella datorer efter operativsystem.
Välj Kör fråga och visa utdata på fliken Resultat .
Välj Diagram och välj sedan Mappa för att visa platskartan.

Du kan också köra frågan från resursgruppen.

I Azure går du till resursgruppen demoSharedQuery.
På fliken Översikt väljer du frågan Räkna virtuella datorer efter operativsystem.
Välj fliken Resultat .
Välj Diagram och välj sedan Mappa för att visa platskartan.

Rensa resurser

Så här tar du bort den delade frågan:

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

När en resursgrupp tas bort tas resursgruppen och alla dess resurser bort. Så här tar du bort resursgruppen:

az group delete --name demoSharedQuery

Om du vill ta bort Resource Graph-tillägget kör du följande kommando:

az extension remove --name resource-graph

Logga ut från Azure CLI-sessionen:

az logout

Nästa steg

I den här snabbstarten lade du till Resource Graph-tillägget i Azure CLI-miljön och skapade en delad fråga. Om du vill veta mer om resource graph-språket fortsätter du till informationssidan för frågespråket.

Förstå frågespråket för Azure Resource Graph

Dela via