Compartir a través de

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

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 de la característica experimental o 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

  • Si no tiene una cuenta de Azure, cree una cuenta gratuita antes de comenzar.
  • La CLI de Azure debe ser la versión 2.22.0 o posterior 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 .

Instalación de la extensión

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

  1. Enumerar las extensiones y versiones disponibles:

    az extension list-available --output table

  2. Instale la extensión:

    az extension add --name resource-graph

  3. Compruebe que la extensión se instaló:

    az extension list --output table

  4. Muestra 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.

  1. Cree un grupo de recursos para almacenar la consulta compartida de Azure Resource Graph.

    az group create --name "demoSharedQuery" --location westus2

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

  3. Enumere todas las consultas compartidas en el grupo de recursos.

    az graph shared-query list --resource-group demoSharedQuery

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

Ejecutar la consulta compartida en Azure CLI 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 subscriptions parámetro 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 del lado izquierdo de la página.

  1. Inicie sesión en Azure Portal.
  2. Escriba el gráfico de recursos en el campo de búsqueda de la parte superior de la página.
  3. Seleccione Explorador de Resource Graph.
  4. Seleccione Abrir consulta.
  5. Cambie Tipo a Consultas compartidas.
  6. Seleccione la consulta Resumir recursos por ubicación.
  7. Seleccione Ejecutar consulta y ver la salida en la pestaña Resultados.
  8. Seleccione Gráficos y, a continuación, seleccione Mapa para ver el mapa de ubicación.

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

  1. En Azure, vaya al grupo de recursos demoSharedQuery.
  2. En la pestaña Información general , seleccione la consulta Resumir recursos por ubicación.
  3. Seleccione la pestaña Resultados .
  4. Seleccione Gráficos y, a continuación, seleccione 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 quitar la extensión 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 Resource Graph, continúe con la página de detalles del lenguaje de consulta.

Descripción del lenguaje de consulta de Azure Resource Graph

  • Last updated on