文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>对象存储>向量存储与检索>向量存储桶>API 文档>向量操作>DeleteVectors

DeleteVectors

最近更新时间：2026-01-21 18:08:52

我的收藏

本页目录：

功能描述

DeleteVectors 接口请求可以根据 key 删除一条或多条向量数据。
说明：
单次 DeleteVectors 请求最多可删除500条向量数据。
删除后数据无法恢复，请谨慎操作。

授权说明

在您进行 策略授权 时，action 需要设置为cos:DeleteVectors，示例如下。
{
  "version": "2.0",
  "statement": [
    {
      "action": [
        "name/cos:DeleteVectors"
      ],
      "effect": "allow",
      "principal": {
        "qcs": [
          "qcs::cam::uin/700000000000:uin/700001234567"
        ]
      },
      "resource": [
        "qcs::cosvector:ap-guangzhou:uid/125000000:bucket/example-bucket-125000000/index/example-index/*"
      ],
      "sid": "example_index_action"
    }
  ]
}

向量存储桶的更多 action，请参见 支持的 Action。

请求

请求示例

POST /DeleteVectors HTTP/1.1
Host: vectors.<Region>.coslake.com
Date: GMT Date
Content-Type: application/json
Content-Length: Content Length
Content-MD5: MD5
Authorization: Auth String


[Request Body]
说明：
Host: vectors.<Region>.coslake.com，其中 <Region> 为可用地域，更多信息请参见 公共请求头部 文档。
Authorization: Auth String（详情请参见 请求签名 文档）。

请求参数

此接口无请求参数。

请求体


{
   "indexQcs": "string",
   "indexName": "string",
   "vectorBucketName": "string",
   "keys": [ ... ]
}

删除向量数据时提交 application/json 请求数据。您可以使用向量存储桶名称（vectorBucketName）和向量索引名称（indexName）的组合，也可以使用向量索引的资源六段式（indexQcs，详见向量存储桶的资源），任一方式指定目标向量索引。若同时指定，则需要二者指向同一目标向量索引。
节点名称（关键字）
父节点
描述
类型
是否必选
indexQcs
无
向量索引资源六段式，例如 qcs::cosvector:ap-guangzhou:uid/1250000000:bucket/examplebucket-1250000000/index/exampleindex，具体资源格式说明参见 向量存储桶的资源
String
否
indexName
无
向量索引名称，由小写字母、数字、短横线(-)、点(.)组成，首尾必须是小写字母或数字，长度限制3-63字符
String
否，indexQcs 没有值时必选
vectorBucketName
无
向量存储桶名称，<BucketName-APPID>格式，例如 examplebucket-1250000000，支持小写字母、数字和 - ，长度限制3-63字符
String
否，indexQcs 没有值时必选
keys
无
目标向量的主键 key
参数限制：
单个 key 长度限制为1～1024字符
数组长度为1～500
String 数组
是

响应

响应头

该接口请求仅返回公共响应头，参见 公共响应头部。

响应体

若请求成功，该接口请求返回 HTTP 200状态码与空响应体。

错误码

此接口遵循统一的错误响应和错误码，详情请参见 错误码 文档。

实际案例：删除向量

请求

POST /DeleteVectors HTTP/1.1
Host: vectors.ap-guangzhou.coslake.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": "example-index",
   "vectorBucketName": "example-bucket-125000000",
   "keys": [ "key-1", "key-2" ]
}

响应

HTTP/1.1 200 OK
Date: Tue, 30 Dec 2025 08:46:33 GMT
Content-Type: application/json
Content-Length: 0
Connection: close
X-Cos-Request-Id: MTg4NWYxZTQ2YTNmOTMyOF*************


中国站
目录