Method: projects.locations.setUpDataConnector

建立 Collection 並為其設定 DataConnector。如要在設定後停止 DataConnector,請使用 CollectionService.DeleteCollection 方法。

HTTP 要求

POST https://discoveryengine.googleapis.com/v1/{parent=projects/*/locations/*}:setUpDataConnector

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

路徑參數

參數
parent

string

這是必要旗標,Collection 的父項,格式為 projects/{project}/locations/{location}

要求主體

要求主體包含下列結構的資料:

JSON 表示法
{
  "collectionId": string,
  "collectionDisplayName": string,
  "dataConnector": {
    object (DataConnector)
  }
}
欄位
collectionId

string

這是必要旗標,要用於 Collection 的 ID,會成為 Collection 資源名稱的最終元件。系統會在 DataConnector 設定程序中建立新的 CollectionDataConnectorCollection 下的單例資源,可管理 Collection 的所有 DataStore

這個欄位必須符合 RFC-1034 標準,長度上限為 63 個字元。否則,系統會傳回 INVALID_ARGUMENT 錯誤。

collectionDisplayName

string

這是必要旗標,Collection 的顯示名稱。

應為使用者可理解的名稱,用於在管理中心資訊主頁中顯示集合。採用 UTF-8 編碼的字串,最多 1024 個字元。

dataConnector

object (DataConnector)

這是必要旗標,要在新建立的 Collection 中初始化的 DataConnector

回應主體

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

授權範圍

需要下列其中一種 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

IAM 權限

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

  • discoveryengine.locations.setUpDataConnector

詳情請參閱 IAM 說明文件