此接口用于更新已经上传对象的元数据信息。TOS 支持携带以下 6 个请求头来修改对象元数据，在下载对象或者 HEAD 对象时，这些值会设置到 HTTP 头域中返回给客户端。支持的 6 个头域：Cache-Control、Content-Disposition、Content-Encoding、Expires、Content-Type、Content-Language。
该接口会完整替换对象元数据，未指定的元数据会被删除。
使用 SetObjectMeta 接口更新归档存储、冷归档存储和深度冷归档存储对象的元数据前，需要先恢复对象。
POST /ObjectName?metadata HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: GMT Date Authorization: authorization string <Optional Additional Header>
该请求使用的公共请求消息头，请参见公共参数。
名称 | 位置 | 参数类型 | 是否必选 | 示例值 | 说明 |
|---|---|---|---|---|---|
metadata | Query | String | 是 | - | 代表 SetObjectMeta 请求的特殊标识。 |
versionId | Query | String | 否 | 57AF1A32CECB56721267 | 对象的版本号。标识更改指定版本的对象自定义元数据。 |
Content-Type | Header | String | 否 | text/plain | 对象类型。 |
Cache-Control | Header | String | 否 | no-cache, no-store, must-revalidate | 指定该对象被下载时网页的缓存行为。 |
Expires | Header | String | 否 | Mon, 04 Jul 2022 02:57:31 GMT | RFC2616 中定义的缓存失效时间。 |
Content-Disposition | Header | String | 否 | attachment; filename=123.txt | 对象被下载时的名称。 |
Content-Encoding | Header | String | 否 | gzip | 对象被下载时的内容编码类型。 |
Content-Language | Header | String | 否 | en-US | 对象被下载时的内容语言格式。 |
x-tos-meta-* | Header | String | 否 | x-tos-meta-key: value | 创建对象时，可以在 HTTP 请求中加入以 x-tos-meta-开头的消息头，用来加入自定义的元数据，以便对对象进行自定义管理。当用户获取此对象或查询此对象元数据时，加入的自定义元数据将会在返回消息的头中出现。 |
该请求中无请求消息元素。
该请求返回公共响应消息头，请参见公共参数。
该请求响应中无消息元素。
给对象添加元数据Content-Type: application/x-www-form-urlencoded 和 x-tos-meta-test: meta-test。
POST /ObjectName?metadata HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 GMT Authorization: authorization string Content-Type: application/x-www-form-urlencoded x-tos-meta-test: meta-test
HTTP/1.1 200 OK x-tos-id-2: f91b0c03a01300c1-a444ed0 x-tos-request-id: f91b0c03a01300c1-a444ed0 Date: Fri, 30 Jul 2021 08:05:36 GMT server: TosServer Content-Length: 0
修改对象元数据，已经存在Content-Type: application/x-www-form-urlencoded和x-tos-meta-test: meta_test，修改为x-tos-meta-test: meta_modify。
POST /ObjectName?metadata HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 GMT Authorization: authorization string Content-Type: application/x-www-form-urlencoded x-tos-meta-test: meta_modify
HTTP/1.1 200 OK x-tos-id-2: 92ab6a0bb2ff0006-a444ed0 x-tos-request-id: 92ab6a0bb2ff0006-a444ed0 Date: Fri, 30 Jul 2021 08:05:36 GMT server: TosServer Content-Length: 0