更新时间:2025-09-12 GMT+08:00
分享

删除向量

功能介绍

在指定的collection中删除一个或多个Entity。

URI

POST /v1/entities/delete

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

store_name

String

参数解释:

知识仓实例名称,region内唯一。

约束限制:

长度范围为3到63个字符,支持小写字母、数字、中划线(-),第一个字符只能够是小写字母,中划线(-)不得出现在字符串末尾。

取值范围:

不涉及

默认取值:

不涉及

collection_name

String

参数解释:

collection名称,知识仓内唯一。

约束限制:

长度范围为1到255个字符,支持字母、数字、中划线(-)和下划线(_),大小写敏感。第一个字符只能够是下划线(_)和字母,中划线(-)不得出现在字符串末尾。

取值范围:

不涉及。

默认取值:

不涉及。

filter

String

参数解释:

用于过滤匹配entity的标量过滤条件。

约束限制:

要构建标量过滤条件,请参阅filter表达式规则。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

code

String

参数解释:

返回码。参见错误码章节。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

message

String

参数解释:

描述信息。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

状态码:400

表3 响应Body参数

参数

参数类型

描述

code

String

参数解释:

返回码。参见错误码章节。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

message

String

参数解释:

描述信息。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求示例

/v1/entities/delete

{
  "store_name" : "test-storename",
  "collection_name" : "test-collection",
  "filter" : "pk > 2"
}

响应示例

状态码:200

删除entity成功

response:
{
    "code": "LMS.00000000",
    "message": "delete entities success"
}

状态码:400

Entity删除失败

{
  "code" : "LMS.00004006",
  "message" : "IllegalFilter : the number of condition expressions exceeds the upper limit, or the syntax is incorrect."
}

状态码

状态码

描述

200

删除entity成功

400

Entity删除失败

错误码

请参见错误码

相关文档