Compartir a través de


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

En este inicio rápido se describe cómo ejecutar una consulta de Azure Resource Graph mediante la CLI de Azure y la extensión Resource Graph. En el artículo también se muestra cómo ordenar (organizar) y limitar los resultados de la consulta. Puede ejecutar una consulta de recursos en el inquilino, los grupos de administración o las suscripciones. Cuando termine, puede quitar la extensión.

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.

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>

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.

  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. Comprobar que la extensión se instaló:

    az extension list --output table
    
  4. 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.

Ejecución de una consulta

Después de agregar la extensión de la CLI de Azure al entorno, puede ejecutar una consulta basada en inquilinos. La consulta de este ejemplo devuelve cinco recursos de Azure con el name y type de cada recurso. Para hacer una consulta por grupo de administración o suscripción, use los argumentos --management-groups o --subscriptions.

  1. Ejecute una consulta de Azure Resource Graph:

    az graph query --graph-query 'Resources | project name, type | limit 5'
    

    En este ejemplo de consulta no se usa un modificador de ordenación como order by. Si ejecuta la consulta varias veces, puede producir un conjunto diferente de recursos para cada solicitud.

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

    az graph query --graph-query 'Resources | project name, type | limit 5 | order by name asc'
    

    Al igual que la consulta anterior, si ejecuta esta consulta varias veces, podría producir un conjunto diferente de recursos para cada solicitud. El orden de los comandos de consulta es importante. En este ejemplo, el order by viene después del limit. La consulta limita los resultados a cinco recursos y, a continuación, ordena esos resultados por nombre.

  3. Actualice la consulta para order by la propiedad name y, a continuación, limit la salida a cinco resultados:

    az graph query --graph-query 'Resources | project name, type | order by name asc | limit 5'
    

    Si esta consulta se ejecuta varias veces sin cambios en el entorno, los resultados son coherentes y ordenados por la propiedad name, pero todavía están limitados a cinco resultados. La consulta ordena los resultados por nombre y, a continuación, limita la salida a cinco recursos.

Limpieza de recursos

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, ejecutó consultas de Azure Resource Graph mediante la extensión para la CLI de Azure. Para más información, vaya al artículo de detalles del lenguaje de consulta.