全部文档
当前文档
最近更新时间：2026-11-03 19:52:57
创建向量存储桶。使用此接口，您必须是这个 Bucket 的拥有者或有 ks3:CreateVectorBucket 权限。
该功能受白名单控制，未开通时会返回 403。如有需要请联系商务或提交工单申请。
单一 UID 在同地域内的 Vector Bucket 命名具有唯一性
创建的向量Bucket数量超过上限。同一云账号在同一地域（Region）内最多可创建100个向量Bucket。
向量存储桶名称长度必须介于 3 到 63 个字符之间。
向量存储桶名称只能由小写字母（a-z）、数字（0-9）和连字符（-）组成。
向量存储桶名称必须以字母或数字开头和结尾。
我们建议在命名向量存储桶时遵循以下最佳实践：
使用反映向量数据用途的描述性名称（例如，product-recommendations、document-embeddings）。
避免在存储桶名称中使用敏感信息，因为它们可能出现在日志和 URL 中。
使名称保持简洁但有意义，以更便于管理和识别。
POST /CreateVectorBucket HTTP/1.1
Host: ks3vectors-cn-beijing.ksyuncs.com
Authorization: authorization string
Date: Mon, 10 Dec 2025 12:49:14 GMT
Content-Type: application/json
{
"vectorBucketName": "example-bucket"
}该接口不使用请求参数。
该接口仅使用公共请求头。
请求体为一段描述创建向量存储桶的 JSON
名称 | 数据类型 | 是否必选 | 描述 |
vectorBucketName | string | 是 | 要创建的向量桶的名称。 存储桶名称限制： 1.向量存储桶名称最小长度为 3,最大长度为 63 2.只能包含小写英文字母(a-z)、数字(0-9)以及短横线(-),不支持大写字母、下划线、中文或其他特殊字符 3.桶名的开头和结尾只能是小写字母或数字,不能以短横线开头或结尾 4.同一账号在同一地域内必须唯一 |
该接口仅返回公共响应头。
参数 | 类型 | 说明 |
vectorBucketKrn | string | 创建的向量桶资源标识，格式为 使用 AWS4 签名协议时，资源标识字段为 |
POST /CreateVectorBucket HTTP/1.1
Host: ks3vectors-cn-beijing.ksyuncs.com
Authorization: authorization string
Date: Mon, 10 Dec 2025 12:49:14 GMT
Content-Type: application/json
{
"vectorBucketName": "example-bucket"
}HTTP/1.1 200
Content-Type: application/json
x-kss-request-id: 534B371674E88A4D8906****
Date: Sat, 12 Sep 2025 07:51:28 GMT
Connection: keep-alive
{
"vectorBucketKrn": "krn:ksc:ks3vectors:cn-beijing:103735000000:bucket/example-bucket"
}HTTP 状态码 | 错误码 | 描述 | 典型触发场景 |
400 | ValidationException | 请求不合法 | 请求体为空或 JSON 格式错误； |
402 | ServiceQuotaExceededException | 请求超过服务配额 | 同一账号在同一地域的向量桶数量已达 100 个 |
403 | AccessDeniedException | 访问被拒绝 | 签名校验失败；无 |
409 | ConflictException | 桶名在该账号+地域内已被占用 | 同名向量桶已存在 |
500 | InternalServerException | 服务内部错误 | 服务内部异常 |
具体错误码通过响应头 x-kss-error-code 返回。
错误响应体格式示例：
{"message": "The vectorBucketName is invalid.", "fieldList": [{"path": "/vectorBucketName", "message": "..."}]}fieldList 仅校验类错误携带；非校验类错误只返回 message。
纯净模式