조회 범위 지정
확장 명령어의 scope 옵션으로 조회할 프로젝트·폴더·조직을 지정합니다. 서비스 계정에 역할을 부여한 범위 안에서만 조회할 수 있습니다. 역할 부여는 4. 역할 부여를 참고합니다.
scope 형식
| 범위 | 형식 | 예 |
|---|---|---|
| 프로젝트 | projects/프로젝트ID 또는 projects/프로젝트번호 | projects/my-project-123456 |
| 폴더 | folders/폴더번호 | folders/234567890123 |
| 조직 | organizations/조직번호 | organizations/123456789012 |
명령어별 차이
명령어마다 scope 옵션을 생략했을 때와 하위 폴더를 포함하는지가 다릅니다.
| 명령어 | scope 옵션 | scope 생략 시 | 하위 폴더 |
|---|---|---|---|
| gcp-assets, gcp-iam-policies | projects/프로젝트ID, folders/폴더번호, organizations/조직번호 | JSON 키의 프로젝트 | 포함 |
| gcp-projects | folders/폴더번호, organizations/조직번호 | 서비스 계정이 접근할 수 있는 모든 프로젝트 (다른 조직의 프로젝트 포함 가능) | 제외 (바로 아래 프로젝트만) |
하위 폴더를 포함한 조직 전체 프로젝트는 gcp-projects 대신 gcp-assets scope=organizations/조직번호 types="cloudresourcemanager.googleapis.com/Project"로 조회합니다.
조직·폴더 번호 확인
scope 옵션에는 조직·폴더 이름이 아니라 번호를 입력합니다. 표시 이름은 다음과 같은 이유로 지정할 수 없습니다.
- 폴더·프로젝트 표시 이름은 겹칠 수 있어 의도하지 않은 범위를 조회할 수 있습니다. 예를 들어 부서마다 같은 이름의 폴더를 둘 수 있습니다.
- 표시 이름은 바뀔 수 있어, 예약된 쿼리에 넣어 두면 이름이 바뀐 뒤 조회가 실패할 수 있습니다. 번호는 바뀌지 않습니다.
- 구글 클라우드 API가 조직·폴더를 번호로만 받습니다.
프로젝트는 프로젝트 ID(예: my-project-123456)로도 지정할 수 있습니다. 프로젝트 ID는 전체에서 유일하고 바꿀 수 없기 때문입니다.
구글 클라우드 콘솔에서 확인
IAM 및 관리자 > 리소스 관리에서 조직·폴더·프로젝트의 ID 열을 확인합니다. 조직·폴더는 숫자 ID가 번호입니다.
로그프레소에서 확인
접속 프로파일을 등록한 뒤 아래 쿼리로 확인할 수도 있습니다. 먼저 scope 옵션 없이 실행해 조직 번호를 확인합니다.
gcp-assets profile=gcp types="cloudresourcemanager.googleapis.com/Project"
| fields project_id, display_name, organization, folders
organization 필드의 organizations/ 다음 숫자가 조직 번호입니다. 조직 번호로 폴더 목록을 확인합니다.
gcp-assets profile=gcp scope=organizations/123456789012 types="cloudresourcemanager.googleapis.com/(Organization|Folder)"
| fields asset_type, display_name, name
name 필드 끝의 folders/숫자가 폴더 번호입니다. 위 쿼리의 123456789012는 확인한 조직 번호로 바꿔 입력합니다.