帮助与文档

我们为你提供丰富、详尽的使用指南以及产品文档

PUT Object - Copy

用于从源存储空间复制一个对象到目标存储空间,此操作要求请求者对源存储空间拥有可读权限,对目标存储空间拥有可写权限。源存储空间与目标存储空间可相同。因此该接口可用于重命名对象,即先调用此接口复制对象,然后删除源对象。

目前实体对象的大小最大支持 5G,如果上传的对象大小超过此限制,建议使用 Multipart

当目标对象已存在时,该操作会对目标对象的内容进行覆盖。

目前只支持在同一区域内复制。

Request Syntax

PUT /<object-name> HTTP/1.1
x-qs-copy-source: /source-bucket/source-object
Host: <bucket-name>.<zone-id>.qingstor.com
Date: <date>
Authorization: <authorization-string>

Request Parameters

没有请求参数

Request Headers

参见公共请求头

如果源对象是加密的,参见源对象加密请求头

目标对象加密,参见数据加密请求头

Header Name Type Description Required
x-qs-copy-source String 指定源对象,格式为:/source-bucket/source-object, 需进行URL编码。格式错误将返回 400 INVALID ARGUMENT Yes
x-qs-copy-source-if-modified-since Date 如果源对象自从指定时间往后被修改过,则正常复制对象, 否则返回 412 PRECONDITION FAILED No
x-qs-copy-source-If-Unmodified-Since Date 如果源对象自从指定时间往后没有被修改过,则正常复制对象, 否则返回 412 PRECONDITION FAILED No
x-qs-copy-source-If-Match String 如果源对象内容的 ETag 值符合给定的值,则正常复制对象,否则返回 412 PRECONDITION FAILED No
x-qs-copy-source-If-None-Match String 如果源对象内容的 ETag 值不同于给定的值,则正常复制对象,否则返回 412 PRECONDITION FAILED No

Request Elements

没有响应消息体

Response Headers

参见公共响应头

若目标对象被加密,服务端将返回加密响应头, 具体请参见数据加密请求头

Example

Example Request

PUT /myphoto.jpg HTTP/1.1
Host: mybucket.pek3a.qingstor.com
Date: Sun, 16 Aug 2015 09:05:00 GMT
x-qs-copy-source: /source-bucket/source-object
Authorization: authorization string

Example Response

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