Inicio rápido: Creación de una consulta compartida de Resource Graph mediante la CLI de Azure

Artículo
12/04/2024

En este inicio rápido se describe cómo crear una consulta compartida de Azure Resource Graph con la CLI de Azure y la extensión Resource Graph. Los comandos az graph shared-query son una característica experimental de az graph query.

Una consulta compartida se puede ejecutar desde la CLI de Azure con los comandos del experimental característica, o bien puede ejecutar la consulta compartida desde Azure Portal. Una consulta compartida es un objeto de Azure Resource Manager que puede conceder permiso a o ejecutar en el Explorador de Azure Resource Graph. Cuando termine, puede quitar la extensión Resource Graph.

Requisitos previos

Antes de comenzar, si no tiene una cuenta de Azure, cree una gratuita.
La CLI de Azure debe ser de la versión 2.22.0 o superior para la extensión de Resource Graph.
Un entorno de shell de Bash donde puede ejecutar comandos de la CLI de Azure. Por ejemplo, Git Bash en una sesión de terminal de Visual Studio Code.

Instale la extensión

Para permitir que la CLI de Azure consulte los recursos mediante Azure Resource Graph, se debe instalar la extensión de Resource Graph. La primera vez que ejecute una consulta con az graph se muestra un mensaje para instalar la extensión. De lo contrario, siga estos pasos para realizar una instalación manual.

Enumerar las extensiones y versiones disponibles:
```
az extension list-available --output table
```
Instale la extensión:
```
az extension add --name resource-graph
```
Comprobar que la extensión se instaló:
```
az extension list --output table
```
Mostrar la sintaxis de la extensión:
```
az graph query --help
```

Para más información sobre las extensiones de la CLI de Azure, vaya a Uso y administración de extensiones con la CLI de Azure.

Conexión con Azure

Desde una sesión de terminal de Visual Studio Code, conéctese a Azure. Si tiene más de una suscripción, ejecute los comandos para establecer el contexto en la suscripción. Reemplace <subscriptionID> con la identificación de su suscripción de Azure.

az login

# Run these commands if you have multiple subscriptions
az account list --output table
az account set --subscription <subscriptionID>

Creación de una consulta compartida

Cree un grupo de recursos y un recurso compartido que resuma el recuento de todos los recursos agrupados por ubicación.

Cree un grupo de recursos para almacenar la consulta compartida de Azure Resource Graph.
```
az group create --name "demoSharedQuery" --location westus2
```

Cree la consulta compartida.

az graph shared-query create --name "Summarize resources by location" \
  --description "This shared query summarizes resources by location for a pinnable map graphic." \
  --graph-query "Resources | summarize count() by location" \
  --resource-group demoSharedQuery

Enumere todas las consultas compartidas en el grupo de recursos.
```
az graph shared-query list --resource-group demoSharedQuery
```

Limite los resultados a una consulta compartida específica.

az graph shared-query show --resource-group "demoSharedQuery" \
  --name "Summarize resources by location"

Ejecución de la consulta compartida

Puede usar la sintaxis de características experimentales de la CLI de Azure o Azure Portal para ejecutar la consulta compartida.

Uso de la característica experimental para ejecutar consultas compartidas

Ejecute la consulta compartida en la CLI de Azure con la sintaxis {{shared-query-uri}} en un comando az graph query. Obtiene el identificador de recurso de la consulta compartida y lo almacena en una variable. La variable se usa al ejecutar la consulta compartida.

sharedqueryid=$(az graph shared-query show --resource-group "demoSharedQuery" \
  --name "Summarize resources by location" \
  --query id \
  --output tsv)

az graph query --graph-query "{{$sharedqueryid}}"

Puede usar el parámetro subscriptions para limitar los resultados.

az graph query --graph-query "{{$sharedqueryid}}" --subscriptions 11111111-1111-1111-1111-111111111111

Ejecución de la consulta compartida desde el portal

Puede comprobar que la consulta compartida funciona mediante el Explorador de Azure Resource Graph. Para cambiar el ámbito, use el menú Ámbito en el lado izquierdo de la página.

Inicie sesión en Azure Portal.
Escriba gráfico de recursos en el campo de búsqueda de la parte superior de la página.
Seleccione explorador de Resource Graph.
Seleccione Abrir consulta.
Cambie Tipo a Consultas compartidas.
Seleccione la consulta Recuento de máquinas virtuales por sistema operativo.
Seleccione Ejecutar consulta y la salida de la vista en la pestaña Resultados .
Selecciona Gráficos y, a continuación, selecciona Mapa para ver el mapa de ubicación.

También puede ejecutar la consulta desde el grupo de recursos.

En Azure, vaya al grupo de recursos demoSharedQuery.
En la pestaña Información general , seleccione la consulta Recuento de máquinas virtuales del sistema operativo .
Seleccione la pestaña Resultados.
Selecciona Gráficos y, a continuación, selecciona Mapa para ver el mapa de ubicación.

Limpieza de recursos

Para quitar la consulta compartida:

az graph shared-query delete --name "Summarize resources by location" --resource-group demoSharedQuery

Cuando se elimina un grupo de recursos, se eliminan el grupo de recursos y todos sus recursos. Para eliminar el grupo de recursos:

az group delete --name demoSharedQuery

Para eliminar la extensión de Resource Graph, ejecute el siguiente comando:

az extension remove --name resource-graph

Para cerrar la sesión de la CLI de Azure:

az logout

Pasos siguientes

En este inicio rápido, agregó la extensión Resource Graph al entorno de la CLI de Azure y creó una consulta compartida. Para más información sobre el lenguaje de Resource Graph, vaya a la página de detalles del lenguaje de consulta.

Información del lenguaje de consulta de Azure Resource Graph

Compartir a través de