az graph

참조

참고 항목

이 참조는 Azure CLI(버전 2.22.0 이상)에 대한 리소스 그래프 확장의 일부입니다. az graph 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

Azure Resource Manager에서 관리하는 리소스를 쿼리합니다.

자세한 도움말을 보려면 'az graph query --help'를 실행합니다.

명령

Name	Description	형식	상태
az graph query	Azure Resource Manager에서 관리하는 리소스를 쿼리합니다.	내선 번호	GA
az graph shared-query	Azure 리소스 그래프의 공유 쿼리를 관리합니다.	내선 번호	실험적
az graph shared-query create	공유 쿼리를 만듭니다.	내선 번호	실험적
az graph shared-query delete	공유 쿼리를 삭제합니다.	내선 번호	실험적
az graph shared-query list	리소스 그룹의 모든 공유 쿼리를 나열합니다.	내선 번호	실험적
az graph shared-query show	공유 쿼리의 속성을 표시합니다.	내선 번호	실험적

az graph query

Azure Resource Manager에서 관리하는 리소스를 쿼리합니다.

쿼리 언어 및 찾아보기 예제에 대한 자세한 내용은 참조 https://aka.ms/AzureResourceGraph-QueryLanguage 하세요.

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

예제

리소스 필드의 하위 집합을 요청하는 리소스를 쿼리합니다.

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

필드 선택, 필터링 및 요약을 사용하여 리소스를 쿼리합니다.

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

20개 항목을 건너뛰고 다음 10개 항목을 가져오는 결과의 하위 집합을 요청합니다.

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

쿼리할 구독을 선택합니다.

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

쿼리할 관리 그룹을 선택합니다.

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

건너뛰기 토큰을 사용하여 쿼리합니다.

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

필수 매개 변수

--graph-query --q -q

실행할 Resource Graph 쿼리입니다.

선택적 매개 변수

--allow-partial-scopes -a

서버에서 아래 구독의 일부만 처리할 수 있는 경우 쿼리가 성공해야 하는지를 나타냅니다.

허용되는 값: false, true

기본값: False

--first

반환할 최대 개체 수입니다. 허용 범위: 1-1000.

--management-groups -m

쿼리를 실행할 관리 그룹 목록입니다.

--skip

첫 번째 N 개체를 무시한 다음 다시 기본 개체를 가져옵니다.

--skip-token

토큰을 건너뛰어 해당되는 경우 쿼리의 다음 페이지를 가져옵니다.

--subscriptions -s

쿼리를 실행할 구독 목록입니다. 기본적으로 액세스 가능한 모든 구독이 쿼리됩니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az graph

명령

az graph query

예제

필수 매개 변수

선택적 매개 변수

피드백

추가 리소스