Copy Object
该 API 接口用于从源 Bucket 复制一个 Object 到目标 Bucket。
使用须知
-
此操作要求请求者对源 Bucket 拥有可读权限,对目标 Bucket 拥有可写权限。
-
源 Bucket 与目标 Bucket 可相同。因此该接口可用于重命名 Object。即先调用此接口复制该 Object,然后再删除源 Object。
-
目前实体 Object 单次复制的大小最大支持 5G。若源 Object 大小超过该限制,可使用分段上传。
-
当目标 Object 已存在时,该操作会对目标 Object 的内容进行覆盖。
-
目前仅支持在同一区域内复制 Object。
请求语法
PUT /<object-name> HTTP/1.1
x-qs-copy-source: /source-bucket/source-object
Host: <bucket-name>.<zone-id>.qsstor.com
Date: <date>
Authorization: <authorization-string>
请求参数
无。
请求消息头
该 API 接口支持如下消息头:
字段 | 类型 | 说明 | 是否必须 |
---|---|---|---|
x-qs-copy-source |
String |
指定源 Object Key,格式为: |
是 |
x-qs-copy-source-if-modified-since |
Date |
若指定的时间早于源 Object 被修改的时间,则正常复制该 Object |
否 |
x-qs-copy-source-If-Unmodified-Since |
Date |
若指定的时间晚于源 Object 被修改的时间,则正常复制该 Object |
否 |
x-qs-copy-source-If-Match |
String |
若源 Object 的 |
否 |
x-qs-copy-source-If-None-Match |
String |
若源 Object 的 |
否 |
x-qs-storage-class |
String |
指定 Object 的存储级别。默认值为
|
否 |
若源 Object 是加密对象,可参考加密对象-copy 相关内容,添加相应请求头。
如需为目标 Object 加密,可参考加密对象相关内容,添加相应请求头。
若用户需复制源 Object 附带的元数据给目标对象,或修改添加相应的元数据信息,可参考对象元数据 相关内容,添加相应请求头。
除以上请求头以外,此接口还需要包含 Host、Date 等公共请求头。详细内容可参见公共请求头。
请求消息体
无。
错误码
复制成功返回 201,假如源 Object 不存在或目标 Bucket 不存在返回 404;其他失败的返回码参考错误码列表。
示例
请求示例
PUT /myphoto.jpg HTTP/1.1
Host: mybucket.pek3a.qsstor.com
Date: Sun, 16 Aug 2015 09:05:00 GMT
x-qs-copy-source: /source-bucket/source-object
Authorization: authorization string
响应示例
HTTP/1.1 201 CREATED
Server: QingStor
Date: Sun, 16 Aug 2015 09:05:00 GMT
ETag: "0c2f573d81194064b129e940edcefe9b"
Content-Length: 0
Connection: close
Request-ID: aa08cf7a43f611e5886952542e6ce14b