Method: projects.locations.dataStores.create

在指定專案和位置建立新的 DataStore。

DataStore 的備份集合 (請參閱 DataStore.collection_name) 會與 DataStore 一併建立。如果已有相同 ID 的集合 (例如先前刪除相同 ID 的 DataStore 時，未指定 backingCollectionDeleted 而保留的集合)，要求就會失敗，並傳回 FAILED_PRECONDITION。

HTTP 要求

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

路徑參數

參數
parent

string

這是必要旗標，上層的值。

查詢參數

參數
dataStoreId

string

這是必要旗標，要建立的 DataStore 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)。

要求主體

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

回應主體

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

授權範圍

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

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

詳情請參閱Authentication Overview。