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

PutBucketRename

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

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

我的收藏

功能描述

调用 PutBucketRename 接口为存储桶开启 RenameObject 功能。开启后，您可以使用 RenameObject 接口重命名对象。

注意事项

  • PutBucketRename 接口目前处于邀测状态，如您需要使用该接口，请联系客户经理。
  • 使用 PutBucketRename 接口开启 RenameObject 功能与版本控制功能互斥。如果您的存储桶已开启或暂停版本控制功能，则将无法使用 PutBucketRename 接口。

请求消息样式

PUT /?rename HTTP/1.1 
Host: bucketname.tos-cn-beijing.volces.com
Date: GMT Date
Authorization: authorization string
Content-Length: ContentLength

{ 
    "RenameEnable":true
}

请求参数和消息头

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

名称

位置

参数类型

是否必选

示例值

说明

rename

Query

String

是

-

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

请求元素

名称

参数类型

是否必选

示例值

说明

RenameEnable

Bool

是

true

是否开启 RenameObject 功能，取值仅为 true，表示开启 RenameObject 功能。

说明

如果您想关闭 RenameObject 功能，您可以使用 DeleteBucketRename 接口，详细介绍，请参见DeleteBucketRename。

响应消息头

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

响应元素

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

请求示例

PUT /?rename HTTP/1.1 
Host: bucketname.tos-cn-beijing.volces.com
Date: GMT Date
Authorization: authorization string
Content-Length: ContentLength

{ 
    "RenameEnable":true
}

响应示例

HTTP/1.1 200 OK
Date: Sat, 07 Oct 2023 09:02:23 GMT
Server: TosServer
x-tos-id-2: 1e89f203jld00006-a444fd0
x-tos-request-id: 1e89f203b2d00006-a444ed0
Content-Length: 0