Rychlý start: Vytvoření sdíleného dotazu Resource Graphu pomocí Azure CLI

Článek
06/28/2024

Tento rychlý start popisuje, jak vytvořit sdílený dotaz Azure Resource Graphu pomocí Azure CLI a rozšíření Resource Graph. Příkazy az graph shared-query jsou experimentální funkcí az graph query.

Sdílený dotaz můžete spustit z Azure CLI pomocí experimentálních příkazů funkce nebo můžete sdílený dotaz spustit z webu Azure Portal. Sdílený dotaz je objekt Azure Resource Manageru, kterému můžete udělit oprávnění nebo ho spustit v Azure Resource Graph Exploreru. Po dokončení můžete rozšíření Resource Graph odebrat.

Požadavky

Pokud nemáte účet Azure, vytvořte si bezplatný účet před tím, než začnete.
Azure CLI musí mít pro rozšíření Resource Graph verzi 2.22.0 nebo vyšší.
Prostředí prostředí Bash, ve kterém můžete spouštět příkazy Azure CLI. Například Git Bash v relaci terminálu editoru Visual Studio Code .

Instalace rozšíření

Pokud chcete azure CLI povolit dotazování prostředků pomocí Azure Resource Graphu, musí být nainstalované rozšíření Resource Graph. Při prvním spuštění dotazu s az graph výzvou se zobrazí výzva k instalaci rozšíření. V opačném případě proveďte ruční instalaci pomocí následujícího postupu.

Uveďte dostupná rozšíření a verze:

az extension list-available --output table

Rozšíření nainstalujte:
```
az extension add --name resource-graph
```
Ověřte, že se rozšíření nainstalovalo:
```
az extension list --output table
```
Zobrazení syntaxe rozšíření:
```
az graph query --help
```

Další informace o rozšířeních Azure CLI najdete v tématu Použití a správa rozšíření pomocí Azure CLI.

Připojení k Azure

Z relace terminálu editoru Visual Studio Code se připojte k Azure. Pokud máte více než jedno předplatné, spusťte příkazy pro nastavení kontextu pro vaše předplatné. <subscriptionID> nahraďte ID vašeho předplatného Azure.

az login

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

Vytvoření sdíleného dotazu

Vytvořte skupinu prostředků a sdílenou, která shrnuje počet všech prostředků seskupených podle umístění.

Vytvořte skupinu prostředků pro uložení sdíleného dotazu Azure Resource Graphu.
```
az group create --name "demoSharedQuery" --location westus2
```

Vytvořte sdílený dotaz.

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

Zobrazí seznam všech sdílených dotazů ve skupině prostředků.
```
az graph shared-query list --resource-group demoSharedQuery
```

Omezte výsledky na konkrétní sdílený dotaz.

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

Spuštění sdíleného dotazu

Ke spuštění sdíleného dotazu můžete použít syntaxi experimentální funkce Azure CLI nebo Azure Portal.

Použití experimentální funkce ke spuštění sdíleného dotazu

Spusťte sdílený dotaz v Azure CLI se {{shared-query-uri}} syntaxí v az graph query příkazu. Získáte ID prostředku sdíleného dotazu a uložíte ho do proměnné. Proměnná se použije při spuštění sdíleného dotazu.

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

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

Pomocí parametru subscriptions můžete omezit výsledky.

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

Spuštění sdíleného dotazu z portálu

Sdílený dotaz můžete ověřit pomocí Azure Resource Graph Exploreru. Pokud chcete změnit obor, použijte nabídku Obor na levé straně stránky.

Přihlaste se na portál Azure.
Do vyhledávacího pole v horní části stránky zadejte graf zdrojů.
Vyberte Průzkumníka služby Resource Graph.
Vyberte Otevřít dotaz.
Změňte typ na sdílené dotazy.
Vyberte počet virtuálních počítačů podle operačního systému.
Na kartě Výsledky vyberte Spustit dotaz a výstup zobrazení.
Vyberte Grafy a pak vyberte Mapovat a zobrazte mapu polohy.

Můžete také spustit dotaz ze skupiny prostředků.

V Azure přejděte do skupiny prostředků demoSharedQuery.
Na kartě Přehled vyberte počet virtuálních počítačů podle operačního systému.
Vyberte kartu Výsledky.
Vyberte Grafy a pak vyberte Mapovat a zobrazte mapu polohy.

Vyčištění prostředků

Odebrání sdíleného dotazu:

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

Po odstranění skupiny prostředků se odstraní skupina prostředků a všechny její prostředky. Odebrání skupiny prostředků:

az group delete --name demoSharedQuery

Rozšíření Resource Graph odeberete spuštěním následujícího příkazu:

az extension remove --name resource-graph

Odhlášení z relace Azure CLI:

az logout

Další kroky

V tomto rychlém startu jste přidali rozšíření Resource Graph do prostředí Azure CLI a vytvořili sdílený dotaz. Další informace o jazyce Resource Graph najdete na stránce podrobností dotazovacího jazyka.

Principy dotazovacího jazyka služby Azure Resource Graph

Sdílet prostřednictvím