对象存储 SetObjectMeta 接口功能升级公告--对象存储-火山引擎

文档中心

立即注册

对象存储

请输入

产品公告

对象存储 SetObjectMeta 接口功能升级公告

为了给您提供更加优质的服务，火山引擎对象存储产品预计将于 2025 年 11 月 30 日对 SetObjectMeta 接口进行功能升级，新增一个关键参数，以支持更灵活的对象元数据管理能力。

预计变更时间

2025 年 11 月 30 日，具体变更时间请以控制台变更为准。

变更说明

本次变更对 SetObjectMeta 接口的更新对象元数据功能进行了升级，说明如下：

变更前：SetObjectMeta 接口仅支持全量覆盖方式更新对象元数据。调用 SetObjectMeta 接口更新对象元数据时，如果您在请求中仅指定了部分元数据，请求中指定的元数据会被更新，未指定的元数据会被删除。
变更后：SetObjectMeta 接口新增一个可选参数 x-tos-metadata-directive ，用于指定元数据更新方式，取值说明如下：
- REPLACE：全量覆盖元数据，请求中指定的元数据会被更新，未指定的元数据会被删除。
- REPLACE_NEW：增量更新元数据，仅会更新请求中指定的元数据，未指定的元数据保持不变。
  调用 SetObjectMeta 接口未指定 x-tos-metadata-directive 参数时，则默认使用增量更新元数据的方式，即仅会更新请求中指定的元数据，未指定的元数据保持不变。

对您的影响

变更后，您可以通过x-tos-metadata-directive参数选择元数据更新方式。如果您不使用 x-tos-metadata-directive 参数，SetObjectMeta 接口则默认使用增量更新元数据的方式，即仅会更新请求中指定的元数据，未指定的元数据保持不变。
如果您对变更有任何疑问，您可以提交工单或联系客户经理咨询。

最近更新时间：2025.10.28 10:21:21

这个页面对您有帮助吗？

有用

无用