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

注意：

• 源空间和目标空间必须属于相同帐号，跨帐号移动文件不支持。
• 资源不支持跨存储区域move。
• 归档存储文件，只有解冻状态才允许调用本接口

请求报文

请求语法

POST /move/<EncodedEntryURISrc>/<EncodedEntryURIDest>/force/<true|false>  
HTTP/1.1
Host:           rs.qbox.me
Content-Type:   application/x-www-form-urlencoded
Authorization:  Qiniu <AccessToken>

EncodedEntryURISrc与EncodedEntryURIDest的细节请参考EncodedEntryURI。

访问权限

管理凭证方式。

头部信息

响应报文

响应语法

HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store

头部信息

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

响应内容

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

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

{
    "error":   "<errMsg    string>",
}

响应状态码

示例

命令行示例

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头部的<AccessToken>前添加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