RenameObject--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

RenameObject

最近更新时间：2024.08.01 20:30:33首次发布时间：2024.04.26 11:37:19

功能描述

调用 RenameObject 接口重命名对象。

前提条件

已开启 RenameObject 功能。具体操作，请参见使用 RenameObject或 PutBucketRename。

注意事项

类别	注意事项
约束限制	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