Compartilhar via


az graph

Observação

Essa referência faz parte da extensão de gráfico de recursos para a CLI do Azure (versão 2.22.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az graph . Saiba mais sobre extensões.

Consulte os recursos gerenciados pelo Gerenciador de Recursos do Azure.

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

Comandos

Nome Description Tipo Status
az graph query

Consulte os recursos gerenciados pelo Gerenciador de Recursos do Azure.

Extensão GA
az graph shared-query

Gerenciar consulta compartilhada do gráfico de recursos do Azure.

Extensão Habilitação
az graph shared-query create

Crie uma consulta compartilhada.

Extensão Habilitação
az graph shared-query delete

Excluir uma consulta compartilhada.

Extensão Habilitação
az graph shared-query list

Listar todas as consultas compartilhadas em um grupo de recursos.

Extensão Habilitação
az graph shared-query show

Mostrar as propriedades de uma consulta compartilhada.

Extensão Habilitação

az graph query

Consulte os recursos gerenciados pelo Gerenciador de Recursos do Azure.

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

az graph query --graph-query
               [--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"

Consulta de recursos com seleção de campos, 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, pulando 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 consulta.

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

Consulta com o token skip.

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 Gráfico de Recursos a ser executada.

Parâmetros Opcionais

--allow-partial-scopes -a

Indica se a consulta deve ser bem-sucedida quando apenas o número parcial de assinatura abaixo pode ser processado pelo servidor.

valores aceitos: false, true
valor padrão: False
--first

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

--management-groups -m

Lista de grupos de gerenciamento para executar 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 para executar consulta. Por padrão, todas as assinaturas acessíveis são consultadas.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.