Início Rápido: Criar uma consulta partilhada Resource Graph com a CLI do Azure

Artigo
06/01/2023

O primeiro passo para utilizar o Azure Resource Graph com a CLI do Azure é verificar se a extensão está instalada. Este início rápido explica-lhe o processo para adicionar a extensão à instalação da CLI do Azure. Pode utilizar a extensão com a CLI do Azure instalada localmente ou através do Azure Cloud Shell.

No final deste processo, terá adicionado a extensão à instalação da CLI do Azure à sua escolha e criar uma consulta Resource Graph partilhada.

Pré-requisitos

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

Adicionar a extensão do Resource Graph

Para permitir que a CLI do Azure funcione com o Azure Resource Graph, a extensão tem de ser adicionada. Esta extensão funciona onde quer que a CLI do Azure possa ser utilizada, incluindo bash no Windows 10, Cloud Shell (autónomo e no portal), a imagem do Docker da CLI do Azure, ou instalada localmente.

Verifique se a CLI do Azure mais recente está instalada (pelo menos , 2.8.0). Se não estiver ainda instalado, siga estas instruções.
No ambiente de eleição da CLI do Azure, utilize az extension add para importar a extensão Resource Graph com o seguinte comando:
```
# Add the Resource Graph extension to the Azure CLI environment
az extension add --name resource-graph
```

Confirme que a extensão foi instalada e que é a versão esperada (pelo menos 1.1.0) com az extension list:

# 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

Criar uma consulta partilhada Resource Graph

Com a extensão da CLI do Azure adicionada ao seu ambiente de eleição, está na altura de Resource Graph consulta partilhada. A consulta partilhada é um objeto Resource Manager do Azure ao qual pode conceder permissão ou executar no Explorador de Resource Graph do Azure. A consulta resume a contagem de todos os recursos agrupados por localização.

Crie um grupo de recursos com az group create para armazenar a consulta partilhada Resource Graph do Azure. Este grupo de recursos tem o nome resource-graph-queries e a localização é westus2.
```
# Login first with az login if not using Cloud Shell

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

Crie a consulta partilhada Resource Graph do Azure com a extensão e o graph comando 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'

Liste as consultas partilhadas no novo grupo de recursos. O comando az graph shared-query list devolve uma matriz de valores.

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

Para obter apenas um único resultado de consulta partilhada, utilize o comando 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'

Execute a consulta partilhada na CLI do Azure com a {{shared-query-uri}} sintaxe num comando de consulta az graph . Primeiro, copie o id campo do resultado do comando anterior show . Substitua shared-query-uri o texto no exemplo pelo valor do id campo, mas deixe o ambiente {{ e }} os carateres.
```
# Run a Azure Resource Graph shared query
az graph query --graph-query "{{shared-query-uri}}"
```
Nota

A {{shared-query-uri}} sintaxe é uma funcionalidade de Pré-visualização .

Outra forma de encontrar Resource Graph consultas partilhadas é através do portal do Azure. No portal, utilize a barra de pesquisa para procurar "Resource Graph consultas". Selecione a consulta partilhada. Na página Descrição geral , o separador Consulta apresenta a consulta guardada. O botão Editar abre-o no Resource Graph Explorer.

Limpar os recursos

Se quiser remover o Resource Graph consulta partilhada, grupo de recursos e extensão do ambiente da CLI do Azure, pode fazê-lo com os seguintes comandos:

# 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

Passos seguintes

Neste início rápido, adicionou a extensão Resource Graph ao ambiente da CLI do Azure e criou uma consulta partilhada. Para saber mais sobre o idioma Resource Graph, avance para a página de detalhes da linguagem de consulta.

Obter mais informações sobre a linguagem de consulta

Share via