Method: projects.tenants.getIamPolicy

取得資源的存取權控管政策。如果資源不存在，系統會傳回錯誤。如果資源存在，但未設定政策，系統會傳回空的政策。呼叫端必須具備資源的 Google IAM 權限。

HTTP 要求

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

這個網址使用 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 說明文件。