Guia de início rápido: executar a consulta do Gráfico de Recursos usando a CLI do Azure

Artigo
06/28/2024

Este guia de início rápido descreve como executar uma consulta do Azure Resource Graph usando a CLI do Azure e a extensão Resource Graph. O artigo também mostra como ordenar (classificar) e limitar os resultados da consulta. Você pode executar uma consulta de recursos em seu locatário, grupos de gerenciamento ou assinaturas. Quando terminar, você pode remover a extensão.

Pré-requisitos

Se não tiver uma conta do Azure, crie uma conta gratuita antes de começar.
A CLI do Azure deve ser a versão 2.22.0 ou superior para a extensão Resource Graph.
Um ambiente de shell Bash onde você pode executar comandos da CLI do Azure. Por exemplo, Git Bash em uma sessão de terminal do Visual Studio Code .

Instalar a extensão

Para permitir que a CLI do Azure consulte recursos usando o Azure Resource Graph, a extensão Resource Graph deve ser instalada. A primeira vez que você executa uma consulta com az graph um prompt é exibida para instalar a extensão. Caso contrário, use as etapas a seguir para fazer uma instalação manual.

Liste as extensões e versões disponíveis:

az extension list-available --output table

Instale a extensão:
```
az extension add --name resource-graph
```
Verifique se a extensão foi instalada:
```
az extension list --output table
```
Exiba a sintaxe da extensão:
```
az graph query --help
```
Para obter mais informações sobre as extensões da CLI do Azure, vá para Usar e gerenciar extensões com a CLI do Azure.

Ligar ao Azure

Em uma sessão de terminal do Visual Studio Code, conecte-se ao Azure. Se você tiver mais de uma assinatura, execute os comandos para definir o contexto da sua assinatura. Substitua <subscriptionID> pelo seu ID da subscrição do Azure.

az login

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

Executar uma consulta

Depois que a extensão da CLI do Azure for adicionada ao seu ambiente, você poderá executar uma consulta baseada em locatário. A consulta neste exemplo retorna cinco recursos do Azure com o name e type de cada recurso. Para consultar por grupo de gerenciamento ou assinatura, use os --management-groups argumentos ou --subscriptions .

Execute uma consulta do Azure Resource Graph:
```
az graph query --graph-query 'Resources | project name, type | limit 5'
```
Este exemplo de consulta não usa um modificador de classificação como order by. Se você executar a consulta várias vezes, ela poderá gerar um conjunto diferente de recursos para cada solicitação.
Atualize a consulta para order by a name propriedade:
```
az graph query --graph-query 'Resources | project name, type | limit 5 | order by name asc'
```
Como a consulta anterior, se você executar essa consulta várias vezes, ela poderá gerar um conjunto diferente de recursos para cada solicitação. A ordem dos comandos da consulta é importante. Neste exemplo, order by vem depois de limit, A consulta limita os resultados a cinco recursos e, em seguida, ordena esses resultados pelo nome.
Atualize a consulta para order by a name propriedade e, em seguida, limit a saída para cinco resultados:
```
az graph query --graph-query 'Resources | project name, type | order by name asc | limit 5'
```
Se essa consulta for executada name várias vezes sem alterações no seu ambiente, os resultados serão consistentes e ordenados pela propriedade, mas ainda limitados a cinco resultados. A consulta ordena os resultados por nome e, em seguida, limita a saída a cinco recursos.

Clean up resources (Limpar recursos)

Para remover a extensão Resource Graph, execute o seguinte comando:

az extension remove --name resource-graph

Para sair da sessão da CLI do Azure:

az logout

Próximos passos

Neste início rápido, você executou consultas do Azure Resource Graph usando a extensão para CLI do Azure. Para saber mais sobre a linguagem do Gráfico de Recursos, continue para a página de detalhes do idioma da consulta.

Compreender a linguagem de consulta do Azure Resource Graph

Partilhar via