Method: projects.locations.collections.engines.assistants.agents.getIamPolicy

• HTTP 要求
• 路徑參數
• 查詢參數
• 要求主體
• 回應主體
• 授權範圍
• GetPolicyOptions
  • JSON 表示法

取得代理程式資源的存取權控管政策。如果資源不存在，系統會傳回 NOT_FOUND 錯誤。如果資源存在但未設定政策，則會傳回空的政策。

HTTP 要求

GET https://discoveryengine.googleapis.com/v1alpha/{resource=projects/*/locations/*/collections/*/engines/*/assistants/*/agents/*}:getIamPolicy

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

路徑參數

參數
resource	string 必要：要求的政策資源。如要瞭解這個欄位的適當值，請參閱「資源名稱」。

查詢參數

參數
options	object (GetPolicyOptions) 選用：用來指定 agents.getIamPolicy 相關選項的 GetPolicyOptions 物件。

要求主體

要求主體必須為空白。

回應主體

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

授權範圍

需要下列其中一種 OAuth 範圍：

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

詳情請參閱Authentication Overview。

GetPolicyOptions

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

JSON 表示法
{ "requestedPolicyVersion": integer }

欄位
requestedPolicyVersion	integer (選用步驟) 用於設定政策格式的最高政策版本。 有效值為 0、1 和 3。如果要求指定的值無效，系統會拒絕要求。 如果政策含有任何條件式角色繫結，要求就必須指定版本 3。如果政策沒有條件角色繫結，可以指定任何有效值，或將欄位留空。 回應中的政策可能會使用您指定的政策版本，也可能使用較低的政策版本。舉例來說，如果您指定版本 3，但政策沒有條件式角色繫結，回應就會使用版本 1。 如要瞭解哪些資源支援 IAM 政策中的條件，請參閱 IAM 說明文件。