az graph

Note

Essa referência faz parte da extensão resource-graph para o CLI do Azure (versão 2.22.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az graph . Saiba mais sobre extensões.

Consulte os recursos gerenciados por Azure Resource Manager.

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

Comandos

Nome	Description	Tipo	Status
az graph query	Consulte os recursos gerenciados por Azure Resource Manager.	Extension	GA
az graph shared-query	Gerenciar a consulta compartilhada de Azure grafo de recursos.	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 por 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
               [--acquire-policy-token]
               [--allow-partial-scopes {false, true}]
               [--change-reference]
               [--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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

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

--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

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

Formato de saída.

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

Comentários

Esta página foi útil?