O que é o Azure Resource Graph?

O Azure Resource Graph é um serviço do Azure projetado para estender o Gerenciamento de Recursos do Azure fornecendo exploração de recursos eficiente e com desempenho. O Resource Graph tem a capacidade de consultar em escala um determinado conjunto de assinaturas para que você possa governar efetivamente seu ambiente. Essas consultas fornecem as seguintes habilidades:

  • Consulte recursos com filtragem, agrupamento e classificação complexos por propriedades de recursos.
  • Explore recursos iterativamente com base em requisitos de governança.
  • Avalie o efeito da aplicação de políticas em um vasto ambiente de nuvem.
  • Consultar alterações feitas nas propriedades do recurso.

Nesta documentação, você revisa cada recurso em detalhes.

Nota

O Azure Resource Graph alimenta a barra de pesquisa do portal do Azure, a nova experiência de navegação Todos os recursos e a diferença visualdo histórico de alterações da Política do Azure. Ele foi projetado para ajudar os clientes a gerenciar ambientes de grande escala.

Nota

Este serviço dá suporte ao Azure Lighthouse, que permite que os provedores de serviços entrem em seu próprio locatário para gerenciar assinaturas e grupos de recursos que os clientes delegaram.

Como o Resource Graph complementa o Azure Resource Manager

Atualmente, o Azure Resource Manager dá suporte a consultas em campos de recursos básicos, especificamente:

  • Nome do recurso
  • ID
  • Tipo
  • Grupo de Recursos
  • Subscrição
  • Localização

O Azure Resource Manager também fornece recursos para chamar provedores de recursos individuais para propriedades detalhadas, um recurso de cada vez.

Com o Azure Resource Graph, pode aceder a estas propriedades devolvidas pelos fornecedores de recursos sem a necessidade de fazer chamadas individuais para cada fornecedor de recursos. Para consultar uma lista de tipos de recursos suportados, consulte a tabela e a referência de tipos de recursos. Uma forma alternativa de ver os tipos de recursos suportados é através do browser do esquema do Azure Resource Graph Explorer.

Com o Azure Resource Graph, você pode:

  • Acesse as propriedades retornadas pelos provedores de recursos sem precisar fazer chamadas individuais para cada provedor de recursos.
  • Veja os últimos 14 dias de alterações na configuração do recurso para ver quais propriedades foram alteradas e quando.

Nota

Como um recurso de visualização , alguns type objetos têm propriedades adicionais que não são do Gerenciador de Recursos disponíveis. Para obter mais informações, consulte Propriedades estendidas.

Como o Gráfico de Recursos é mantido atualizado

Quando um recurso do Azure é atualizado, o Azure Resource Manager notifica o Azure Resource Graph sobre a alteração. Em seguida, o Azure Resource Graph atualiza seu banco de dados. O Azure Resource Graph também faz uma análise completa regular. Essa verificação garante que os dados do Azure Resource Graph estejam atualizados se houver notificações perdidas. Ou quando um recurso é atualizado fora do Azure Resource Manager.

Importante

Os dados do Azure Resource Graph não são fortemente consistentes. Os dados são indexados com uma latência curta. Para mais informações e orientações sobre como gerir a consistência eventual, veja Escolha a estratégia de consulta certa para o Azure Resource Graph.

Nota

O Resource Graph usa uma GET para recolher propriedades e valores da interface de programação de aplicações (API) mais recente que não seja de pré-visualização de cada fornecedor de recursos. Como resultado, a propriedade esperada pode não estar disponível. Em alguns casos, a versão da API usada foi substituída para fornecer propriedades mais atuais ou amplamente utilizadas nos resultados. Consulte o exemplo Mostrar a versão da API para cada tipo de recurso para obter uma lista completa no seu ambiente.

Linguagem de consulta

Agora que você entendeu melhor o que é o Azure Resource Graph, vamos nos aprofundar em como construir consultas.

É importante entender que a linguagem de consulta do Azure Resource Graph é baseada na KQL (Kusto Query Language) usada pelo Azure Data Explorer.

Em primeiro lugar, para obter detalhes sobre operações e funções que podem ser utilizadas com o Azure Resource Graph, veja Linguagem de consulta do Resource Graph. Para procurar recursos, veja explorar recursos.

