You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /对象存储/API 参考/对象/基础操作/RenameObject
RenameObject
最近更新时间：2025.02.20 14:43:34首次发布时间：2024.04.26 11:37:19
我的收藏

功能描述

调用 RenameObject 接口重命名对象。

前提条件

扁平桶（FNS）：已开启 RenameObject 功能。具体操作，请参见使用 RenameObject或 PutBucketRename。
分层桶（HNS）：默认支持 RenameObject 功能，无需额外开启该功能。

注意事项

类别

注意事项

权限

执行 RenameObject 操作前，您需要确保使用的账号拥有 RenameObject 和 PutObject 权限，如果没有，您可以授予账号对应权限，具体操作，请参见授予 IAM 用户 RenameObject 的权限。

约束限制

RenameObject 功能与版本控制功能互斥。如果您的存储桶已开启或暂停版本控制功能，则将无法使用 RenameObject 功能。（分层桶暂不支持版本控制，不受此约束。）

重命名的内容

RenameObject 接口会修改对象的名称，同时更新对象的修改时间。

重命名的对象

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

请求消息样式

PUT /objectName?name=Name&rename HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: GMT Date
Authorization: authorization string

请求参数和消息头

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

名称

位置

参数类型

是否必选

示例值

说明

rename

Query

String

是

-

只需设置参数名称，无需设置参数值，代表 RenameObject 请求的特殊标识。

name

Query

String

是

dst-object

重命名对象后的名称。

x-tos-forbid-overwrite

Header

String

否

false

是否允许覆盖同名对象，取值说明如下：

  • false ：允许覆盖同名对象。
  • true ：禁止覆盖同名对象。

默认为 false，即默认允许覆盖同名对象。

请求元素

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

响应消息头

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

响应元素

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

请求示例

PUT /src-object?name=dst-object&rename HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: GMT Date
Authorization: authorization string

响应示例

HTTP/1.1 204 No Content
x-tos-id-2: 367be10900210004-a444ed0
x-tos-request-id: 367be10900210004-a444ed0
Date: Fri, 1 Jul 2022 01:00:36 GMT
Server: TosServer