Method: projects.locations.collections.indexes.create

在指定專案和位置中建立新索引。

HTTP 要求

POST https://vectorsearch.googleapis.com/v1beta/{parent}/indexes

路徑參數

參數
parent

string

這是必要旗標,要建立索引的集合資源名稱。格式:projects/{project}/locations/{location}/collections/{collection}

查詢參數

參數
indexId

string

這是必要旗標,要建立的索引 ID。ID 長度必須介於 1 至 63 個字元之間,且符合 RFC1035。具體來說,長度必須介於 1 至 63 個字元之間,且符合規則運算式 [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?

requestId

string

選用。(選用) 用於識別要求的 ID。指定專屬要求 ID,這樣一來,如果必須重試要求,伺服器就會知道要忽略已完成的要求。伺服器會保證至少在第一次要求後的 60 分鐘內,

舉例來說,假設您提出初始要求,但要求逾時。如果使用相同要求 ID 再次提出要求,伺服器可以檢查是否已收到具有相同要求 ID 的原始作業,如果已收到,就會忽略第二次要求。避免客戶不慎建立重複的約期。

要求 ID 必須是有效的 UUID,但系統不支援零 UUID (00000000-0000-0000-0000-000000000000)。

要求主體

要求主體包含 Index 的執行個體。

回應主體

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

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱Authentication Overview

IAM 權限

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

  • vectorsearch.indexes.create

詳情請參閱 IAM 說明文件