删除记忆库-DeleteCollection--向量数据库VikingDB-火山引擎

文档中心

立即注册

导航

向量数据库VikingDB

删除记忆库-DeleteCollection

最近更新时间：2025.11.18 15:59:35首次发布时间：2025.08.12 11:31:47

接口概述

删除一个已存在的记忆库。此操作不可逆，记忆库中的所有数据都将被永久删除。

请求接口

URL	/api/memory/collection/delete	统一资源标识符
请求方法	POST	客户端对记忆库服务器请求的操作类型
请求头	Content-Type: application/json	请求消息类型
请求头	Authorization: HMAC-SHA256 ***	基于AK/SK生成的签名信息

请求参数

参数名	类型	是否必须	描述
CollectionName	String	否	要删除的记忆库的唯一名称。
ProjectName	String	否	项目名称。默认为 default。
ResourceId	String	否	资源 ID。唯一标识符。

响应消息

操作成功时，HTTP状态码为200。

字段	类型	描述
ResponseMetadata	Object	响应元数据信息。
Region	String	服务区域，例如"cn-beijing"。
RequestId	String	请求唯一标识符。
Service	String	服务名称，如"knowledge_base_server"。
Version	String	API版本号。
Result	Object	成功与否，例如"success"。

示例代码

Python请求

import json
import requests
from volcengine.base.Request import Request
from volcengine.Credentials import Credentials
from volcengine.auth.SignerV4 import SignerV4

AK = "your AK"  # 替换成你的 AK
SK = "your SK"  # 替换成你的 SK
Domain = "api-knowledgebase.mlp.cn-beijing.volces.com"

def prepare_request(method, path, ak, sk, data=None):
    r = Request()
    r.set_shema("http")   # 注意这里是 http
    r.set_method(method)
    r.set_host(Domain)
    r.set_path(path)

    if data is not None:
        r.set_body(json.dumps(data))

    # 使用 air 服务和 cn-north-1 区域
    credentials = Credentials(ak, sk, 'air', 'cn-north-1')
    SignerV4.sign(r, credentials)
    return r

def internal_request(method, api, payload, params=None):
    req = prepare_request(
        method=method,
        path=api,
        ak=AK,
        sk=SK,
        data=payload
    )

    r = requests.request(
        method=req.method,
        url="{}://{}{}".format(req.schema, req.host, req.path),
        headers=req.headers,
        data=req.body,
        params=params,
    )
    return r

# 删除记忆库
path = "/api/memory/collection/delete"
payload = {
    "CollectionName": "my_first_memory_collection"
}
rsp = internal_request("POST", path, payload)
print(rsp.json())
if rsp.status_code == 200:
    print("记忆库删除成功:", rsp.json())
else:
    print("错误:", rsp.status_code, rsp.text)