Tutorial: Criar e compartilhar uma consulta do Azure Resource Graph no portal do Azure

O Gerenciador do Azure Resource Graph permite salvar suas consultas do Resource Graph diretamente no portal do Azure. Há dois tipos de consultas: Privadas e Compartilhadas. Uma consulta privada é salva nas configurações do portal do Azure. Já uma consulta compartilhada é um recurso do Azure Resource Manager que pode ser gerenciado com o RBAC (controle de acesso baseado em função) do Azure e protegido com bloqueios de recurso. Os dois tipos de consultas são criptografados em repouso.

Ao salvar consultas no portal do Azure, você economiza o tempo que poderia gastar procurando suas consultas favoritas ou comumente usadas. Ao compartilhar consultas, você ajuda sua equipe a atingir metas de consistência e eficiência por meio da repetição.

Neste tutorial, você concluirá as seguintes tarefas:

Pré-requisitos

Para concluir este tutorial, você precisa de uma assinatura do Azure. Se você não tiver uma, crie uma conta gratuita antes de começar.

Criar e excluir uma consulta privada

As consultas privadas são acessíveis e visíveis apenas para a conta que as cria. Como elas são salvas nas configurações do portal do Azure de uma conta, elas podem ser criadas, usadas e excluídas somente de dentro do portal do Azure. Uma consulta privada não é um recurso do Resource Manager. Para criar uma nova consulta privada, siga estas etapas:

1. No menu do portal, selecione Todos os serviços ou use a caixa de pesquisa do Azure na parte superior de todas as páginas. Pesquise e selecione Resource Graph Explorer.

2. Na guia Consulta 1 na página do Azure Resource Graph Explorer, insira a seguinte consulta:

   Resources
   | where type =~ 'Microsoft.Compute/virtualMachines'
   | summarize count() by tostring(properties.storageProfile.osDisk.osType)
   

   Selecione Executar consulta para ver os resultados da consulta no painel inferior.

   Para obter mais informações sobre essa consulta, consulte Exemplos – Contar máquinas virtuais por tipo de sistema operacional.

3. Selecione Salvar ou Salvar como, insira Contagem de VMs pelo SISTEMA Operacional como o nome, deixe o tipo como consulta privada e, em seguida, selecione Salvar na parte inferior do painel Salvar consulta . O título da guia muda da Consulta 1 para a Contagem de VMs por sistema operacional.

4. Afaste-se do Azure Resource Graph Explorer no portal do Azure e retorne a ele. Observe que a consulta salva não é mais exibida e a guia Consulta 1 foi retornada.

5. Selecione Abrir uma consulta. Verifique se o tipo é consulta privada. O nome salvo Contar VMs por SO agora aparece na lista Nome da Consulta. Quando você seleciona o link de título da consulta salva, ele é carregado em uma nova guia com o nome dessa consulta.

   Observação

   Quando uma consulta salva é aberta e a guia mostra seu nome, a seleção do botão Salvar a atualiza com todas as alterações que foram feitas. Para criar uma nova consulta salva dessa consulta aberta, selecione Salvar como e prossiga como se estivesse salvando uma nova consulta.

6. Para excluir a consulta salva, selecione Abrir uma consulta novamente e verifique se o campo Tipo está definido como consulta privada. Na linha da consulta salva Count VMs by OS , selecione Excluir (ícone da lixeira). Na caixa de diálogo de confirmação, selecione Sim para concluir a exclusão da consulta. Em seguida, feche o painel Abrir uma consulta .

Criar uma consulta compartilhada

Ao contrário de uma consulta privada, uma consulta compartilhada é um recurso do Resource Manager. Esse fato significa que a consulta é salva em um grupo de recursos, pode ser gerenciada e controlada com o RBAC do Azure e pode até ser protegida com bloqueios de recursos. Como um recurso, qualquer pessoa que tenha as permissões apropriadas pode vê-lo e usá-lo. Para criar uma nova consulta compartilhada, siga estas etapas:

1. No menu do portal, selecione Todos os serviços ou use a caixa de pesquisa do Azure na parte superior de todas as páginas para pesquisar e selecionar o Gerenciador do Resource Graph.

2. Na guia Consulta 1 na página do Azure Resource Graph Explorer, insira a seguinte consulta:

   Resources
   | where type =~ 'Microsoft.Compute/virtualMachines'
   | summarize count() by tostring(properties.storageProfile.osDisk.osType)
   

   Selecione Executar consulta para ver os resultados da consulta no painel inferior.

   Para obter mais informações sobre essa consulta, consulte Exemplos – Contar máquinas virtuais por tipo de sistema operacional.

3. Selecione Salvar ou Salvar como.

   

4. No painel Salvar consulta, insira Contagem de VMs por sistema operacional como nome.

5. Altere o tipo para consulta compartilhada, defina a descrição como Contagem de máquinas virtuais por tipo de SO e defina Assinatura para especificar onde o recurso da consulta é criado.

6. Deixe a caixa de seleção Publicar no grupo de recursos resource-graph-queries marcada e a Localização do Grupo de Recursos definida como (EUA) Centro-oeste dos EUA.

