更新时间:2024-04-15 GMT+08:00

重命名对象

功能介绍

重命名对象操作是指将指定文件桶内的一个对象重命名为其他对象名。

目前接口仅在并行文件系统支持,创建并行文件系统的方法详见请求示例:创建并行文件系统。重命名对象操作为非幂等操作。

请求消息样式

POST /ObjectName?name=Name&rename HTTP/1.1
Host: bucketname.obs.region.example.com
Authorization: authorization
Date: date

请求消息参数

该请求需要在消息中指定参数,表明这是重命名操作,同时指定本次重命名后的对象名称。参数说明如表1所示。

表1 请求消息参数

参数名称

描述

是否必选

name

重命名后的对象名称,请使用绝对路径。

类型:String

rename

表明这是重命名操作。

类型:String

请求消息头

该请求使用公共的请求消息头,具体如表3所示。

请求消息元素

该请求消息头中不带消息元素。

响应消息样式

1
2
3
4
5
HTTP/1.1 204 status_code
Server: OBS
x-obs-request-id: request-id
x-obs-id-2: id
Date: Date

响应消息头

该请求的响应消息使用公共消息头,具体请参考表1

响应消息元素

该请求的响应消息中不带消息元素。

错误响应消息

无特殊错误,所有错误已经包含在表2中。

请求示例

POST /ObjectName?name=file2&rename HTTP/1.1
Host: examplebucket.obs.region.example.com
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
Date: WED, 01 Jul 2015 04:19:20 GMT

响应示例

1
2
3
4
5
HTTP/1.1 204 No Content
Server: OBS
x-obs-request-id: 8DF400000163D3F51DEA05AC9CA066F1
x-obs-id-2: 32AAAUgAIAABAAAQAAEAABAAAQAAEAABCSgkM4Dij80gAeFY8pAZIwx72QhDeBZ5
Date: WED, 01 Jul 2015 04:19:21 GMT