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.
Enumerar las extensiones y versiones disponibles:
az extension list-available --output tableInstale la extensión:
az extension add --name resource-graphComprobar que la extensión se instaló:
az extension list --output tableMostrar la sintaxis de la extensión:
az graph query --helpPara 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.
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.Actualice la consulta para
order byla propiedadname: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 byviene después dellimit. La consulta limita los resultados a cinco recursos y, a continuación, ordena esos resultados por nombre.Actualice la consulta para
order byla propiedadnamey, a continuación,limitla 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.