7. Selecione Salvar na parte inferior do painel Salvar consulta . O título da guia muda da Consulta 1 para a Contagem de VMs por sistema operacional. Na primeira vez que o grupo de recursos resource-graph-queries é usado, o salvamento leva mais tempo do que o esperado, pois o grupo de recursos está sendo criado.

   

   Observação

   Se desejar fornecer o nome de um grupo de recursos existente no qual salvar a consulta compartilhada, você poderá desmarcar a caixa de seleção Publicar no grupo de recursos resource-graph-queries. Usar o grupo de recursos nomeado padrão para consultas facilita a descoberta de consultas compartilhadas. Isso também torna a finalidade desse grupo de recursos mais aparente. No entanto, você pode optar por selecionar um grupo de recursos existente por motivos de segurança com base nas permissões existentes.

8. Afaste-se do Azure Resource Graph Explorer no portal do Azure e retorne a ele. Observe que a consulta salva não é mais exibida e a guia Consulta 1 foi retornada.

9. Selecione Abrir uma consulta. Verifique se o tipo está definido como consulta compartilhada e se a combinação de assinatura e grupo de recursos corresponde ao local em que você salvou a consulta. O item Contar VMs por SO salvo agora aparece na lista Nome da Consulta. Selecione o link de título da consulta salva para carregá-la em uma nova guia com o nome dessa consulta. Como uma consulta compartilhada, ela exibe um ícone na guia ao lado do título, indicando-o como compartilhado.

   

   Observação

   Quando uma consulta salva é aberta e a guia mostra seu nome, o botão Salvar a atualiza com todas as alterações que foram feitas. Para criar uma nova consulta salva, selecione Salvar como e prossiga como se estivesse salvando uma nova consulta.

Descobrir consultas compartilhadas

Como uma consulta compartilhada é um recurso do Resource Manager, há várias maneiras de encontrar uma:

• No Resource Graph Explorer, Selecione Abrir uma consulta e defina o tipo como Consulta compartilhada.
• Na página do portal de consultas do Resource Graph.
• No grupo de recursos em que a consulta compartilhada foi salva.
• Por meio de uma consulta ao Resource Graph.

Exibir consultas do Resource Graph

No portal do Azure, a página de consultas do Resource Graph exibe consultas compartilhadas às quais a conta conectada tem acesso. Esta página habilita a filtragem por nome, assinatura, grupo de recursos e outras propriedades da consulta do Resource Graph. Você também pode marcar, exportar e excluir consultas do Resource Graph usando essa interface.

Selecionar uma das consultas abre a página de consulta do Resource Graph. Assim como outros recursos do Resource Manager, esta página oferece uma visão geral interativa juntamente com o log de atividades, controle de acesso e marcas. Você também pode aplicar um bloqueio de recurso diretamente nesta página.

Acesse a página de consultas do Resource Graph no menu do portal selecionando Todos os serviços ou usando a caixa de pesquisa do Azure na parte superior de todas as páginas. Pesquise pelo Resource Graph Explorer e selecione-o.

Listar recursos de grupos de recursos

A consulta do Resource Graph é listada junto com outros recursos que fazem parte de um grupo de recursos. Selecionar a consulta do Resource Graph abre a página para essa consulta. As opções de menu de atalho e reticências, que você pode disparar selecionando e pressionando (ou clicando com o botão direito do mouse), funcionam da mesma forma que na página de consulta do Resource Graph.

Grafo de recursos de consulta

Você pode encontrar consultas do Resource Graph através de uma pesquisa no Resource Graph. A consulta do Resource Graph a seguir limita por tipo Microsoft.ResourceGraph/queriese, em seguida, usa project para listar apenas o nome, o tempo modificado e a consulta em si:

Resources
| where type == "microsoft.resourcegraph/queries"
| project name, properties.timeModified, properties.query

Executar uma consulta compartilhada

Uma consulta compartilhada do Resource Graph pode ser executada com a {{shared-query-uri}} sintaxe (versão prévia). Para obter mais informações, consulte a sintaxe de consulta compartilhada.

Excluir uma consulta compartilhada

Se uma consulta compartilhada não for mais necessária, exclua-a. Excluindo uma consulta compartilhada, você remove o recurso correspondente do Resource Manager. Todos os painéis aos quais o gráfico de resultados foi fixado agora exibem uma mensagem de erro. Quando essa mensagem de erro for exibida, use o botão Remover do painel para limpar o painel.

Você pode excluir uma consulta compartilhada por meio das seguintes interfaces:

• Página de consultas do Resource Graph
• Página de consulta do Resource Graph
• A página Abrir uma consulta no Explorador do Resource Graph
• Página de grupos de recursos

Limpar os recursos

Quando terminar este tutorial, exclua as consultas privadas e compartilhadas que você criou se não quiser mais.

Próximas etapas

Neste tutorial, você criou consultas privadas e compartilhadas. Para saber mais sobre o idioma do Resource Graph, continue para a página de detalhes da linguagem de consulta.