Ler em inglês

Compartilhar via

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

  • Artigo

Este início rápido descreve como criar uma consulta compartilhada do Azure Resource Graph com a CLI do Azure e a extensão do Resource Graph. Os comandos az graph shared-query são um recurso experimental da consulta az graph.

Uma consulta partilhada pode ser executada a partir da CLI do Azure com os comandos da funcionalidade experimental, ou pode executar a consulta partilhada a partir do portal Azure. A consulta compartilhada é um objeto do Azure Resource Manager ao qual você pode conceder permissão ou o qual você pode executar no Explorador do Azure Resource Graph. Ao concluir, você pode remover a extensão do Resource Graph.

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.

  1. Listar as extensões e versões disponíveis:

    CLI do Azure 
    az extension list-available --output table

  2. Instalar a extensão:

    CLI do Azure 
    az extension add --name resource-graph

  3. Verifique se a extensão foi instalada:

    CLI do Azure 
    az extension list --output table

  4. Exiba a sintaxe da extensão:

    CLI do Azure 
    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.

CLI do Azure 
az login

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

Criar uma consulta compartilhada

Crie um grupo de recursos e um compartilhado que resume a contagem de todos os recursos agrupados por local.

  1. Crie um grupo de recursos para armazenar a consulta compartilhada do Azure Resource Graph.

    CLI do Azure 
    az group create --name "demoSharedQuery" --location westus2

  2. Crie a consulta compartilhada.

    CLI do Azure 
    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 demoSharedQuery

  3. Liste todas as consultas compartilhadas no grupo de recursos.

    CLI do Azure 
    az graph shared-query list --resource-group demoSharedQuery

  4. Limite os resultados a uma consulta compartilhada específica.

    CLI do Azure 
    az graph shared-query show --resource-group "demoSharedQuery" \
  --name "Summarize resources by location"

Executar a consulta compartilhada

Você pode usar a sintaxe de recurso experimental da CLI do Azure ou o portal do Azure para executar a consulta compartilhada.

Usar o recurso experimental para executar a consulta compartilhada

Execute a consulta compartilhada na CLI do Azure com a sintaxe {{shared-query-uri}} em um comando az graph query. Você obtém a ID do recurso da consulta compartilhada e a armazena em uma variável. A variável é usada quando você executa a consulta compartilhada.

CLI do Azure 
sharedqueryid=$(az graph shared-query show --resource-group "demoSharedQuery" \
  --name "Summarize resources by location" \
  --query id \
  --output tsv)

az graph query --graph-query "{{$sharedqueryid}}"

Você pode usar o parâmetro subscriptions para limitar os resultados.

CLI do Azure 
az graph query --graph-query "{{$sharedqueryid}}" --subscriptions 11111111-1111-1111-1111-111111111111

Executar a consulta compartilhada no portal

Você pode verificar se a consulta compartilhada funciona usando o Azure Resource Graph Explorer. Para alterar o escopo, use o menu Escopo no lado esquerdo da página.

  1. Entre no portal do Azure.
  2. Insira o grafo de recursos no campo de pesquisa na parte superior da página.
  3. Selecione Resource Graph Explorer.
  4. Selecione Abrir consulta.
  5. Altere Tipo para Consultas compartilhadas.
  6. Selecione a consulta Contar VMs por SO.
  7. Selecione Executar consulta e a saída da exibição na guia Resultados.
  8. Selecione Gráficos e selecione Mapa para exibir o mapa de localização.

Você também pode executar a consulta em seu grupo de recursos.

  1. No Azure, vá para o grupo de recursos, demoSharedQuery.
  2. Na guia Visão geral, selecione a consulta Contar VMs por SO.
  3. Selecione a guia Resultados.
  4. Selecione Gráficos e selecione Mapa para exibir o mapa de localização.

Limpar os recursos

Para remover a consulta compartilhada:

CLI do Azure 
az graph shared-query delete --name "Summarize resources by location" --resource-group demoSharedQuery

Quando um grupo de recursos é excluído, o grupo de recursos e todos os seus recursos são excluídos. Para remover o grupo de recursos:

CLI do Azure 
az group delete --name demoSharedQuery

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

CLI do Azure 
az extension remove --name resource-graph

Para sair da sessão da CLI do Azure:

CLI do Azure 
az logout

Próximas etapas

Neste guia de início rápido, você adicionou a extensão do Resource Graph ao ambiente da CLI do Azure e criou uma consulta compartilhada. 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