Introducción al servicio Azure Resource GraphOverview of the Azure Resource Graph service

Azure Resource Graph es un servicio de Azure diseñado para extender Azure Resource Management; para ello, proporciona una exploración de recursos eficaz y de alto rendimiento con la capacidad de consultar a escala a través de un conjunto especificado de suscripciones para que pueda controlar eficazmente el entorno.Azure Resource Graph is a service in Azure that is designed to extend Azure Resource Management by providing efficient and performant resource exploration with the ability to query at scale across a given set of subscriptions so that you can effectively govern your environment. Estas consultas proporcionan las siguientes características:These queries provide the following features:

  • Capacidad para consultar recursos con propiedades complejas de filtrado, agrupación y ordenación por recursos.Ability to query resources with complex filtering, grouping, and sorting by resource properties.
  • Capacidad de explorar recursos de forma iterativa en función de los requisitos de gobernanza.Ability to iteratively explore resources based on governance requirements.
  • Capacidad de evaluar el impacto de aplicar directivas en un entorno de nube de gran capacidad.Ability to assess the impact of applying policies in a vast cloud environment.
  • Capacidad de detallar los cambios realizados en las propiedades de los recursos (versión preliminar).Ability to detail changes made to resource properties (preview).

En esta documentación, repasará cada característica en detalle.In this documentation, you'll go over each feature in detail.

Nota

Azure Resource Graph se usa en la barra de búsqueda de Azure Portal, en la nueva experiencia de exploración de "Todos los recursos" y en el historial de cambios diferencia visual de Azure Policy.Azure Resource Graph powers Azure portal's search bar, the new browse 'All resources' experience, and Azure Policy's Change history visual diff. Se ha diseñado para ayudar a los clientes a administrar entornos a gran escala.It's designed to help customers manage large-scale environments.

Nota

Este servicio admite la administración de recursos delegados de Azure, que permite a los proveedores de servicios administrar los recursos y las suscripciones que los clientes han delegado desde dentro del inquilino del proveedor de servicios.This service supports Azure Delegated Resource Management which lets service providers manage resources and subscriptions that customers have delegated from within the service provider's tenant. Para obtener más información, consulte Azure Lighthouse.For more info, see Azure Lighthouse.

Cómo Resource Graph complementa Azure Resource ManagerHow does Resource Graph complement Azure Resource Manager

Actualmente, Azure Resource Manager admite consultas sobre campos de recursos básicos, específicamente: nombre del recurso, identificador, tipo, grupo de recursos, suscripción y ubicación.Azure Resource Manager currently supports queries over basic resource fields, specifically - Resource name, ID, Type, Resource Group, Subscription, and Location. Resource Manager también proporciona los medios para llamar a proveedores de recursos individuales a fin de obtener las propiedades detalladas de los recursos de uno en uno.Resource Manager also provides facilities for calling individual resource providers for detailed properties one resource at a time.

Con Azure Resource Graph, puede tener acceso a estas propiedades que devuelven los proveedores de recursos sin necesidad de realizar llamadas individuales a cada proveedor de recursos.With Azure Resource Graph, you can access these properties the resource providers return without needing to make individual calls to each resource provider. Para obtener una lista de tipos de recurso compatibles, busque en la tabla Resources for complete mode deployments (Recursos para implementaciones en modo completo).For a list of supported resource types, look for a Yes in the Resources for complete mode deployments table. Los tipos de recursos adicionales se encuentran en las tablas relacionadas de Resource Graph.Additional resource types are found in the related Resource Graph tables. Una manera alternativa de ver los tipos de recursos admitidos es mediante el explorador de esquemas de Azure Resource Graph Explorer.An alternative way to see supported resource types is through the Azure Resource Graph Explorer Schema browser.

Con Azure Resource Graph, puede:With Azure Resource Graph, you can:

  • Acceder a las propiedades que devuelven los proveedores de recursos sin necesidad de realizar llamadas individuales a cada uno de ellos.Access the properties returned by resource providers without needing to make individual calls to each resource provider.
  • Ver los últimos 14 días del historial de cambios realizados en el recurso para ver qué propiedades cambiaron y cuándo lo hicieron.View the last 14 days of change history made to the resource to see what properties changed and when. (versión preliminar)(preview)

Cómo se mantiene actualizado Resource GraphHow Resource Graph is kept current

Cuando se actualiza un recurso de Azure, Resource Manager informa a Resource Graph del cambio.When an Azure resource is updated, Resource Graph is notified by Resource Manager of the change. A continuación, Resource Graph actualiza su base de datos.Resource Graph then updates its database. Resource Graph también realiza un examen completo regular.Resource Graph also does a regular full scan. Este examen garantiza que los datos de Resource Graph sean actuales en caso de que falten notificaciones o al actualizarse un recurso fuera de Resource Manager.This scan ensures that Resource Graph data is current if there are missed notifications or when a resource is updated outside of Resource Manager.

Nota

Resource Graph usa una operación GET en la API de la versión no preliminar más reciente de cada proveedor de recursos para recopilar propiedades y valores.Resource Graph uses a GET to the latest non-preview API of each resource provider to gather properties and values. Como resultado, es posible que la propiedad esperada no esté disponible.As a result, the property expected may not be available. En algunos casos, la versión de la API usada se ha invalidado para proporcionar propiedades más actuales o ampliamente utilizadas en los resultados.In some cases, the API version used has been overridden to provide more current or widely used properties in the results. Consulte el ejemplo de Mostrar la versión de API para cada tipo de recurso para obtener una lista completa de su entorno.See the Show API version for each resource type sample for a complete list in your environment.

