Tutorial: Creación y uso compartido de una consulta de Azure Resource Graph en Azure Portal

El Explorador de Azure Resource Graph le permite guardar las consultas de Resource Graph directamente en Azure Portal. Hay dos tipos de consultas: Privada y Compartida. Una consulta privada se guarda en la configuración de Azure Portal. Mientras que una consulta compartida es un recurso de Azure Resource Manager que se puede administrar con el control de acceso basado en rol de Azure (Azure RBAC) y protegido con bloqueos de recursos. Ambos tipos de consultas se cifran en reposo.

Al guardar consultas en Azure Portal, se ahorra el tiempo que podría dedicar a buscar las consultas favoritas o usadas habitualmente. Al compartir consultas, ayudará a su equipo a lograr objetivos de coherencia y eficiencia a través de la repetición.

En este tutorial, completará las siguientes tareas:

Prerrequisitos

Para completar este tutorial, necesita una suscripción de Azure. Si no tienes una, crea una cuenta gratuita antes de empezar.

Creación y eliminación de una consulta privada

Las consultas privadas son accesibles y solo son visibles para la cuenta que las crea. A medida que se guardan en la configuración de Azure Portal de una cuenta, solo se pueden crear, usar y eliminar desde Azure Portal. Una consulta privada no es un recurso de Resource Manager. Para crear una nueva consulta privada, siga estos pasos:

1. En el menú del portal, seleccione Todos los servicios o use el cuadro de búsqueda de Azure en la parte superior de todas las páginas. Busque y, a continuación, seleccione Explorador de Resource Graph.

2. En la pestaña Consulta 1 de la página Explorador de Azure Resource Graph, escriba la consulta siguiente:

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

   Seleccione Ejecutar consulta para ver los resultados de la consulta en el panel inferior.

   Para obtener más información sobre esta consulta, consulte Ejemplos: recuento de máquinas virtuales por tipo de sistema operativo.

3. Seleccione Guardar o Guardar como, escriba Recuento de máquinas virtuales por sistema operativo como nombre, deje el tipo como Consulta privada y, a continuación, seleccione Guardar en la parte inferior del panel Guardar consulta . El título de la pestaña cambia de Consulta 1 a Recuento de máquinas virtuales por sistema operativo.

4. Aléjese del Azure Resource Graph Explorer en el portal de Azure y luego regrese a él. Observe que la consulta guardada ya no se muestra y se ha devuelto la pestaña Consulta 1 .

5. Seleccione Abrir una consulta. Asegúrese de que el tipo es Consulta privada. El nombre guardado Count VMs by OS (Recuento de máquinas virtuales por sistema operativo) ahora aparece en la lista Nombre de la consulta. Al seleccionar el vínculo de título de la consulta guardada, se carga en una nueva pestaña con el nombre de esa consulta.

   Nota:

   Cuando se abre una consulta guardada y la pestaña muestra su nombre, al seleccionar el botón Guardar se actualiza con los cambios realizados. Para crear una nueva consulta guardada desde esta consulta abierta, seleccione Guardar como y continúe como si guardara una consulta nueva.

6. Para eliminar la consulta guardada, seleccione Abrir una consulta de nuevo y compruebe que el campo Tipo está establecido en Consulta privada. En la fila de la consulta guardada Count VMs by OS , seleccione Eliminar (icono de papelera de reciclaje). En el cuadro de diálogo de confirmación, seleccione Sí para terminar de eliminar la consulta. A continuación, cierre el panel Abrir una consulta .

Creación de una consulta compartida

A diferencia de una consulta privada, una consulta compartida es un recurso de Resource Manager. Esto significa que la consulta se guarda en un grupo de recursos, se puede administrar y controlar con RBAC de Azure e incluso se puede proteger con bloqueos de recursos. Como recurso, cualquiera que tenga los permisos adecuados puede verlo y usarlo. Para crear una nueva consulta compartida, siga estos pasos:

1. En el menú del portal, seleccione Todos los servicios o use el cuadro de búsqueda de Azure en la parte superior de todas las páginas para buscar y seleccionar Resource Graph Explorer.

2. En la pestaña Consulta 1 de la página Explorador de Azure Resource Graph, escriba la consulta siguiente:

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

   Seleccione Ejecutar consulta para ver los resultados de la consulta en el panel inferior.

   Para obtener más información sobre esta consulta, consulte Ejemplos: recuento de máquinas virtuales por tipo de sistema operativo.

3. Seleccione Guardar o Guardar como.

   

4. En el panel Guardar consulta , escriba Count VMs by OS (Recuento de máquinas virtuales por sistema operativo ) como nombre.

5. Cambie el tipo a Consulta compartida, establezca la descripción en Recuento de máquinas virtuales por tipo de sistema operativo y establezca Suscripción para especificar dónde se crea el recurso de consulta.

6. Deje activada la casilla de verificación Publicar en el grupo de recursos resource-graph-queries y el campo Ubicación del grupo de recursos establecido en (EE. UU.) Centro-oeste de EE. UU..

