金山云-文档中心-Delete Vectors

对象存储(KS3)

查看更多结果

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

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

对象存储(KS3)

API文档

向量存储桶（KS3 Vectors）

向量相关

Delete Vectors

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



描述

删除向量索引中的指定向量数据。使用此接口，您必须是这个 Bucket 的 Owner 或拥有 ks3:DeleteVectors 权限。

请求

请求语法

POST /DeleteVectors HTTP/1.1
Host: ks3vectors-cn-beijing.ksyuncs.com
Authorization: authorization string
Date: Mon, 10 Dec 2025 12:49:14 GMT

方式一：使用索引资源标识 indexKrn 指定目标索引。

{
  "indexKrn": "string",
  "keys": […]
}

方式二：使用 indexName + vectorBucketName 组合指定目标索引。

{
  "indexName": "string",
  "vectorBucketName": "string",
  "keys": […]
}

请求参数

该接口不使用请求参数。

请求头

该接口仅使用公共请求头。

请求体

请求体为一段删除向量的JSON，请求体内相关元素的具体描述如下：

参数	是否必填	类型	说明
indexKrn	否（与 `indexName` + `vectorBucketName` 二选一，必选其一）	String	向量索引资源名，格式为 `krn:ksc:ks3vectors:<region>:<accountId>:bucket/<bucketName>/index/<indexName>`。AWS4 签名下字段名为 `indexArn`。
indexName	否（与 `vectorBucketName` 成组使用，与 `indexKrn` 二选一）	String	向量索引名称。长度为 3~63 字符，仅允许小写字母和数字，首字符必须是字母。
vectorBucketName	否（与 `indexName` 成组使用，与 `indexKrn` 二选一）	String	向量存储桶名称。长度为 3~63 字符，允许小写字母、数字和 `-`，首尾不能是 `-`。
keys	是	Array	目标向量的主键列表，数组长度为 1~500，单个 `key` 长度为 1~1024 字符。

segmentCount 与 segmentIndex 必须同时提供或同时省略：只提供其中一个返回 400 SegmentParamsIncomplete；segmentIndex 大于 segmentCount 返回 400 InvalidSegmentIndex。

响应

响应头

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

响应体

该接口不返回响应体。

示例

请求示例

POST /DeleteVectors HTTP/1.1
Host: ks3vectors-cn-beijing.ksyuncs.com
Date: Tue, 30 Dec 2025 08:46:33 GMT
Content-Type: application/json
Content-Length: 45
Content-MD5: 1B2M2Y8AsgTpgAmY7PhCfg==
Authorization: q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1558882298;1558889498&q-key-time=1558882298;1558889498&q-header-list=content-length;date;host&q-url-param-list=&q-signature=****************************************

{
  "indexName": "exampleindex",
  "vectorBucketName": "example-bucket",
  "keys": ["doc-001", "doc-002", "doc-003"]
}

响应示例

HTTP/1.1 200 OK
Content-Length: 0
Connection: keep-alive
Date: Tue, 30 Dec 2025 08:46:33 GMT
Server: KS3
x-kss-request-id: 54a47bda18ac4e6e91de369add54218***

错误码

HTTP 状态码	错误码	描述	典型触发场景
400	ValidationException	请求不合法	`keys` 为空、数量超过 500 或单个 `key` 长度不在 1~1024 字符内；请求体格式错误；资源标识冲突或缺失。
403	AccessDeniedException	访问被拒绝	无 `ks3:DeleteVectors` 权限，或被桶策略拒绝。
404	NotFoundException	资源不存在	指定的向量桶或向量索引不存在。
500	InternalServerException	服务内部错误	服务内部异常。

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

错误响应体格式如下，fieldList 仅校验类错误携带；非校验类错误只返回 message：

{"message": "The indexName is invalid.", "fieldList": [{"path": "/indexName", "message": "indexName must be 3-63 characters, only lowercase letters and digits, starting with a lowercase letter."}]}

文档导读

上一篇：List Vectors

下一篇：Query Vectors

纯净模式常规模式

纯净模式

点击可全屏预览文档内容