Permissões no Azure Resource Graph

Para utilizar o Resource Graph, tem de ter permissões adequadas no controlo de acesso baseado em funções do Azure (Azure RBAC), com, pelo menos, acesso de read aos recursos que pretende consultar. Nenhum resultado será retornado se você não tiver pelo menos read permissões para o objeto ou grupo de objetos do Azure.

Nota

O Resource Graph utiliza as subscrições disponíveis para um principal ao iniciar sessão. Para ver os recursos de uma nova assinatura adicionados durante uma sessão ativa, a entidade de segurança deve atualizar o contexto. Esta ação ocorre automaticamente ao terminar sessão e iniciar sessão novamente.

A CLI do Azure e o Azure PowerShell usam assinaturas às quais o usuário tem acesso. Quando você usa uma API REST, a lista de assinaturas é fornecida pelo usuário. Se o usuário tiver acesso a qualquer uma das assinaturas na lista, os resultados da consulta serão retornados para as assinaturas às quais o usuário tem acesso. Esse comportamento é o mesmo que ao chamar Grupos de Recursos - Lista porque você obtém grupos de recursos que você pode acessar, sem qualquer indicação de que o resultado pode ser parcial. Se não houver assinaturas na lista de assinaturas para as quais o usuário tenha direitos apropriados, a resposta será um 403 (Proibido).

Nota

Na versão pré-visualização da API REST 2020-04-01-preview, a lista de subscrições pode ser omitida. Quando as propriedades subscriptions e managementGroupId não estão definidas no pedido, o escopo é definido para o inquilino. Para obter mais informações, consulte Escopo da consulta.

Estrangulamento

Como um serviço gratuito, as consultas ao Resource Graph são limitadas para fornecer a melhor experiência e tempo de resposta para todos os clientes. Se a sua organização quiser utilizar a API do Resource Graph para consultas frequentes e em grande volume, utilize Feedback no portal do Resource Graph. Forneça o seu caso de negócio e selecione a caixa de verificação A Microsoft pode enviar-lhe um e-mail sobre os seus comentários para que a equipa possa contactá-lo.

O Gráfico de Recursos limita as consultas no nível do usuário. A resposta do serviço contém os seguintes cabeçalhos HTTP:

  • x-ms-user-quota-remaining (int): A cota de recursos restante para o usuário. Este valor corresponde ao número de consultas.
  • x-ms-user-quota-resets-after (hh:mm:ss): A duração do tempo até que o consumo de cota de um usuário seja redefinido

Para obter mais informações, consulte Diretrizes para pedidos sujeitos a limitação.

Executar a primeira consulta

O Explorador do Azure Resource Graph, parte do portal do Azure, permite executar as consultas do Resource Graph diretamente no portal do Azure. Afixe os resultados como gráficos dinâmicos para fornecer informações dinâmicas em tempo real ao fluxo de trabalho do portal. Para obter mais informações, aceda a Primeira consulta com o Azure Resource Graph Explorer.

O Resource Graph também dá suporte à CLI do Azure, ao Azure PowerShell e à API REST. A consulta está estruturada da mesma forma para cada linguagem. Saiba como ativar o Resource Graph com:

Integração de alertas com o Log Analytics

Nota

A integração de alertas do Azure Resource Graph com o Log Analytics está em pré-visualização pública.

Você pode criar regras de alerta usando consultas do Azure Resources Graph ou integrando o Log Analytics com consultas do Azure Resources Graph por meio do Azure Monitor. Ambos os métodos podem ser usados para criar alertas para recursos do Azure. Para obter exemplos, vá para Guia de início rápido: criar alertas com o Azure Resource Graph e o Log Analytics.

Executar consultas com o conector do Power BI

O conector do Power BI do Azure Resource Graph executa consultas no nível do locatário, mas você pode alterar o escopo para assinatura ou grupo de gerenciamento. O conector do Power BI tem uma configuração opcional para retornar todos os registros se os resultados da consulta tiverem mais de 1.000 registros. Para obter mais informações, aceda a Início Rápido: executar consultas com o conector do Azure Resource Graph para o Power BI.

Próximos passos

  • Last updated on