You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /
  • 对象存储

使用 RenameObject

最近更新时间：2024.04.26 14:41:25

首次发布时间：2024.04.26 11:37:19

我的收藏

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

背景信息

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

注意事项

类别

注意事项

邀测

RenameObject 功能目前处于邀测状态，如您需要使用该功能，请联系客户经理。

约束限制

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

重命名的内容

RenameObject 接口仅会修改对象的名称，不会修改对象的修改时间等元数据。

重命名的对象

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

开启 RenameObject

在创建存储桶时开启 RenameObject

  1. 登录对象存储控制台。
  2. 在左侧导航栏单击桶列表，在右侧页面左上方单击创建桶。
  3. 在创建存储桶页面，设置存储桶参数，单击高级设置，开启 RenameObject 功能。

    说明

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

  4. 单击确定。

对已创建的存储桶开启 RenameObject

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

  1. 登录对象存储控制台。
  2. 在左侧导航栏，单击桶列表，在桶列表页面单击目标桶名称。
  3. 在左侧导航栏，选择基础设置 > RenameObject。
  4. 在 RenameObject 页面，单击编辑。
  5. 选择开启 RenameObject 功能，单击确定。
  6. 在弹出的对话框，单击确定。

使用 RenameObject

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

关闭 RenameObject

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

  1. 登录对象存储控制台。
  2. 在左侧导航栏，单击桶列表，在桶列表页面单击目标桶名称。
  3. 在左侧导航栏，选择基础设置 > RenameObject。
  4. 在 RenameObject 页面，单击编辑。
  5. 选择关闭 RenameObject 功能，单击确定。
  6. 在弹出的对话框，单击确定。