빠른 시작: Azure CLI를 사용하여 Resource Graph 쿼리 실행

아티클
12/04/2024

이 빠른 시작에서는 Azure CLI 및 Resource Graph 확장을 사용하여 Azure 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 CLI 확장이 환경에 추가되면 테넌트 기반 쿼리를 실행할 수 있습니다. 이 예의 쿼리는 각 리소스의 name 및 type이 포함된 5개의 Azure 리소스를 반환합니다. 관리 그룹 또는 구독별로 쿼리하려면 --management-groups 또는 --subscriptions 인수를 사용합니다.

Azure Resource Graph 쿼리를 실행합니다.
```
az graph query --graph-query 'Resources | project name, type | limit 5'
```
이 쿼리 예에서는 order by와 같은 정렬 한정자를 사용하지 않습니다. 쿼리를 여러 번 실행하면 각 요청에 대해 서로 다른 리소스 집합이 생성될 수 있습니다.
name 속성을 기준으로 정렬(order by)하도록 쿼리를 업데이트합니다.
```
az graph query --graph-query 'Resources | project name, type | limit 5 | order by name asc'
```
이전 쿼리와 마찬가지로 이 쿼리를 여러 번 실행하면 각 요청에 대해 서로 다른 리소스 집합이 생성될 수 있습니다. 쿼리 명령의 순서는 중요합니다. 이 예에서 order by는 limit 뒤에 옵니다. 쿼리는 결과를 5개의 리소스로 제한한 다음 해당 결과를 이름별로 정렬합니다.
name 속성을 기준으로 정렬(order by)하도록 쿼리를 업데이트한 후 출력을 5개 결과로 제한(limit)합니다.
```
az graph query --graph-query 'Resources | project name, type | order by name asc | limit 5'
```
환경을 변경하지 않고 이 쿼리를 여러 번 실행하면 결과는 일관되고 name 속성에 따라 정렬되지만 결과는 여전히 5개로 제한됩니다. 쿼리는 결과를 이름별로 정렬한 다음 출력을 5개의 리소스로 제한합니다.

리소스 정리

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

az extension remove --name resource-graph

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

az logout

다음 단계

이 빠른 시작에서는 Azure CLI용 확장을 사용하여 Azure Resource Graph 쿼리를 실행했습니다. 리소스 그래프 언어에 대한 자세한 내용을 보려면 쿼리 언어 정보 페이지로 이동하세요.

Azure Resource Graph 쿼리 언어 이해

다음을 통해 공유