7. Seleccione Guardar en la parte inferior del panel Guardar consulta . El título de la pestaña cambia de Consulta 1 a Recuento de máquinas virtuales por sistema operativo. La primera vez que se utiliza el grupo de recursos resource-graph-queries, el guardado tarda más de lo previsto mientras se crea el grupo de recursos.

   

   Nota:

   Puede desactivar la casilla Publicar en el grupo de recursos resource-graph-queries si desea proporcionar el nombre de un grupo de recursos existente en el que guardar la consulta compartida. El uso del grupo de recursos con nombre predeterminado para las consultas facilita la detección de consultas compartidas. También hace que el propósito de ese grupo de recursos sea más evidente. Sin embargo, puede optar por seleccionar un grupo de recursos existente por motivos de seguridad en función de los permisos existentes.

8. Aléjese del Azure Resource Graph Explorer en el portal de Azure y luego regrese a él. Observe que la consulta guardada ya no se muestra y se ha devuelto la pestaña Consulta 1 .

9. Seleccione Abrir una consulta. Compruebe que el tipo está establecido en Consulta compartida y la combinación de suscripción y grupo de recursos coinciden donde guardó la consulta. El elemento Count VMs by OS guardado aparece ahora en la lista Nombre de consulta . Seleccione el vínculo de título de la consulta guardada para cargarla en una nueva pestaña con el nombre de esa consulta. Como consulta compartida, muestra un icono en la pestaña situada junto al título, lo que lo indica como compartido.

   

   Nota:

   Cuando se abre una consulta guardada y la pestaña muestra su nombre, el botón Guardar lo actualiza con los cambios realizados. Para crear una nueva consulta guardada, seleccione Guardar como y continúe como si guardara una consulta nueva.

Detección de consultas compartidas

Dado que una consulta compartida es un recurso de Resource Manager, hay varias maneras de encontrar una:

• Desde el Explorador de Resource Graph. Seleccione Abrir una consulta y establezca el tipo en Consulta compartida.
• En la página del portal de consultas de Resource Graph.
• En el grupo de recursos en el que se guardó la consulta compartida.
• Mediante una consulta a Resource Graph.

Visualización de consultas de Resource Graph

En Azure Portal, en la página Consultas de Resource Graph se muestran consultas compartidas a las que tiene acceso la cuenta de inicio de sesión. Esta página habilita el filtrado por nombre, suscripción, grupo de recursos y otras propiedades de la consulta de Resource Graph. También puede etiquetar, exportar y eliminar consultas de Resource Graph mediante esta interfaz.

Al seleccionar una de las consultas, se abre la página de consulta de Resource Graph. Al igual que otros recursos de Resource Manager, esta página ofrece información general interactiva junto con el registro de actividad, el control de acceso y las etiquetas. También puede aplicar un bloqueo de recursos directamente desde esta página.

Vaya a la página Consultas de Resource Graph desde el menú del portal; para ello, seleccione Todos los servicios o mediante el cuadro de búsqueda de Azure en la parte superior de todas las páginas. Busque y seleccione Explorador de Resource Graph.

Enumerar recursos de grupos de recursos

La consulta de Resource Graph se muestra junto con otros recursos que forman parte de un grupo de recursos. Al seleccionar la consulta de Resource Graph, se abre la página de esa consulta. Los puntos suspensivos y las opciones del menú contextual, activadas al seleccionar y mantener presionado (o hacer clic con el botón derecho), funcionan igual que en la página de consulta de Resource Graph.

Gráfico de recursos de consulta

Puede localizar consultas de Resource Graph mediante una consulta a este servicio. La siguiente consulta de Resource Graph limita por tipo Microsoft.ResourceGraph/queriesy, a continuación, usa project para enumerar solo el nombre, la hora modificada y la propia consulta:

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

Ejecución de una consulta compartida

Una consulta compartida de Resource Graph se puede ejecutar con la {{shared-query-uri}} sintaxis (versión preliminar). Para obtener más información, consulte Sintaxis de consulta compartida.

Eliminación de una consulta compartida

Si ya no se necesita una consulta compartida, elimínela. Al eliminar una consulta compartida, se quita el recurso de Resource Manager correspondiente. Los paneles en los que se ancló el gráfico de resultados ahora muestran un mensaje de error. Cuando se muestre ese mensaje de error, use el botón Quitar del panel para limpiar el panel.

Puede eliminar una consulta compartida a través de las interfaces siguientes:

• Página de consultas de Resource Graph
• Página de consulta de Resource Graph
• La página Abrir una consulta en el Explorador de Resource Graph
• Página Grupos de recursos

Limpieza de recursos

Cuando haya terminado con este tutorial, elimine las consultas privadas y compartidas que creó si ya no las desea.

Pasos siguientes

En este tutorial, usted ha creado consultas Privadas y Compartidas. Para más información sobre el lenguaje Resource Graph, continúe con la página de detalles del lenguaje de consulta.