az graph

Referencia

Nota:

Esta referencia forma parte de la extensión de resource-graph para la CLI de Azure (versión 2.22.0 o posterior). La extensión se instalará automáticamente la primera vez que ejecute un comando az graph. Más información sobre las extensiones.

Consulte los recursos administrados por Azure Resource Manager.

Ejecute "az graph query --help" para obtener ayuda detallada.

Comandos

Nombre	Description	Tipo	Estado
az graph query	Consulte los recursos administrados por Azure Resource Manager.	Extensión	GA
az graph shared-query	Administración de consultas compartidas de Azure Resource Graph.	Extensión	Experimental
az graph shared-query create	Cree una consulta compartida.	Extensión	Experimental
az graph shared-query delete	Elimine una consulta compartida.	Extensión	Experimental
az graph shared-query list	Enumerar todas las consultas compartidas en un grupo de recursos.	Extensión	Experimental
az graph shared-query show	Mostrar las propiedades de una consulta compartida.	Extensión	Experimental

az graph query

Consulte los recursos administrados por Azure Resource Manager.

Consulte https://aka.ms/AzureResourceGraph-QueryLanguage para obtener más información sobre el lenguaje de consulta y examinar ejemplos.

az graph query --graph-query
               [--allow-partial-scopes {false, true}]
               [--first]
               [--management-groups]
               [--skip]
               [--skip-token]
               [--subscriptions]

Ejemplos

Consultar recursos que solicitan un subconjunto de campos de recursos.

az graph query -q "project id, name, type, location, tags"

Consulta de recursos con selección de campos, filtrado y resumen.

az graph query -q "project id, type, location | where type =~ 'Microsoft.Compute/virtualMachines' | summarize count() by location | top 3 by count_"

Solicite un subconjunto de resultados, omita 20 elementos y obtenga los siguientes 10.

az graph query -q "where type =~ "Microsoft.Compute" | project name, tags" --first 10 --skip 20

Elija suscripciones para consultar.

az graph query -q "where type =~ "Microsoft.Compute" | project name, tags" --subscriptions 11111111-1111-1111-1111-111111111111 22222222-2222-2222-2222-222222222222

Elija grupos de administración para consultar.

az graph query -q "where type =~ "Microsoft.Compute" | project name, tags" --management-groups aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb --allow-partial-scopes

Consulta con el token de omisión.

az graph query -q "where type =~ "Microsoft.Compute" | project name, tags" --skip-token skip_token_value_from_previous_query_response

Parámetros requeridos

--graph-query --q -q

Consulta de Resource Graph que se va a ejecutar.

Parámetros opcionales

--allow-partial-scopes -a

Indica si la consulta debe realizarse correctamente cuando solo el servidor puede procesar el número parcial de suscripción inferior.

Valores aceptados: false, true

Valor predeterminado: False

--first

Número máximo de objetos que se van a devolver. Intervalo aceptado: 1-1000.

--management-groups -m

Lista de grupos de administración en los que se va a ejecutar la consulta.

--skip

Omite los primeros objetos N y, a continuación, obtiene los objetos restantes.

--skip-token

Omita el token para obtener la página siguiente de la consulta si procede.

--subscriptions -s

Lista de suscripciones en las que se va a ejecutar la consulta. De forma predeterminada, se consultan todas las suscripciones accesibles.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Compartir vía