文档中心

向量数据库VikingDB

请输入

文件系统操作 (File System Operations)

mv- 移动资源

概述

/api/v1/fs/mv 接口用于在 OpenViking 文件系统中移动文件或目录，将资源从源 URI 移动到目标 URI。

前置条件

完成 "数据库访问使用说明" 页面的 API Key 获取后，可调用本接口移动资源。

请求接口

URI	/api/v1/fs/mv	统一资源标识符
请求方法	POST	客户端请求类型
请求头	Content-Type: application/json	请求消息类型
	Authorization: Bearer	Bearer Token 鉴权

请求参数

参数	类型	必选	默认值	备注
from_uri	string	是	--	源 Viking URI 要移动的文件或目录的原始 URI。
to_uri	string	是	--	目标 Viking URI 移动后的目标 URI。

响应消息

字段	参数说明
status	请求状态，成功为 `"ok"`，失败为 `"error"`
result	成功时返回的数据对象
result.from	源 URI
result.to	目标 URI
telemetry	遥测信息，通常为 `null`
error	失败时返回的错误对象
error.code	错误码字符串，常见值见下表
error.message	可读的错误描述

常见错误码：

error.code	说明
UNAUTHENTICATED	缺少或无效的 API Key
PERMISSION_DENIED	权限不足
INVALID_ARGUMENT	无效参数
INVALID_URI	无效的 Viking URI 格式
NOT_FOUND	资源未找到

完整示例

示例一：移动目录

curl -X POST https://xxx/api/v1/fs/mv \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "from_uri": "viking://resources/old-name/",
    "to_uri": "viking://resources/new-name/"
  }'

执行成功返回：

HTTP/1.1 200 OK
Content-Type: application/json

{
    "status": "ok",
    "result": {
        "from": "viking://resources/old-name/",
        "to": "viking://resources/new-name/"
    },
    "error": null,
    "telemetry": null
}

参数、示例与排错补充

返回参数描述不完整：返回结构采用统一包装：status 为 string，result 为 object/array/null，telemetry 为 object/null，error 为 object/null；业务子字段的类型和层级与成功示例保持一致。
请求示例与请求参数说明不符：请求示例统一使用 Authorization: Bearer <API_KEY>，与请求头参数表保持一致。
错误码原因或处理建议缺失：错误处理建议：UNAUTHENTICATED：检查并重新生成 API Key；PERMISSION_DENIED：确认 Agent/账号对目标 URI 有权限；INVALID_ARGUMENT：按参数表检查类型、范围和必填项；NOT_FOUND：确认 URI 或资源 ID 存在；INTERNAL：记录 request ID 后重试，持续失败时提交工单。

最近更新时间：2026.09.22 22:17:17

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

示例一：移动目录 #

参数、示例与排错补充 #

示例一：移动目录

参数、示例与排错补充