Method: projects.tenants.getIamPolicy

리소스의 액세스 제어 정책을 가져옵니다. 리소스가 없으면 오류가 반환됩니다. 리소스가 존재하지만 설정된 정책이 없는 경우 빈 정책이 반환됩니다. 호출자에게 리소스에 대한 적절한 Google IAM 권한이 있어야 합니다.

HTTP 요청

POST https://identitytoolkit.googleapis.com/admin/v2/{resource=projects/*/tenants/*}:getIamPolicy

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

경로 매개변수

매개변수
resource

string

필수 항목입니다. 정책을 요청할 리소스입니다. 이 필드의 적절한 값은 리소스 이름을 참조하세요.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "options": {
    object (GetPolicyOptions)
  }
}
필드
options

object (GetPolicyOptions)

선택사항: tenants.getIamPolicy에 대한 옵션을 지정하기 위한 GetPolicyOptions 객체입니다.

응답 본문

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

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

자세한 내용은 Authentication Overview를 참고하세요.

GetPolicyOptions

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

JSON 표현 
{
  "requestedPolicyVersion": integer
}
필드
requestedPolicyVersion

integer

선택사항. 정책 형식을 지정하는 데 사용할 최대 정책 버전입니다.

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

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

응답의 정책은 지정된 정책 버전을 사용하거나 더 낮은 정책 버전을 사용할 수 있습니다. 예를 들어 버전 3을 지정했지만 정책에 조건부 역할 바인딩이 없으면 응답은 버전 1을 사용합니다.

IAM 정책의 지원을 지원하는 리소스에 대해 알아보려면 IAM 문서를 참조하세요.