描述
本接口用于将指定资源复制为新命名资源。
请求
语法
POST /copy/<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。
请求参数
参数名称 | 必填 | 说明 |
---|---|---|
EncodedEntryURISrc | 是 | 源资源EncodedEntryURI |
EncodedEntryURIDest | 是 | 目标资源EncodedEntryURI |
force | 否 | bool类型,默认false。如果目标资源名已被占用,则返回错误码614,且不做任何覆盖操作;如果指定为true,会强制覆盖目标资源 |
请求头
头部名称 | 必填 | 说明 |
---|---|---|
Authorization |
是 | 该参数应严格按照管理凭证格式进行填充,否则会返回401错误码 一个合法的Authorization值应类似于: |
响应
响应语法
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
头部信息
头部名称 | 必填 | 说明 |
---|---|---|
Content-Type | 是 | 正常情况下该值将被设为application/json ,表示返回JSON格式的文本信息。 |
响应内容
如果请求成功,不返回任何内容。
如果请求失败,返回包含如下内容的JSON字符串(已格式化,便于阅读):
{
"error": "<errMsg string>",
}
字段名称 | 必填 | 说明 |
---|---|---|
error | 是 | 与HTTP状态码对应的消息文本 |
响应状态码
HTTP状态码 | 含义 |
---|---|
200 | 复制成功 |
400 | 请求报文格式错误 |
401 | 管理凭证无效 |
403 | 禁止操作 当归档存储文件未解冻完成调用接口会返回 403 ArchiveUnrestored {"error":"archive unrestored"} |
599 | 服务端操作失败 |
612 | 待复制资源不存在 |
614 | 目标资源已存在 |
示例
命令行示例
curl -i \
-o - \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Authorization: Qiniu u8WqmQu1jH21kxpIQmo2LqntzugM1VoHE9_pozCU:2LJIG...' \
-X POST \
'http://rs.qbox.me/copy/bmV3ZG9jczpmaW5kX21hbi50eHQ=/bmV3ZG9jczpmaW5kLm1hbi50eHQ='
请求示例
POST /copy/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
文档反馈
(如有产品使用问题,请提交工单)