Compartir a través de

az graph

Note

This reference is part of the resource-graph extension for the Azure CLI (version 2.22.0 or higher). The extension will automatically install the first time you run an az graph command. Learn more about extensions.

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.

 Extension GA
az graph shared-query

Administración de consultas compartidas de Azure Resource Graph.

 Extension Experimental
az graph shared-query create

Cree una consulta compartida.

 Extension Experimental
az graph shared-query delete

Elimine una consulta compartida.

 Extension Experimental
az graph shared-query list

Enumerar todas las consultas compartidas en un grupo de recursos.

 Extension Experimental
az graph shared-query show

Mostrar las propiedades de una consulta compartida.

 Extension 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 --q
               [--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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--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.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propiedad Valor
Valor predeterminado: False