You need to enable JavaScript to run this app.
导航
RenameObject
最近更新时间:2024.06.20 20:04:17首次发布时间:2024.04.26 11:37:19

功能描述

调用 RenameObject 接口重命名对象。

前提条件

已开启 RenameObject 功能。具体操作,请参见使用 RenameObjectPutBucketRename

注意事项

类别

注意事项

约束限制

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

重命名对象后的名称。

请求元素

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

响应消息头

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

响应元素

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

请求示例

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