El lenguaje de consultaThe query language

Ahora que comprende mejor qué es Azure Resource Graph, vamos a profundizar en cómo crear consultas.Now that you have a better understanding of what Azure Resource Graph is, let's dive into how to construct queries.

Es importante entender que el lenguaje de consulta de Azure Resource Graph se basa en el lenguaje de consulta de Kusto que usa Azure Data Explorer.It's important to understand that Azure Resource Graph's query language is based on the Kusto query language used by Azure Data Explorer.

En primer lugar, para obtener información sobre las operaciones y funciones que se pueden usar con Azure Resource Graph, consulte Lenguaje de consulta de Resource Graph.First, for details on operations and functions that can be used with Azure Resource Graph, see Resource Graph query language. Para examinar los recursos, consulte Explorar recursos.To browse resources, see explore resources.

Permisos en Azure Resource GraphPermissions in Azure Resource Graph

Para usar Resource Graph, debe tener los derechos adecuados en el Control de acceso basado en rol (RBAC) con al menos acceso de lectura a los recursos que quiera consultar.To use Resource Graph, you must have appropriate rights in Role-based access control (RBAC) with at least read access to the resources you want to query. Sin tener al menos permisos del tipo read para el objeto de Azure o el grupo de objetos, no se devolverán los resultados.Without at least read permissions to the Azure object or object group, results won't be returned.

Nota

Resource Graph usa las suscripciones disponibles de una entidad de seguridad durante el inicio de sesión.Resource Graph uses the subscriptions available to a principal during login. Para ver los recursos de una nueva suscripción que se agregan durante una sesión activa, la entidad de seguridad debe actualizar el contexto.To see resources of a new subscription added during an active session, the principal must refresh the context. Esta acción se produce automáticamente al cerrar sesión y volver a iniciarla posteriormente.This action happens automatically when logging out and back in.

La CLI de Azure y Azure PowerShell usan suscripciones a las que el usuario tiene acceso.Azure CLI and Azure PowerShell use subscriptions that the user has access to. Si se usa la API REST directamente, el usuario es quien proporciona la lista de suscripciones.When using REST API directly, the subscription list is provided by the user. Si el usuario tiene acceso a cualquiera de las suscripciones de la lista, los resultados de la consulta se devuelven a las suscripciones a las que el usuario tiene acceso.If the user has access to any of the subscriptions in the list, the query results are returned for the subscriptions the user has access to. Este comportamiento es el mismo que cuando se llama a Grupo de recursos: Lista -, se obtienen grupos de recursos a los que se tiene acceso sin indicar que el resultado puede ser parcial.This behavior is the same as when calling Resource Groups - List - you get resource groups you've access to without any indication that the result may be partial. Si no hay suscripciones en la lista de suscripciones para las que el usuario tiene los derechos adecuados, la respuesta es 403 (prohibido).If there are no subscriptions in the subscription list that the user has appropriate rights to, the response is a 403 (Forbidden).

LimitacionesThrottling

Como servicio gratuito, las consultas a Resource Graph se limitan para proporcionar la mejor experiencia y tiempo de respuesta para todos los clientes.As a free service, queries to Resource Graph are throttled to provide the best experience and response time for all customers. Si la organización quiere usar Resource Graph API para consultas frecuentes y a gran escala, use el portal "Comentarios" de la página Resource Graph del portal.If your organization wants to use the Resource Graph API for large-scale and frequent queries, use portal 'Feedback' from the Resource Graph portal page. Proporcione su caso de negocio y seleccione la casilla "Microsoft puede ponerse en contacto con usted por correo electrónico en relación con sus comentarios" para que el equipo pueda ponerse en contacto con usted.Provide your business case and select the 'Microsoft can email you about your feedback' checkbox in order for the team to contact you.

Resource Graph limita las consultas en el nivel de usuario.Resource Graph throttles queries at the user level. La respuesta del servicio contiene estos encabezados HTTP:The service response contains the following HTTP headers:

  • x-ms-user-quota-remaining (int): la cuota de recurso restante para el usuario.x-ms-user-quota-remaining (int): The remaining resource quota for the user. Este valor se asigna al número de consultas.This value maps to query count.
  • x-ms-user-quota-resets-after (hh:mm:ss): tiempo transcurrido hasta que se restablece el consumo de la cuota de un usuario.x-ms-user-quota-resets-after (hh:mm:ss): The time duration until a user's quota consumption is reset

Para más información, consulte Guía para soluciones limitadas.For more information, see Guidance for throttled requests.

Ejecución de la primera consultaRunning your first query

Azure Resource Graph Explorer, que forma parte de Azure Portal, permite ejecutar consultas de Resource Graph directamente en Azure Portal.Azure Resource Graph Explorer, part of Azure portal, enables running Resource Graph queries directly in Azure portal. Ancle los resultados como gráficos dinámicos para proporcionar información dinámica en tiempo real al flujo de trabajo del portal.Pin the results as dynamic charts to provide real-time dynamic information to your portal workflow. Para más información, consulte Primera consulta con Azure Resource Graph Explorer.For more information, see First query with Azure Resource Graph Explorer.

Resource Graph admite la CLI de Azure, Azure PowerShell, y el SDK para .NET de Azure, entre otros muchos.Resource Graph supports Azure CLI, Azure PowerShell, Azure SDK for .NET, and more. La consulta se estructura igual para cada lenguaje.The query is structured the same for each language. Aprenda a habilitar Resource Graph con:Learn how to enable Resource Graph with:

Pasos siguientesNext steps