调用DeleteVectors接口删除向量索引中的指定向量数据。
注意事项
支持批量删除向量数据。
删除操作不可逆，请谨慎操作。
权限说明
阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限，需要阿里云账号或账号管理员通过RAM Policy概述或Bucket Policy授予操作权限。
|
API |
Action |
说明 |
|
DeleteVectors |
|
删除向量数据。 |
请求语法
POST /?deleteVectors HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou-internal.oss-vectors.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
Content-type: application/json
{
"indexName": "string",
"keys": [string, string, string]
}请求头
此接口仅涉及公共请求头。更多信息，请参见公共HTTP头定义。
请求参数
|
名称 |
数据类型 |
是否必选 |
示例值 |
描述 |
|
indexName |
字符串 |
否 |
vectorindex1 |
索引名称。 |
|
keys |
容器 |
是 |
["doc-001", "doc-002"] |
向量主键列表。如果要删除的主键对应的向量不存在，不会报错。 限制：去重key数量 ∈ [1, 500] |
此接口还需要包含公共请求头。更多信息，请参见公共HTTP头定义。
响应头
此接口仅涉及公共响应头。更多信息，请参见公共HTTP头定义。
示例
请求示例
POST /?deleteVectors HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou-internal.oss-vectors.aliyuncs.com
Date: Thu, 17 Apr 2025 01:33:47 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218
Content-type: application/json
{
"indexName": "vectorindex1",
"keys": ["doc-001", "doc-002", "doc-003"]
}返回示例
HTTP/1.1 204 No Content
x-oss-request-id: 534B371674E88A4D8906****
Date: Thu, 17 Apr 2025 01:33:47 GMT
Connection: keep-alive
Server: AliyunOSSSDK
DeleteVectors接口所对应的各语言SDK如下：
命令行工具ossutil
DeleteVectors接口所对应的ossutil命令，请参见delete-vectors。
错误码
|
错误码 |
HTTP状态码 |
描述 |
|
VectorIndexParameterInvalid |
400 |
请求中提供的向量索引参数不合法。 |
|
MalformedJson |
400 |
请求体中的 JSON 格式不符合规范。 |
|
AccessDenied |
403 |
返回该错误的可能原因如下：
|
|
NoSuchVectorIndex |
404 |
指定的向量索引不存在。 |
|
QpsLimitExceeded |
503 |
QPS 限流（请求速率受限）。当 HTTP 状态码为 5xx 时，可能在同一批请求中只有部分数据删除成功，写入不具备原子性。 |