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

O Azure Resource Graph Explorer permite que você salve suas consultas do Resource Graph diretamente no portal do Azure. Existem dois tipos de consultas: Privadas e Partilhadas. Uma consulta privada é salva nas configurações do portal do Azure. Enquanto uma consulta compartilhada é um recurso do Azure Resource Manager que pode ser gerenciado com o controle de acesso baseado em função do Azure (Azure RBAC) e protegido com bloqueios de recursos. Ambos os 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, precisa de uma subscrição do Azure. Se 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. À medida que são guardados nas definições do portal do Azure de uma conta, podem ser criados, utilizados e eliminados apenas a partir do portal do Azure. Uma consulta privada não é um recurso do Resource Manager. Para criar uma nova consulta privada, siga estes passos:

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. Procure e selecione Resource Graph Explorer.

2. Na guia Consulta 1 na página 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 Contar VMs por sistema operacional como o nome, deixe o tipo como Consulta privada e selecione Salvar na parte inferior do painel de consulta Salvar. O título da guia muda de Consulta 1 para Contar VMs por SO.

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 retornou.

5. Selecione Abrir uma consulta. Certifique-se de que o tipo é Consulta privada. O nome salvo Contar VMs por sistema operacional 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.

   Nota

   Quando uma consulta salva é aberta e a guia mostra seu nome, selecionar o botão Salvar a atualiza com quaisquer alterações que tenham sido feitas. Para criar uma nova consulta salva a partir dessa consulta aberta, selecione Salvar como e prossiga como se estivesse salvando uma consulta nova.

6. Para excluir a consulta salva, selecione Abrir uma consulta novamente e verifique se o campo Tipo está definido como Consulta particular. 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 Gerenciador de recursos. 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 recurso, qualquer pessoa que tenha as permissões apropriadas pode vê-lo e usá-lo. Para criar uma nova consulta partilhada, siga estes passos:

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 Gerenciador de Gráficos de Recursos.

2. Na guia Consulta 1 na página 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 de consulta Salvar, insira Contar VMs por sistema operacional para o nome.

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

6. Deixe a caixa de seleção Publicar no grupo de recursos de consultas de gráficos de recursos marcada e o local do Grupo de Recursos definido como (EUA) Centro-Oeste dos EUA.

7. Selecione Salvar na parte inferior do painel de consulta Salvar. O título da guia muda de Consulta 1 para Contar VMs por SO. Na primeira vez que o grupo de recursos resource-graph-queries é usado, a gravação leva mais tempo do que o esperado à medida que o grupo de recursos é criado.

   

   Nota

   Você pode desmarcar a caixa de seleção Publicar no grupo de recursos de consultas de gráficos de recursos se quiser fornecer o nome de um grupo de recursos existente no qual salvar a consulta compartilhada. O uso do grupo de recursos nomeado padrão para consultas facilita a descoberta de consultas compartilhadas. Também torna mais evidente a finalidade desse grupo de recursos. 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 retornou.

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 onde você salvou a consulta. O item Contar VMs salvas por sistema operacional 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, ele exibe um ícone na guia ao lado do título, indicando-o como compartilhado.

   

   Nota

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

Descubra consultas compartilhadas

Como uma consulta compartilhada é um recurso do Gerenciador de Recursos, há várias maneiras de localizar uma:

• Do Resource Graph Explorer. Selecione Abrir uma consulta e defina o tipo como Consulta compartilhada.
• Na página do portal de consultas do Gráfico de Recursos.
• A partir do grupo de recursos em que a consulta Partilhada foi guardada.
• Através de uma consulta ao Resource Graph.

Exibir consultas do Gráfico de Recursos

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

A seleção de uma das consultas abre a página de consulta do Gráfico de Recursos. Como outros recursos do Resource Manager, esta página oferece uma visão geral interativa, juntamente com o registro de atividades, controle de acesso e tags. Você também pode aplicar um bloqueio de recurso diretamente desta página.

Vá para a página de consultas do Gráfico de Recursos 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. Procure e selecione Resource Graph Explorer.

Listar recursos de grupos de recursos

A consulta Gráfico de Recursos é listada juntamente com outros recursos que fazem parte de um grupo de recursos. Selecionar a consulta Gráfico de Recursos abre a página dessa consulta. As opções de reticências e menu de atalho, acionadas por selecionar e segurar (ou clicar com o botão direito do mouse), funcionam da mesma forma que na página de consulta Gráfico de Recursos.

Gráfico de recursos de consulta

Você pode encontrar consultas do Gráfico de Recursos por meio de uma consulta ao Gráfico de Recursos. A consulta Gráfico de Recursos a seguir limita por tipo Microsoft.ResourceGraph/queriese, em seguida, usa project para listar apenas o nome, a hora de modificação e a própria consulta:

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

Executar uma consulta compartilhada

Uma consulta compartilhada do Gráfico de Recursos pode ser executada com a {{shared-query-uri}} sintaxe (visualização). Para obter mais informações, consulte Sintaxe de consulta compartilhada.

Excluir uma consulta compartilhada

Se uma consulta compartilhada não for mais necessária, exclua-a. Ao excluir uma consulta compartilhada, você remove o recurso correspondente do Gerenciador de Recursos. Todos os painéis nos 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 através das seguintes interfaces:

• Página de consultas do Gráfico de Recursos
• Página de consulta do Gráfico de Recursos
• A página Abrir uma consulta no Resource Graph Explorer
• Página de grupos de recursos

Clean up resources (Limpar recursos)

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

Próximos passos

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