Cloud Asset Inventory API로 Google Cloud 프로젝트·폴더·조직 아래의 자원을 검색합니다.

문법

옵션

profile=STRING

선택 옵션. Google Cloud 접속 프로파일 식별자. 쉼표로 여러 개를 지정하면 프로파일마다 차례로 조회하고 profile 필드로 구분합니다. 생략하면 사용 권한이 있는 모든 Google Cloud 접속 프로파일로 조회합니다. 조회 중 한 프로파일에서 오류가 나면 그때까지 출력한 결과는 남고, 나머지 프로파일은 조회하지 않은 채 쿼리가 오류로 끝납니다.

scope=STRING

선택 옵션. 조회 범위. projects/프로젝트ID(또는 projects/프로젝트번호), folders/폴더번호, organizations/조직번호 중 하나. 지정한 범위와 그 아래(하위 폴더·프로젝트 포함)의 자원을 조회합니다. 생략하면 서비스 계정 JSON 키의 프로젝트를 조회합니다.

types=STRING

선택 옵션. 조회할 자산 유형. 쉼표로 여러 개를 지정할 수 있고 정규표현식을 지원합니다. 예: compute.googleapis.com/Instance, iam.googleapis.com/.*. 생략하면 모든 유형을 조회합니다. 자주 쓰는 유형은 설명의 자산 유형 표를 참고합니다.

query=STRING

선택 옵션. Cloud Asset Inventory 검색식. 예: labels.env:prod, location:asia-northeast3, name:sinks. 한글처럼 영문·숫자가 아닌 문자가 든 검색어는 큰따옴표로 감싸야 하며, 옵션 값 안에서는 \"로 씁니다. 예: query="tagKeys:\"앱개발팀\"". 검색식 문법은 Cloud Asset Inventory 검색식 문법을 참고합니다.

limit=INT

선택 옵션. 프로파일별 최대 출력 건수. 1 이상의 정수. 생략하면 전체를 조회합니다.

verbose=BOOL

선택 옵션. t이면 자원 전체 설정(versioned_resources)과 부속 자원(attached_resources)을 함께 출력합니다. t, f, true, false 중 하나 (기본값: f)

출력 필드

오류 코드

파싱 오류

런타임 오류

설명

지정한 범위에서 Cloud Asset Inventory의 searchAllResources API로 자원 메타데이터를 검색합니다. 조직이나 폴더를 지정하면 그 아래 모든 폴더와 프로젝트의 자원까지 조회합니다. 결과는 한 번에 최대 500건씩 받아 끝까지 이어서 조회합니다.

API는 소속 프로젝트를 번호(projects/번호)로만 돌려줍니다. 알아보기 쉽도록 같은 범위에서 프로젝트 정보를 한 번 더 조회해 project_id와 project_name을 채웁니다. 폴더·조직은 번호(folders, organization)로만 나옵니다. 폴더·조직 이름은 types="cloudresourcemanager.googleapis.com/(Folder|Organization)"으로 조회해 확인합니다.

scope에는 표시 이름이 아니라 ID·번호를 지정합니다. 폴더·프로젝트 표시 이름은 겹칠 수 있고 바뀔 수 있어, 이름으로 지정하면 의도하지 않은 범위를 조회할 수 있기 때문입니다. 조직·폴더 번호는 다음 쿼리로 확인할 수 있습니다.

gcp-assets profile=gcp types="cloudresourcemanager.googleapis.com/(Organization|Folder|Project)"
| fields asset_type, display_name, name, organization

query는 앱에서 검사하지 않고 Google Cloud에 그대로 전달합니다. 잘못된 검색식은 Google Cloud가 INVALID_ARGUMENT 오류와 원인을 돌려주며, 그 메시지가 쿼리 오류로 표시됩니다.

verbose=t를 지정하면 자원 유형마다 구조가 다른 전체 설정을 함께 받으므로 응답이 커집니다. 범위가 크면 접속 프로파일의 읽기 타임아웃을 늘리거나 types로 범위를 좁혀 사용합니다.

자주 쓰는 자산 유형

types 옵션에 지정할 수 있는 자산 유형 중 자주 쓰는 것입니다. 전체 목록은 지원 자산 유형을 참고합니다. 목록에 없거나 이름이 틀리면 No supported asset type matches 오류가 납니다.

정규표현식으로 여러 유형을 한 번에 지정할 수 있습니다. 예: types="compute.googleapis.com/.*"(Compute Engine 전체), types="iam.googleapis.com/.*"(IAM 전체)

사용 예

예시: 조직 전체 자원 유형별 현황

상황: 조직에 어떤 종류의 자원이 몇 개 있는지 파악합니다.

gcp-assets profile=gcp scope=organizations/123456789012
| stats count by asset_type
| sort -count

예상 결과:

결과 해석: 자원 유형별 건수입니다. serviceusage.googleapis.com/Service는 프로젝트마다 사용 설정된 API입니다. 특정 유형만 보려면 types 옵션을 지정합니다.

예시: 서비스 계정과 키 목록

상황: 조직 안의 서비스 계정과 서비스 계정 키를 프로젝트별로 확인합니다.

gcp-assets profile=gcp scope=organizations/123456789012 types="iam.googleapis.com/.*"
| fields project_id, asset_type, display_name, name, create_time

예상 결과:

결과 해석: 사용하지 않는 서비스 계정이나 오래된 키가 있는지 점검합니다.

예시: 태그가 적용된 자원

상황: 특정 태그가 직접 연결되거나 상속된 자원을 찾습니다.

gcp-assets profile=gcp scope=organizations/123456789012 query="effectiveTagKeys:\"앱개발팀\""
| stats count by project_id, asset_type

결과 해석: 태그를 연결한 프로젝트와 그 아래 자원이 모두 나옵니다. 직접 연결된 자원만 찾으려면 tagKeys:를 사용합니다.

예시: 하위 폴더를 포함한 조직 전체 프로젝트

상황: gcp-projects의 scope는 바로 아래 프로젝트만 조회하므로, 하위 폴더 안까지 포함한 조직 전체 프로젝트는 이 명령어로 조회합니다.

gcp-assets profile=gcp scope=organizations/123456789012 types="cloudresourcemanager.googleapis.com/Project"
| fields project_id, display_name, folders, state, create_time

결과 해석: 프로젝트마다 소속 폴더 번호(folders)와 상태가 나옵니다.