文档中心 > RenameObject
RenameObject

最近更新时间:2022-01-18

使用RenameObject接口将指定的某个bucket下的某个Object的名称进行修改。

如果要使用该接口,您需要具有该对象所在桶的操作权限以及对应对象的操作权限。您需要请求新的对象名称,并将您的源对象名称也一并请求,以此来完成操作。

需要特别注意的是,该操作无法适用于建立了多版本控制的桶内对象以及不是对象的名称操作(如修改桶内文件夹名称),所有的操作都必须在没有开启多版本控制的指定对象上进行操作。

请求

请求语法

PUT /ObjectName HTTP/1.1

Host: examplebucket.region.unicloudsrv.com

X-Amz-Rename-Source-Key: sourceObject

Date: date

Authorization: authorization string

请求消息头

参数

描述

X-Amz-Rename-Source-Key

传入需要修改的对象的名称(该名称不能是文件夹名称,且若为多版本控制桶下对象则不提供支持)

示例

请求示例

PUT /renameobject.jpg HTTP/1.1

Host: examplebucket.region.unicloudsrv.com

X-Amz-Rename-Source-Key: myobject.jpg

Date: Fri, 30 Oct 2009 05:00:00 GMT

Authorization: authorization string

返回示例

HTTP/1.1 200 OK

x-amz-rename-source-version-id: 3/L4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY+

x-amz-version-id: QUpfdndhfd8438MNFDN93jdnJFkdmqnh893

Date: Fri, 30 Oct 2009 22:32:00 GMT

<RenameObjectResult>

    <LastModified>2009-10-28T22:32:00</LastModified>

</RenameObjectResult>