帮你快速理解、总结文档立即下载

更新目录标签

最近更新时间:2026-08-18 20:40:02
我的收藏

功能描述

用于更新目录自定义标签。
说明:
要求权限:admin、space_admin。有关权限详情可参见 生成访问令牌接口

请求

请求示例

POST /api/v1/directory/{LibraryId}/{SpaceId}/{DirPath}?update&access_token={AccessToken}

请求参数

请求参数
描述
类型
是否必选
LibraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
SpaceId
空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(`-`);如果媒体库为多租户模式,则为具体 ID,获取请参见 创建租户空间
String
DirPath
目录路径或相簿名,对于多级目录,使用斜杠(/)分隔,例如 foo/bar;对于根目录,该参数留空
String
AccessToken
访问令牌,获取请参见 生成访问令牌
String

请求体

{
"labels": ["动物", "大象", "亚洲象"],
"metaData": {
"x-smh-meta-cache-control": "no-cache",
"x-smh-meta-author": "zhangsan"
},
"metaDataDirective": "merge"
}
请求参数
描述
类型
是否必选
labels
文件标签列表,比如大象
String
metaData
自定义元数据键值对,类型为 object (map[string]string),key 为小写字符串
Object
metaDataDirective
元数据更新策略,可选值为 merge(默认)或 replace
merge:JSON Merge Patch 语义,只更新传入的字段,未传入的字段保持不变,将某个 key 的值设为 null 可以删除该 key
replace:全量替换,用请求中的 metaData 完全替换已有的 MetaData,未在请求中出现的 key 会被删除。仅替换 MetaData 部分,InternalInfo 和 Labels 不受影响
String

响应

响应码

获取成功,返回 HTTP 204 No Content。

响应体

该请求无响应体。

错误码

该请求操作无特殊错误信息,常见的错误信息请参见 错误码 文档。