메서드: projects.locations.instances.getIamPolicy

리소스의 액세스 제어 정책을 가져옵니다. 리소스가 존재하지만 설정된 정책이 없는 경우 빈 정책을 반환합니다.

HTTP 요청

GET https://memcache.googleapis.com/v1beta2/{resource=projects/*/locations/*/instances/*}:getIamPolicy

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

경로 매개변수

매개변수
resource

string

필수. 정책을 요청할 리소스입니다. 이 필드의 적절한 값은 작업 문서를 참조하세요.

쿼리 매개변수

매개변수
options

object (GetPolicyOptions)

선택사항: instances.getIamPolicy에 대한 옵션을 지정하기 위한 GetPolicyOptions 객체입니다. 이 필드는 Cloud IAM에만 사용됩니다.

요청 본문

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

응답 본문

성공한 경우 응답 본문에 Policy의 인스턴스가 포함됩니다.

승인 범위

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

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

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

GetPolicyOptions

instances.getIamPolicy에 제공된 설정을 캡슐화합니다.

JSON 표현

{
  "requestedPolicyVersion": integer
}
필드
requestedPolicyVersion

integer

선택사항. 반환할 정책 형식 버전입니다.

유효한 값은 0, 1, 3입니다. 잘못된 값을 지정하는 요청은 거부됩니다.

조건부 바인딩이 있는 정책 요청은 버전 3을 지정해야 합니다. 조건부 바인딩이 없는 정책은 유효한 값을 지정하거나 필드를 설정되지 않은 상태로 둘 수 있습니다.