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

RenameObject

最近更新时间：2024.04.26 15:22:50

首次发布时间：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