Inicio rápido: Ejecución de la primera consulta de Resource Graph con la CLI de AzureQuickstart: Run your first Resource Graph query using Azure CLI

El primer paso para usar Azure Resource Graph es comprobar que está instalada la extensión para la CLI de Azure.The first step to using Azure Resource Graph is to check that the extension for Azure CLI is installed. 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.This quickstart walks you through the process of adding the extension to your Azure CLI installation. Puede usar la extensión con la CLI de Azure instalada localmente o mediante Azure Cloud Shell.You can use the extension with Azure CLI installed locally or through the 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.At the end of this process, you'll have added the extension to your Azure CLI installation of choice and run your first Resource Graph query.

PrerrequisitosPrerequisites

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.If you don't have an Azure subscription, create a free account before you begin.

Uso de Azure Cloud ShellUse Azure Cloud Shell

En Azure se hospeda Azure Cloud Shell, un entorno de shell interactivo que puede utilizar mediante el explorador.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Puede usar Bash o PowerShell con Cloud Shell para trabajar con los servicios de Azure.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. Puede usar los comandos preinstalados de Cloud Shell para ejecutar el código de este artículo sin tener que instalar nada en su entorno local.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Para iniciar Azure Cloud Shell:To start Azure Cloud Shell:

OpciónOption Ejemplo o vínculoExample/Link
Seleccione Pruébelo en la esquina superior derecha de un bloque de código.Select Try It in the upper-right corner of a code block. Solo con seleccionar Pruébelo no se copia automáticamente el código en Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Ejemplo de Probarlo para Azure Cloud Shell
Vaya a https://shell.azure.com o seleccione el botón Iniciar Cloud Shell para abrir Cloud Shell en el explorador.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. Iniciar Cloud Shell en una nueva ventanaLaunch Cloud Shell in a new window
Seleccione el botón Cloud Shell en la barra de menús de la esquina superior derecha de Azure Portal.Select the Cloud Shell button on the menu bar at the upper right in the Azure portal. Botón Cloud Shell en Azure Portal

Para ejecutar el código de este artículo en Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Inicie Cloud Shell.Start Cloud Shell.

  2. Seleccione el botón Copiar de un bloque de código para copiar el código.Select the Copy button on a code block to copy the code.

  3. Pegue el código en la sesión de Cloud Shell. Para ello, seleccione Ctrl+Mayús+V en Windows y Linux, o bien seleccione Cmd+Mayús+V en macOS.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. Seleccione Entrar para ejecutar el código.Select Enter to run the code.

Incorporación de la extensión de Resource GraphAdd the Resource Graph extension

Para habilitar la CLI de Azure para consultar Azure Resource Graph, se debe agregar la extensión.To enable Azure CLI to query Azure Resource Graph, the extension must be added. 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.This extension works wherever Azure CLI can be used, including bash on Windows 10, Cloud Shell (both standalone and inside the portal), the Azure CLI Docker image, or locally installed.

  1. Compruebe que está instalada la versión más reciente de la CLI de Azure (al menos la 2.0.76).Check that the latest Azure CLI is installed (at least 2.0.76). Si todavía no está instalado, siga estas instrucciones.If it isn't yet installed, follow these instructions.

  2. En el entorno que prefiera de la CLI de Azure, impórtela con el siguiente comando:In your Azure CLI environment of choice, import it with the following command:

    # 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):Validate that the extension has been installed and is the expected version (at least 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 GraphRun your first Resource Graph query

Una vez agregada la extensión de la CLI de Azure al entorno de su elección, es el momento de probar una consulta simple de Resource Graph.With the Azure CLI extension added to your environment of choice, it's time to try out a simple Resource Graph query. La consulta devolverá los cinco primeros recursos de Azure con el Nombre y el Tipo de recurso de cada recurso.The query will return the first five Azure resources with the Name and Resource Type of each resource.

  1. Ejecute la primera consulta de Azure Resource Graph mediante la extensión graph y el comando query:Run your first Azure Resource Graph query using the graph extension and query command:

    # 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.As this query example does not provide a sort modifier such as order by, running this query multiple times is likely to yield a different set of resources per request.

  2. Actualice la consulta para order by la propiedad Nombre:Update the query to order by the Name property:

    # 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.Just as with the first query, running this query multiple times is likely to yield a different set of resources per request. El orden de los comandos de consulta es importante.The order of the query commands is important. En este ejemplo, el order by viene después del limit.In this example, the order by comes after the limit. Este orden de comandos limita primero los resultados de la consulta y, luego, los ordena.This command order first limits the query results and then orders them.

  3. Actualice la consulta para que primero se aplique order by a la propiedad Nombre y, después, limit a los cinco primeros resultados:Update the query to first order by the Name property and then limit to the top five results:

    # 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.When the final query is run several times, assuming that nothing in your environment is changing, the results returned are consistent and ordered by the Name property, but still limited to the top five results.

Limpieza de recursosClean up resources

Si quiere quitar la extensión de Resource Graph de su entorno de la CLI de Azure, puede hacerlo mediante el comando siguiente:If you wish to remove the Resource Graph extension from your Azure CLI environment, you can do so by using the following command:

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

Pasos siguientesNext steps

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.In this quickstart, you've added the Resource Graph extension to your Azure CLI environment and run your first query. Para más información sobre el lenguaje de Resource Graph, vaya a la página de detalles del lenguaje de consulta.To learn more about the Resource Graph language, continue to the query language details page.