文档中心

对象存储

请输入

基础设置

使用 RenameObject

对象存储支持 RenameObject 功能，即在存储桶内直接重命名对象。您可以开启 RenameObject 功能，然后使用 RenameObject 接口重命名对象。本文介绍开启、使用和关闭 RenameObject 功能的背景信息、注意事项和操作步骤。

背景信息

RenameObject 功能与重命名文件功能不是同一个功能，相比重命名文件功能，RenameObject 功能重命名对象的速度更快，可以毫秒级完成重命名。RenameObject 功能支持重命名所有类型的对象名称，重命名 Appendable 对象的名称后，该对象将仍然保持与原对象相同的 Append 能力。

注意事项

类别	注意事项
重命名的内容	RenameObject 接口仅会修改对象的名称，不会修改对象的修改时间等元数据。
重命名的对象	仅支持重命名开启 RenameObject 后新上传的对象，不支持重命名开启该功能前的存量对象。归档存储、冷归档存储和深度冷归档存储类型文件只有恢复后，才可以使用 RenameObject 功能进行重命名。具体操作，请参见恢复文件。不支持使用 RenameObject 功能并发重命名同一个对象。 RenameObject 支持重命名所有类型创建的对象，包括 Put、Multi-Upload、Append、Copy、Rename 等创建的对象。其中 Appendable 对象 Rename 后，仍然保持与原对象相同的 Append 能力。

开启 RenameObject

在创建存储桶时开启 RenameObject

登录对象存储控制台。

在左侧导航栏单击桶列表，在右侧页面左上方单击创建桶。

在创建存储桶页面，设置存储桶参数，单击高级设置，开启 RenameObject 功能。

说明

设置存储桶参数时，只有当版本控制设置为不开通时，才会在高级设置区域出现 RenameObject 功能信息。

关于创建存储桶的其他参数说明，请参见创建存储桶。

单击确定。

对已创建的存储桶开启 RenameObject

TOS 支持在控制台开启 RenameObject 功能，也支持调用 PutBucketRename 接口开启 RenameObject 功能，关于 PutBucketRename 的详细介绍，请参见 PutBucketRename。

登录对象存储控制台。

在左侧导航栏，单击桶列表，在桶列表页面单击目标桶名称。

在左侧导航栏，选择基础设置 > RenameObject。

在 RenameObject 页面，单击编辑。

选择开启 RenameObject 功能，单击确定。

在弹出的对话框，单击确认。

说明

RenameObject 功能与版本控制功能互斥。如果您的存储桶已开启或暂停版本控制功能，则将无法使用 RenameObject 功能。

使用 RenameObject

开启 RenameObject 功能后，您可以使用 RenameObject 接口重命名对象。详细介绍，请参见 RenameObject。

关闭 RenameObject

TOS 支持在控制台关闭 RenameObject 功能，也支持调用 DeleteBucketRename 接口关闭 RenameObject 功能，关于 DeleteBucketRename 的详细介绍，请参见 DeleteBucketRename。

登录对象存储控制台。

在左侧导航栏，单击桶列表，在桶列表页面单击目标桶名称。

在左侧导航栏，选择基础设置 > RenameObject。

在 RenameObject 页面，单击编辑。

选择关闭 RenameObject 功能，单击确定。

在弹出的对话框，单击确认。

最近更新时间：2026.07.06 10:50:06

这个页面对您有帮助吗？

有用

无用