Method: organizations.protectedResources.search

지정된 Cloud 조직에서 지정된 Cloud KMS CryptoKey로 보호되는 리소스에 대한 메타데이터를 반환합니다.

HTTP 요청

GET https://kmsinventory.googleapis.com/v1/{scope=organizations/*}/protectedResources:search

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
scope

string

필수 항목입니다. 조직의 리소스 이름입니다. 예: organizations/123

승인을 처리하려면 지정된 리소스 scope에 대해 다음과 같은 IAM 권한이 필요합니다.

  • cloudkms.protectedResources.search

쿼리 매개변수

매개변수
cryptoKey

string

필수 항목입니다. CryptoKey의 리소스 이름입니다.

승인을 처리하려면 지정된 리소스 cryptoKey에 대해 다음과 같은 IAM 권한이 필요합니다.

  • cloudkms.cryptoKeys.get
pageSize

integer

반환할 최대 리소스 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 500개의 리소스가 반환됩니다. 최댓값은 500이며, 500을 초과하는 값은 500으로 변환됩니다.
pageToken

string

이전 KeyTrackingService.SearchProtectedResources 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 KeyTrackingService.SearchProtectedResources에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.
resourceTypes[]

string

선택사항입니다. 이 요청이 검색하는 리소스 유형 목록입니다. 비어 있으면 추적 가능한 리소스 유형을 모두 검색합니다.

정규 표현식도 지원됩니다. 예를 들면 다음과 같습니다.

  • compute.googleapis.com.*은 유형이 compute.googleapis.com으로 시작하는 리소스의 스냅샷을 만듭니다.
  • .*Image는 유형이 Image로 끝나는 리소스의 스냅샷을 만듭니다.
  • .*Image.*는 유형이 Image로 끝나는 리소스의 스냅샷을 만듭니다.

지원되는 모든 정규 표현식 구문은 RE2를 참조하세요. 정규 표현식이 지원되는 리소스 유형과 일치하지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공하면 응답 본문에 다음과 같은 구조의 데이터가 포함됩니다.

KeyTrackingService.SearchProtectedResources에 대한 응답 메시지입니다.

JSON 표현 
{
  "protectedResources": [
    {
      object (ProtectedResource)
    }
  ],
  "nextPageToken": string
}
필드
protectedResources[]

object (ProtectedResource)

이 페이지의 보호된 리소스입니다.
nextPageToken

string

다음 페이지를 검색하기 위해 pageToken으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.