Upload Part - Copy

  • 描述:通过拷贝方式创建上传一个分片(不上传具体的文件内容。而是通过COPY方式对系统内另一文件进行复制)。

  • 请求格式:

PUT /<ObjectName>?partNumber=PartNumber&uploadId=UploadId HTTP/1.1
Host: <Your-Bucket-Name>.ss.bscstorage.com
Date: <date>
x-amz-copy-source: </source-bucket/source-object>
Authorization: <authorization string> #请参照《签名算法》
  • 响应:
HTTP/1.1 200 OK
Date: Tue, 08 Apr 2014 02:59:47 GMT
Connection: keep-alive
ETag: "<文件的MD5值>"
x-amz-request-id: 0000106c-1608-0810-4621-00163e000064
x-amz-s2-requester: <Your UserName>

<?xml version="1.0" encoding="UTF-8"?>
<CopyObjectResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <LastModified>Mon, 08 Aug 2016 05:04:10 GMT</LastModified>
    <ETag>870c06c00566c4fb1861bb10f34d1904</ETag>
</CopyObjectResult>
  • Request Parameters(请求参数):
Parameter Description Required
partNumber 文件分片的序号,从1开始 Yes
uploadId 通过Initiate Multipart Upload(大文件分片上传初始化接口)获得的uploadId值 Yes
  • Request Headers(请求头):
Name Description Required
x-amz-copy-source 被copy的文件地址。格式:/source-bucket/source-object,需要整体进行urlencode编码. Yes
Content-Length 必须是0 =0
x-amz-copy-source-if-match 如果指定的ETag与源文件的ETag匹配, 则可copy源文件, 否则返回412(PreconditionFailed) No
x-amz-copy-source-if-nonematch 如果指定的ETag与源文件的ETag不匹配, 则可copy源文件, 否则返回412(PreconditionFailed) No
x-amz-copy-source-if-unmodified-since 如果指定的时间开始源文件没有修改, 则可copy源文件, 否则返回412(PreconditionFailed) No
x-amz-copy-source-if-modified-since 如果指定的时间开始源文件有修改, 则可copy源文件, 否则返回412(PreconditionFailed) No
  • Response Body(响应XML Body):

    Name Description
    CopyObjectResult 包含ETag和LastModified元素
    ETag 文件的ETag
    CopyObjectResult 文件的最后修改时间
  • 请求示例:

curl -v -X PUT -H "x-amz-copy-source: /bucket-123/path/to/file123.txt" -H "Date:
Sat, 20 Nov 2286 17:46:39 GMT" -H "Authorization: AWS <access_key>:<ssig>" "http://<Your-Bucket-Name>.ss.bscstorage.com/path/to/myfile.txt?partNumber=<PartNumber>&uploadId=<UploadId>"

results matching ""

    No results matching ""