Compartilhar via

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 os recursos gerenciados pelo Azure Resource Manager.

Execute 'az graph query --help' para obter ajuda detalhada.

Comandos

Nome Description Tipo Status
az graph query

Consulte os recursos gerenciados pelo Azure Resource Manager.

 Extension GA
az graph shared-query

Gerenciar a consulta compartilhada do grafo de recursos do Azure.

 Extension Experimental
az graph shared-query create

Crie uma consulta compartilhada.

 Extension Experimental
az graph shared-query delete

Excluir uma consulta compartilhada.

 Extension Experimental
az graph shared-query list

Listar todas as consultas compartilhadas em um grupo de recursos.

 Extension Experimental
az graph shared-query show

Mostrar as propriedades de uma consulta compartilhada.

 Extension Experimental

az graph query

Consulte os recursos gerenciados pelo Azure Resource Manager.

Consulte https://aka.ms/AzureResourceGraph-QueryLanguage para saber mais sobre a linguagem de consulta e procurar exemplos.

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

Exemplos

Consultar recursos solicitando um subconjunto de campos de recurso.

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

Consultar recursos com seleção de campo, filtragem e resumo.

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

Solicite um subconjunto de resultados, ignorando 20 itens e obtendo os próximos 10.

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

Escolha assinaturas para consultar.

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

Escolha grupos de gerenciamento 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

Consultar com o token de ignorar.

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

Parâmetros Exigidos

--graph-query --q -q

Consulta do Resource Graph a ser executada.

Parâmetros Opcionais

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 se a consulta deve ter êxito quando apenas o número parcial de assinatura abaixo pode ser processado pelo servidor.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--first

O número máximo de objetos a serem retornados. Intervalo aceito: 1-1000.

--management-groups -m

Lista de grupos de gerenciamento em que executar a consulta.

--skip

Ignora os primeiros objetos N e, em seguida, obtém os objetos restantes.

--skip-token

Ignore o token para obter a próxima página da consulta, se aplicável.

--subscriptions -s

Lista de assinaturas em que executar a consulta. Por padrão, todas as assinaturas acessíveis são consultadas.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Output format.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False