更新文件标签或分类

最近更新时间:2025-10-24 15:25:22

我的收藏

功能描述

用于更新文件的标签(Labels)或分类(Category)。
说明:
需要 admin 权限或 spaceAdmin 权限。有关权限详情请参见 生成访问令牌接口

请求

请求示例

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

请求参数

请求参数
描述
类型
是否必选
LibraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
SpaceId
空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(`-`);如果媒体库为多租户模式,则必须指定该参数,获取请参见 创建租户空间
String
FilePath
文件路径
String
AccessToken
访问令牌,对于公有读媒体库或租户空间,可不指定该参数,否则必须指定该参数获取请参见 生成访问令牌
String

请求体

{
"labels": ["动物", "大象", "亚洲象"],
"category": "image",
"localCreationTime": "2022-07-26T02:58:09Z",
"localModificationTime": "2022-07-26T02:58:09Z"
}
请求体字段说明:
请求参数
描述
类型
是否必选
labels
文件标签列表, 比如大象
String Array
category
文件自定义的分类,最大长度16字节,用户可通过更新文件接口修改文件的分类,也可以根据文件后缀预定义文件的分类信息
String
localCreationTime
文件对应的本地创建时间,时间戳字符串
String
localModificationTime
文件对应的本地修改时间,时间戳字符串
String

响应

响应码

获取成功,返回 HTTP 204 NO CONTENT。

响应体

该请求无响应体。

错误码

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