Início Rápido: Executar uma consulta do Resource Graph usando a CLI do Azure

Artigo
12/04/2024

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

Pré-requisitos

Se você ainda 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 do Resource Graph.
Um ambiente de shell bash em que 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 faça consultas a recursos usando o Azure Resource Graph, a extensão do Resource Graph deve estar 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.

Listar as extensões e versões disponíveis:
```
az extension list-available --output table
```
Instalar 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, acesse Usar e gerenciar extensões com a CLI do Azure.

Conectar-se 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 para sua assinatura. Substitua <subscriptionID> por sua ID da assinatura 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 os name e type de cada recurso. Para consultar por grupo de gerenciamento ou assinatura, use os argumentos --management-groups ou --subscriptions.

Executar 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 propriedade name:
```
az graph query --graph-query 'Resources | project name, type | limit 5 | order by name asc'
```
Como na consulta anterior, se você executar essa consulta várias vezes, poderá obter um conjunto diferente de recursos para cada solicitação. A ordem dos comandos de consulta é importante. Neste exemplo, o order by vem após o limit. A consulta limita os resultados a cinco recursos e, em seguida, ordena esses resultados por nome.
Atualize a consulta para order by a propriedade name 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 várias vezes sem alterações em seu ambiente, os resultados serão consistentes e ordenados pela propriedade name, mas ainda limitados a cinco resultados. A consulta ordena os resultados por nome e, em seguida, limita a saída a cinco recursos.

Limpar os recursos

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

az extension remove --name resource-graph

Para sair da sessão da CLI do Azure:

az logout

Próximas etapas

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

Noções básicas sobre a linguagem de consulta do Azure Resource Graph

Compartilhar via