功能描述
用于更新文件的标签(Labels)或分类(Category)。
说明:
请求
请求示例
POST /api/v1/directory/{LibraryId}/{SpaceId}/{FilePath}?update&access_token={AccessToken}
请求参数
请求体
{"labels": ["动物", "大象", "亚洲象"],"category": "image","metaData": {"x-smh-meta-cache-control": "no-cache","x-smh-meta-author": "zhangsan"},"metaDataDirective": "merge","localCreationTime": "2022-07-26T02:58:09Z","localModificationTime": "2022-07-26T02:58:09Z"}
请求体字段说明:
请求参数 | 描述 | 类型 | 是否必选 |
labels | 文件标签列表, 比如大象 | String Array | 否 |
category | 文件自定义的分类,最大长度16字节,用户可通过更新文件接口修改文件的分类,也可以根据文件后缀预定义文件的分类信息 | String | 否 |
localCreationTime | 文件对应的本地创建时间,时间戳字符串 | String | 否 |
localModificationTime | 文件对应的本地修改时间,时间戳字符串 | 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 | 否 |
contentType | 更新文件的媒体类型,所有文件类型均支持 | String | 否 |
size | 更新虚拟文件的大小(单位:字节),更新后会重新计算存储配额(仅虚拟文件生效,普通文件忽略此字段) | String | 否 |
响应
响应码
获取成功,返回 HTTP 204 No Content。
响应体
该请求无响应体。