七牛云文件重命名接口php,资源移动／重命名

将源空间的指定资源移动到目标空间，或在同一空间内对资源重命名。如果目标资源名已被占用，则返回错误码614，且不做任何覆盖操作。

注意：

源空间和目标空间必须属于相同帐号，跨帐号移动文件不支持。

资源不支持跨存储区域move。

归档存储文件，只有解冻状态才允许调用本接口

请求报文

请求语法

POST /move///force/

HTTP/1.1

Host: rs.qbox.me

Content-Type: application/x-www-form-urlencoded

Authorization: Qiniu

EncodedEntryURISrc与EncodedEntryURIDest的细节请参考EncodedEntryURI。

访问权限

头部信息

头部名称

必填

说明

Authorization

是

该参数应严格按照管理凭证格式进行填充，否则会返回401错误码

一个合法的Authorization值应类似于：Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7...

响应报文

响应语法

HTTP/1.1 200 OK

Content-Type: application/json

Cache-Control: no-store

头部信息

头部名称

必填

说明

Content-Type

是

正常情况下该值将被设为application/json，表示返回JSON格式的文本信息。

其它可能返回的头部信息，请参考HTTP扩展字段。

响应内容

如果请求成功，不返回任何内容。

如果请求失败，返回包含如下内容的JSON字符串(已格式化，便于阅读)：

{

"error": "",

}字段名称

必填

说明

error

是

与HTTP状态码对应的消息文本

响应状态码

HTTP状态码

含义

200

移动成功

400

请求报文格式错误

401

管理凭证无效

403

禁止操作

当归档存储文件未解冻完成调用接口会返回403 ArchiveUnrestored {"error":"archive unrestored"}

599

服务端操作失败

612

待移动资源不存在

614

目标资源已存在

如遇599错误，请将完整错误信息(包括所有HTTP响应头部)提交工单 给我们。

示例

命令行示例

curl -i \

-o - \

-H 'Content-Type: application/x-www-form-urlencoded' \

-H 'Authorization: Qiniu u8WqmQu1jH21kxpIQmo2LqntzugM1VoHE9_pozCU:2LJIG...' \

-X POST \

'http://rs.qbox.me/move/bmV3ZG9jczpmaW5kX21hbi50eHQ=/bmV3ZG9jczpmaW5kLm1hbi50eHQ='

请求示例

POST /move/bmV3ZG9jczpmaW5kX21hbi50eHQ=/bmV3ZG9jczpmaW5kLm1hbi50eHQ= HTTP/1.1

User-Agent: curl/7.30.0

Host: rs.qbox.me

Accept: */*

Authorization: Qiniu u8WqmQu1jH21kxpIQmo2LqntzugM1VoHE9_pozCU:2LJIG...(过长已省略)

注意：要在Authorization头部的前添加Qiniu和半角空格。

响应示例

HTTP/1.1 200 OK

Server: nginx/1.0.8

Date: Thu, 05 Dec 2013 06:55:29 GMT

Content-Type: application/json

Connection: keep-alive

Content-Length: 0

X-Reqid: wxIAAD3btw-v3TwT