Inicio rápido: Ejecución de la primera consulta de Resource Graph con la CLI de Azure

  • Artículo

El primer paso para usar Azure Resource Graph es comprobar que está instalada la extensión para la CLI de Azure. Esta guía de inicio rápido lo guiará a través del proceso de agregar la extensión a la instalación de la CLI de Azure. Puede usar la extensión con la CLI de Azure instalada localmente o mediante Azure Cloud Shell.

Al final de este proceso, habrá agregado la extensión a la instalación de la CLI de Azure que haya elegido y habrá ejecutado la primera consulta de Resource Graph.

Prerrequisitos

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

Incorporación de la extensión de Resource Graph

Para habilitar la CLI de Azure para consultar Azure Resource Graph, se debe agregar la extensión. Esta extensión funciona siempre que se puede usar la CLI de Azure, incluidos Bash en Windows 10, Cloud Shell (independiente y dentro del portal), la imagen de Docker de la CLI de Azure o instalado localmente.

  1. Compruebe que está instalada la versión más reciente de la CLI de Azure (al menos la 2.0.76). Si todavía no está instalado, siga estas instrucciones.

  2. En el entorno que prefiera de la CLI de Azure, impórtela con el siguiente comando:

    # Add the Resource Graph extension to the Azure CLI environment
az extension add --name resource-graph

  3. Compruebe que la extensión se ha instalado y que es la versión esperada (al menos 1.0.0):

    # Check the extension list (note that you may have other extensions installed)
az extension list

# Run help for graph query options
az graph query -h

Ejecutar la primera consulta de Resource Graph

Una vez agregada la extensión de la CLI de Azure al entorno de su elección, es el momento de probar una consulta sencilla de Resource Graph basada en un inquilino. La consulta devolverá los cinco primeros recursos de Azure con el nombre y el tipo de recurso de cada recurso. Para hacer una consulta por grupo de administración o suscripción, use los argumentos --managementgroups o --subscriptions.

  1. Ejecute la primera consulta de Azure Resource Graph mediante la extensión graph y el comando query:

    # Login first with az login if not using Cloud Shell

# Run Azure Resource Graph query
az graph query -q 'Resources | project name, type | limit 5'

    Nota

    Como esta consulta de ejemplo no proporciona un modificador de ordenación como order by, es probable que al ejecutar esta consulta varias veces se produzca un conjunto diferente de recursos por solicitud.

  2. Actualice la consulta para order by la propiedad Nombre:

    # Run Azure Resource Graph query with 'order by'
az graph query -q 'Resources | project name, type | limit 5 | order by name asc'

    Nota

    Al igual que con la primera consulta, es probable que al ejecutar esta consulta varias veces se produzca un conjunto diferente de recursos por solicitud. El orden de los comandos de consulta es importante. En este ejemplo, el order by viene después del limit. Este orden de comandos limita primero los resultados de la consulta y, luego, los ordena.

  3. Actualice la consulta para que primero se aplique order by a la propiedad Nombre y, después, limit a los cinco primeros resultados:

    # Run Azure Resource Graph query with `order by` first, then with `limit`
az graph query -q 'Resources | project name, type | order by name asc | limit 5'

Cuando la consulta final se ejecuta varias veces, suponiendo que nada cambie en su entorno, los resultados devueltos serán coherentes y estarán ordenados por la propiedad Nombre, pero todavía limitados a los cinco primeros resultados.

Limpieza de recursos

Si quiere quitar la extensión de Resource Graph de su entorno de la CLI de Azure, puede hacerlo mediante el comando siguiente:

# Remove the Resource Graph extension from the Azure CLI environment
az extension remove -n resource-graph

Pasos siguientes

En este inicio rápido, ha agregado la extensión Resource Graph a su entorno de la CLI de Azure y ha ejecutado la primera consulta. Para más información sobre el lenguaje de Resource Graph, vaya a la página de detalles del lenguaje de consulta.

Obtener más información sobre el lenguaje de consulta