此接口用于更新已经上传对象的元数据信息。TOS 支持携带指定请求头来修改对象元数据，在下载对象或者 HEAD 对象时，这些值会设置到 HTTP 头域中，并返回给客户端。支持的头域：Cache-Control、Content-Disposition、Content-Encoding、Expires、Content-Type、Content-Language、x-tos-meta-*。

注意事项

使用 SetObjectMeta 接口更新归档存储、冷归档存储和深度冷归档存储对象的元数据前，需要先恢复对象。

请求消息样式

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
metadata	Query	String	是	-	代表 SetObjectMeta 请求的特殊标识。
versionId	Query	String	否	57AF1A32CECB56721267	对象的版本号。标识更改指定版本的对象自定义元数据。
x-tos-metadata-directive	Header	String	否	REPLACE_NEW	修改元数据的方式。取值说明如下： REPLACE_NEW：表示对于已经存在值的元数据进行替换，不存在值的元数据进行赋值，未指定的元数据保持不变。 REPLACE：使用当前请求中携带的头域完整替换，未指定的元数据会被删除。若未指定该参数，默认值为 REPLACE_NEW。
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-开头的消息头，用来加入自定义的元数据，以便对对象进行自定义管理。当用户获取此对象或查询此对象元数据时，加入的自定义元数据将会在返回消息的头中出现。
x-tos-object-expires	Header	String	否	3	为对象添加过期时间，或修改对象的过期时间，过期后，TOS 将自动删除对象。单位为天。参数值仅为正整数，表示对象将在指定时间过期，从对象的 Last‑Modified 时间开始计算，在到达该过期时间后的零点开始执行删除任务。例如设置 x-tos-object-expires 参数的值为 3，对象的 Last‑Modified 时间为 2024-09-26 12:00，则该对象将于 2024-09-30 00:00 过期。说明为了给您提供更加优质的服务，火山引擎对象存储产品预计将于 2025 年 10 月 15 日下线 SetObjectMeta 接口中修改对象过期时间的功能，请您使用新的专用接口 SetObjectExpires 进行替代。详细介绍，请参见对象存储 SetObjectMeta 接口设置对象过期时间功能下线通知。对象过期时间优先级高于生命周期的删除规则，例如设置对象过期时间为 5 天，生命周期规则指定该对象 3 天后删除，最终将按照对象过期时间执行，即对象将于 5 天后被删除。

请求元素

该请求中无请求消息元素。

响应消息头

该请求返回公共响应消息头，请参见公共参数。

响应元素

该请求响应中无消息元素。

请求示例 1

给对象添加元数据Content-Type: application/x-www-form-urlencoded 和 x-tos-meta-test: meta-test。

响应示例 1

请求示例 2

修改对象元数据，已经存在Content-Type: application/x-www-form-urlencoded和x-tos-meta-test: meta_test，修改为x-tos-meta-test: meta_modify。

响应示例 2

对象存储