金山云-文档中心-Delete Vector Bucket

对象存储(KS3)

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

对象存储(KS3)

API文档

向量存储桶（KS3 Vectors）

向量存储桶相关

Delete Vector Bucket

最近更新时间：2026-11-03 19:52:57



描述

删除向量存储桶。使用此接口，您必须是这个 Bucket 的拥有者或拥有 ks3:DeleteVectorBucket 权限。

1.删除向量 Bucket 前,必须先删除向量 Bucket 下的所有向量索引,否则删除失败。

2.使用 AWS4 签名协议时，资源标识字段为 vectorBucketArn
3.删除操作为高危操作,删除后不支持进入回收站,请谨慎操作,确保已备份重要数据。

请求

请求语法

POST /DeleteVectorBucket 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"
}

也可以使用 vectorBucketKrn 指定目标桶，此时请求体为：

{
  "vectorBucketKrn": "krn:ksc:ks3vectors:cn-beijing:103735000000:bucket/example-bucket"
}

可通过向量桶名称或向量桶 KRN 指定要删除的向量桶，vectorBucketName 与 vectorBucketKrn 严格二选一。同时提供返回 400 VectorBucketNameAndArnConflict，都不提供返回 400 VectorBucketInfoMissing

请求参数

该接口不使用请求参数。

请求头

该接口仅使用公共请求头。请求体和响应体均使用 JSON 格式。

请求体

参数	类型	是否必填	示例值	说明
vectorBucketName	string	否（与 `vectorBucketKrn` 二选一）	test-vector-bucket	要删除的向量桶名称。
vectorBucketKrn	string	否（与 `vectorBucketName` 二选一）	krn:ksc:ks3vectors:cn-beijing:210676****:bucket/test-vector-bucket	要删除的向量桶资源标识，格式为 `krn:ksc:ks3vectors:<region>:<accountId>:bucket/<bucketName>`。

响应

响应头

该接口仅返回公共响应头。

响应体

如果操作成功，服务返回 HTTP 200 响应且响应体为空。如果操作失败，返回响应码中定义的错误码。

错误码

HTTP 状态码	错误码	描述	典型触发场景
400	ValidationException	请求不合法	请求体为空或 JSON 格式错误；`vectorBucketName` 与 `vectorBucketKrn` 同时提供（`VectorBucketNameAndArnConflict`）或都未提供（`VectorBucketInfoMissing`）；桶名/KRN 格式非法或 KRN 中的 region 与服务端配置不一致
403	AccessDeniedException	访问被拒绝	签名校验失败；无 `ks3:DeleteVectorBucket` 权限
404	NotFoundException	资源不存在	指定的向量桶不存在（`NoSuchBucket`）
409	ConflictException	桶不为空（需先删除全部索引）或桶处于迁移状态，请稍后重试	桶下仍有向量索引（`VectorBucketNotEmpty`）或桶处于迁移状态（`BucketInTransition`）
500	InternalServerException	服务内部错误	服务内部异常

具体错误码通过响应头 x-kss-error-code 返回。

错误响应体格式示例：

{"message": "The vectorBucketName is invalid.", "fieldList": [{"path": "/vectorBucketName", "message": "..."}]}

fieldList 仅校验类错误携带；非校验类错误只返回 message。

文档导读

上一篇：Create Vector Bucket

下一篇：Get Vector Bucket

纯净模式常规模式

纯净模式

点击可全屏预览文档内容