Rychlý start: Spuštění dotazu Resource Graphu pomocí Azure CLI

Tento rychlý start popisuje, jak spustit dotaz Azure Resource Graphu pomocí rozšíření pro Azure CLI. Článek také ukazuje, jak seřadit (seřadit) a omezit výsledky dotazu. Můžete spustit dotaz na prostředky ve vašem tenantovi, skupinách pro správu nebo předplatných. Až budete hotovi, můžete rozšíření 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šší.
• Visual Studio Code.

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>

Instalace rozšíření

Pokud chcete azure CLI povolit dotazování prostředků pomocí Azure Resource Graphu, musí být nainstalované rozšíření Resource Graph. Rozšíření můžete nainstalovat ručně pomocí následujícího postupu. Jinak se při prvním spuštění dotazu zobrazí az graph výzva k instalaci rozšíření.

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

   az extension list-available --output table
   

2. Rozšíření nainstalujte:

   az extension add --name resource-graph
   

3. Ověřte, že se rozšíření nainstalovalo:

   az extension list --output table
   

4. 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.

Spuštění dotazu

Po přidání rozšíření Azure CLI do vašeho prostředí můžete spustit dotaz založený na tenantovi. Dotaz v tomto příkladu vrátí pět prostředků Azure s každým prostředkem name a type z každého prostředku. K dotazování podle skupiny pro správu nebo předplatného použijte argumenty --management-groups nebo --subscriptions argumenty.

1. Spusťte dotaz Azure Resource Graphu:

   az graph query --graph-query 'Resources | project name, type | limit 5'
   

   Tento příklad dotazu nepoužívá modifikátor řazení, jako je order by. Pokud dotaz spustíte několikrát, může pro každý požadavek přinést jinou sadu prostředků.

2. Aktualizujte dotaz na order byname vlastnost:

   az graph query --graph-query 'Resources | project name, type | limit 5 | order by name asc'
   

   Stejně jako u předchozího dotazu, pokud tento dotaz spustíte několikrát, může pro každý požadavek přinést jinou sadu prostředků. Pořadí příkazů dotazů je důležité. V tomto příkladu order by přichází po limit. Dotaz omezuje výsledky na pět prostředků a pak tyto výsledky seřídí podle názvu.

3. Aktualizujte dotaz na order byname vlastnost a pak limit výstup na pět výsledků:

   az graph query --graph-query 'Resources | project name, type | order by name asc | limit 5'
   

   Pokud se tento dotaz spustí několikrát beze změn vašeho prostředí, výsledky jsou konzistentní a seřazené name podle vlastnosti, ale stále jsou omezené na pět výsledků. Dotaz seřídí výsledky podle názvu a pak omezí výstup na pět prostředků.

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

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 spustili dotazy Azure Resource Graphu pomocí rozšíření pro Azure CLI. Další informace najdete v článku s podrobnostmi o dotazovacím jazyce.

Principy dotazovacího jazyka služby Azure Resource Graph