484      搜狐

CopyObject__關於Object操作_API 參考_對象存儲 OSS-阿裏雲

拷貝一個在OSS上已經存在的object成另外一個object，可以發送一個PUT請求給OSS，並在PUT請求頭中添加元素“x-oss-copy-source”來指定拷貝源。OSS會自動判斷出這是一個Copy操作，並直接在服務器端執行該操作。如果拷貝成功，則返回新的object信息給用戶。該操作適用於拷貝小於1GB的文件，當拷貝一個大於1GB的文件時，必須使用Multipart Upload操作，具體見Upload Part Copy。

請求語法

PUT /DestObjectName HTTP/1.1
Host: DestBucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
x-oss-copy-source: /SourceBucketName/SourceObjectName

請求Header

響應元素(Response Elements)

細節分析

1. 可以通過拷貝操作來實現修改已有Object的meta信息。
2. 如果拷貝操作的源Object地址和目標Object地址相同，則無論x-oss-metadata-directive為何值，都會直接替換源Object的meta信息。
3. OSS支持拷貝操作的四個預判斷Header任意個同時出現，相應邏輯參見Get Object操作的細節分析。
4. 拷貝操作需要請求者對源Object有讀權限。
5. 源Object和目標Object必須屬於同一個數據中心，否則返回403 AccessDenied，錯誤信息為：Target object does not reside in the same data center as source object。
6. 拷貝操作的計費統計會對源Object所在的Bucket增加一次Get請求次數，並對目標Object所在的Bucket增加一次Put請求次數，以及相應的新增存儲空間。
7. 拷貝操作涉及到的請求頭，都是以“x-oss-”開頭的，所以要加入簽名字符串中。
8. 若在拷貝操作中指定了x-oss-server-side-encryption請求頭，並且請求值合法（為AES256），則無論源Object是否進行過服務器端加密編碼，拷貝之後的目標Object都會進行服務器端加密編碼。並且拷貝操作的響應頭中會包含x-oss-server-side-encryption，值被設置成目標Object的加密算法。在這個目標Object被下載時，響應頭中也會包含x-oss-server-side-encryption，值被設置成該Object的加密算法；若拷貝操作中未指定x-oss-server-side-encryption請求頭，則無論源Object是否進行過服務器端加密編碼，拷貝之後的目標Object都是未進行過服務器端加密編碼加密的數據。
9. 拷貝操作中x-oss-metadata-directive請求頭為COPY（默認值）時，並不拷貝源Object的x-oss-server-side-encryption值，即目標Object是否進行服務器端加密編碼隻根據COPY操作是否指定了x-oss-server-side-encryption請求頭來決定。
10. 若在拷貝操作中指定了x-oss-server-side-encryption請求頭，並且請求值非AES256，則返回400和相應的錯誤提示：InvalidEncryptionAlgorithmError。
11. 如果拷貝的文件大小大於1GB，會返回400和錯誤提示：EntityTooLarge。
12. 該操作不能拷貝通過Append追加上傳方式產生的object。
13. 如果文件類型為符號鏈接，隻拷貝符號鏈接。

    示例

請求示例：

PUT /copy_oss.jpg HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 24 Feb 2012 07:18:48 GMT
x-oss-copy-source: /oss-example/oss.jpg
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:gmnwPKuu20LQEjd+iPkL259A+n0=

返回示例：

HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A64485981
Content-Type: application/xml
Content-Length: 193
Connection: keep-alive
Date: Fri, 24 Feb 2012 07:18:48 GMT
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<CopyObjectResult xmlns=”https://doc.oss-cn-hangzhou.aliyuncs.com”>
    <LastModified>Fri, 24 Feb 2012 07:18:48 GMT</LastModified>
    <ETag>"5B3C1A2E053D763E1B002CC607C5A0FE"</ETag>
</CopyObjectResult>