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

Článek
06/01/2023

Prvním krokem při používání Azure Resource Graph s Azure CLI je kontrola, že je rozšíření nainstalované. Tento rychlý start vás provede procesem přidání rozšíření k instalaci rozhraní příkazového řádku Azure CLI. Rozšíření můžete použít pomocí Azure CLI nainstalované místně nebo prostřednictvím Azure Cloud Shell.

Na konci tohoto procesu přidáte rozšíření do zvolené instalace Azure CLI a vytvoříte Resource Graph sdílený dotaz.

Požadavky

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet před tím, než začnete.

Přidat rozšíření Resource Graph

Pokud chcete povolit, aby Rozhraní příkazového řádku Azure fungovalo s Azure Resource Graph, musí být rozšíření přidáno. Toto rozšíření funguje bez ohledu na to rozhraní příkazového řádku Azure je možné, včetně bash ve Windows 10, Cloud Shell (samostatné a uvnitř portálu), image Dockeru rozhraní příkazového řádku Azure, nebo lokálně nainstalované.

Zkontrolujte, že je nainstalované nejnovější Rozhraní příkazového řádku Azure (alespoň 2.8.0). Pokud ještě není nainstalovaný, postupujte podle těchto pokynů.
Ve zvoleném prostředí Azure CLI pomocí příkazu az extension add naimportujte rozšíření Resource Graph pomocí následujícího příkazu:
```
# Add the Resource Graph extension to the Azure CLI environment
az extension add --name resource-graph
```

Pomocí příkazu az extension list ověřte, že je rozšíření nainstalované a má očekávanou verzi (alespoň 1.1.0):

# Check the extension list (note that you may have other extensions installed)
az extension list

# Run help for graph query options
az graph query -h

Vytvoření Resource Graph sdíleného dotazu

S rozšířením Azure CLI přidaným do prostředí podle vašeho výběru je čas na Resource Graph sdílený dotaz. Sdílený dotaz je objekt Azure Resource Manager, ke kterému můžete udělit oprávnění nebo ho spustit v Azure Resource Graph Exploreru. Dotaz shrnuje počet všech prostředků seskupených podle umístění.

Pomocí příkazu az group create vytvořte skupinu prostředků pro uložení sdíleného dotazu Azure Resource Graph. Tato skupina prostředků má název resource-graph-queries a umístění je westus2.
```
# Login first with az login if not using Cloud Shell

# Create the resource group
az group create --name 'resource-graph-queries' --location 'westus2'
```

Vytvořte sdílený dotaz Azure Resource Graph pomocí graph rozšíření a příkazu az graph shared-query create:

# Create the Azure Resource Graph shared 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 'resource-graph-queries'

Vypište sdílené dotazy v nové skupině prostředků. Příkaz az graph shared-query list vrátí pole hodnot.

# List all the Azure Resource Graph shared queries in a resource group
az graph shared-query list --resource-group 'resource-graph-queries'

Pokud chcete získat jenom jeden výsledek sdíleného dotazu, použijte příkaz az graph shared-query show .

# Show a specific Azure Resource Graph shared query
az graph shared-query show --resource-group 'resource-graph-queries' \
   --name 'Summarize resources by location'

Spusťte sdílený dotaz v Azure CLI pomocí {{shared-query-uri}} syntaxe v příkazu az graph query . Nejprve zkopírujte id pole z výsledku předchozího show příkazu. Nahraďte shared-query-uri text v příkladu hodnotou z id pole, ale ponechte okolní {{ znaky a }} znaky.
```
# Run a Azure Resource Graph shared query
az graph query --graph-query "{{shared-query-uri}}"
```
Poznámka

Syntaxe {{shared-query-uri}} je funkce Preview .

Další způsob, jak najít Resource Graph sdílené dotazy, je Azure Portal. Na portálu pomocí panelu hledání vyhledejte "Resource Graph dotazy". Vyberte sdílený dotaz. Na stránce Přehled se na kartě Dotaz zobrazí uložený dotaz. Tlačítko Upravit ho otevře v Resource Graph Exploreru.

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

Pokud chcete z prostředí Azure CLI odebrat Resource Graph sdílený dotaz, skupinu prostředků a rozšíření, můžete to udělat pomocí následujících příkazů:

# Delete the Azure Resource Graph shared query
az graph shared-query delete --resource-group 'resource-graph-queries' \
   --name 'Summarize resources by location'

# Remove the resource group
# WARNING: This command deletes ALL resources you've added to this resource group without prompting for confirmation
az group delete --resource-group 'resource-graph-queries' --yes

# Remove the Azure Resource Graph extension from the Azure CLI environment
az extension remove -n resource-graph

Další kroky

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

Získání dalších informací o dotazovacím jazyce

Share via