Method: projects.locations.dataStores.create

在给定的项目和位置中创建新 DataStore。

DataStore 的后备集合（请参阅 DataStore.collection_name）会随之创建。如果已存在具有该 ID 的集合，则请求会失败并显示 FAILED_PRECONDITION，例如，在删除具有相同 ID 的早期 DataStore 时未指定 backingCollectionDeleted，导致该集合被保留。

HTTP 请求

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

路径参数

参数
parent

string

必需。父级的值。

查询参数

参数
dataStoreId

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）。

请求正文

请求正文包含一个 DataStore 实例。

响应正文

如果成功，响应正文将包含一个新创建的 Operation 实例。

授权范围

需要以下 OAuth 范围之一：

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

如需了解详情，请参阅 Authentication Overview。