빠른 시작: Azure CLI를 사용하여 Resource Graph 공유 쿼리 만들기

아티클
12/04/2024

이 빠른 시작에서는 Azure CLI 및 Resource Graph 확장을 사용하여 Azure Resource Graph 공유 쿼리를 만드는 방법을 설명합니다. az graph shared-query 명령은 az graph query의 실험적 기능입니다.

실험적 기능의 명령을 사용하여 Azure CLI에서 공유 쿼리를 실행하거나 Azure Portal에서 공유 쿼리를 실행할 수 있습니다. 공유 쿼리는 Azure Resource Graph Explorer에서 사용 권한을 부여하거나 실행할 수 있는 Azure Resource Manager 개체입니다. 완료되면 Resource Graph 확장을 제거할 수 있습니다.

필수 조건

Azure 계정이 없는 경우 시작하기 전에 체험 계정을 만듭니다.
Resource Graph 확장을 사용하려면 Azure CLI 버전이 2.22.0 이상이어야 합니다.
Azure CLI 명령을 실행할 수 있는 Bash 셸 환경입니다. 예를 들어 Visual Studio Code 터미널 세션의 Git Bash입니다.

확장 설치

Azure Resource Graph를 사용하여 Azure CLI가 리소스를 쿼리할 수 있도록 하려면 Resource Graph 확장을 설치해야 합니다. az graph을(를) 사용하여 쿼리를 처음 실행하면 확장을 설치하라는 메시지가 표시됩니다. 그렇지 않으면 다음 단계를 사용하여 수동 설치를 수행합니다.

사용 가능한 확장 및 버전을 나열합니다.
```
az extension list-available --output table
```
확장을 설치합니다.
```
az extension add --name resource-graph
```
확장이 설치되었는지 확인합니다.
```
az extension list --output table
```
확장의 구문을 표시합니다.
```
az graph query --help
```

Azure CLI 확장에 대한 자세한 내용은 Azure CLI를 사용하여 확장 사용 및 관리를 참조하세요.

Azure에 연결

Visual Studio Code 터미널 세션에서 Azure에 연결합니다. 구독이 두 개 이상인 경우 명령을 실행하여 구독에 대한 컨텍스트를 설정합니다. <subscriptionID> 를 Azure 구독 ID로 바꿉니다.

az login

# Run these commands if you have multiple subscriptions
az account list --output table
az account set --subscription <subscriptionID>

공유 쿼리 만들기

위치별로 그룹화된 모든 리소스의 수를 요약하는 리소스 그룹 및 공유를 만듭니다.

Azure Resource Graph 공유 쿼리를 저장할 리소스 그룹을 만듭니다.
```
az group create --name "demoSharedQuery" --location westus2
```

공유 쿼리를 만듭니다.

az graph shared-query create --name "Summarize resources by location" \
  --description "This shared query summarizes resources by location for a pinnable map graphic." \
  --graph-query "Resources | summarize count() by location" \
  --resource-group demoSharedQuery

리소스 그룹의 모든 공유 쿼리를 나열합니다.

az graph shared-query list --resource-group demoSharedQuery

결과를 특정 공유 쿼리로 제한합니다.

az graph shared-query show --resource-group "demoSharedQuery" \
  --name "Summarize resources by location"

공유 쿼리 실행

Azure CLI 실험적 기능 구문 또는 Azure Portal을 사용하여 공유 쿼리를 실행할 수 있습니다.

실험적 기능을 사용하여 공유 쿼리 실행

az graph query 명령에서 {{shared-query-uri}} 구문을 사용하여 Azure CLI에서 공유 쿼리를 실행합니다. 공유 쿼리의 리소스 ID를 가져와 변수에 저장합니다. 이 변수는 공유 쿼리를 실행할 때 사용됩니다.

sharedqueryid=$(az graph shared-query show --resource-group "demoSharedQuery" \
  --name "Summarize resources by location" \
  --query id \
  --output tsv)

az graph query --graph-query "{{$sharedqueryid}}"

subscriptions 매개 변수를 사용하여 결과를 제한할 수 있습니다.

az graph query --graph-query "{{$sharedqueryid}}" --subscriptions 11111111-1111-1111-1111-111111111111

포털에서 공유 쿼리 실행

Azure Resource Graph Explorer를 사용하여 공유 쿼리가 작동하는지 확인할 수 있습니다. 범위를 변경하려면 페이지 왼쪽의 범위 메뉴를 사용합니다.

Azure 포털에 로그인합니다.
페이지 맨 위에 있는 검색 필드에 리소스 그래프를 입력합니다.
Resource Graph Explorer를 선택합니다.
쿼리 열기를 선택합니다.
형식을 공유 쿼리로 변경합니다.
OS로 VM 세기 쿼리를 선택합니다.
결과 탭에서 쿼리 실행 및 보기 출력을 선택합니다.
차트를 선택한 다음 지도를 선택하여 위치 맵을 봅니다.

리소스 그룹에서 쿼리를 실행할 수도 있습니다.

Azure에서 리소스 그룹인 demoSharedQuery로 이동합니다.
개요 탭에서 OS로 VM 세기 쿼리를 선택합니다.
결과 탭을 선택합니다.
차트를 선택한 다음 지도를 선택하여 위치 맵을 봅니다.

리소스 정리

공유 쿼리를 제거하려면 다음을 수행합니다.

az graph shared-query delete --name "Summarize resources by location" --resource-group demoSharedQuery

리소스 그룹이 삭제되면 리소스 그룹과 해당 리소스가 모두 삭제됩니다. 리소스 그룹을 제거하려면:

az group delete --name demoSharedQuery

Resource Graph 확장을 제거하려면 다음 명령을 실행합니다.

az extension remove --name resource-graph

Azure CLI 세션에서 로그아웃하려면 다음을 수행합니다.

az logout

다음 단계

이 빠른 시작에서는 Resource Graph 확장을 Azure CLI 환경에 추가하고 공유 쿼리를 만들었습니다. 리소스 그래프 언어에 대한 자세한 내용을 보려면 쿼리 언어 정보 페이지로 이동하세요.

Azure Resource Graph 쿼리 언어 이해

다음을 통해 공유