Method: projects.locations.investigations.getIamPolicy

取得資源的存取權控管政策。如果該資源存在且未設定政策,則會傳回空的政策。

HTTP 要求

GET https://geminicloudassist.googleapis.com/v1alpha/{resource=projects/*/locations/*/investigations/*}:getIamPolicy

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
resource

string

必要:要求的政策資源。如要瞭解這個欄位的適當值,請參閱「資源名稱」。

查詢參數

參數
options

object (GetPolicyOptions)

選用:用來指定 investigations.getIamPolicy 相關選項的 GetPolicyOptions 物件。

要求主體

要求主體必須為空白。

回應主體

如果成功,回應主體會包含 Policy 的執行個體。

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱Authentication Overview

IAM 權限

需要 resource 資源的下列 IAM 權限:

  • geminicloudassist.investigations.getIamPolicy

詳情請參閱 IAM 說明文件

GetPolicyOptions

封裝提供給 investigations.getIamPolicy 的設定。

JSON 表示法
{
  "requestedPolicyVersion": integer
}
欄位
requestedPolicyVersion

integer

(選用步驟) 用於設定政策格式的最高政策版本。

有效值為 0、1 和 3。如果要求指定的值無效,系統會拒絕要求。

如果政策包含任何條件式角色繫結,要求就必須指定版本 3。如果政策沒有條件角色繫結,可以指定任何有效值,或將欄位留空。

回應中的政策可能會使用您指定的政策版本,也可能使用較低的政策版本。舉例來說,如果您指定版本 3,但政策沒有條件式角色繫結,回應就會使用版本 1。

如要瞭解哪些資源的 IAM 政策支援條件,請參閱 IAM 說明文件