vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/obs/s3api/en-us_topic_0125560361.html
Jawei, Li 1a4c1a720a OBS s3api 2.0.38.SP5 
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: Jawei, Li <lijiawei5@huawei.com>
Co-committed-by: Jawei, Li <lijiawei5@huawei.com>
2022-11-16 14:51:13 +00:00

270 lines
29 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<a name="EN-US_TOPIC_0125560361"></a><a name="EN-US_TOPIC_0125560361"></a>
<h1 class="topictitle1">Upload Part - Copy</h1>
<div id="body48659578"><p id="EN-US_TOPIC_0125560361__p39098515">After initiating a multipart upload, you can send an <strong id="EN-US_TOPIC_0125560361__b35283025">Upload Part</strong> request to upload parts for the multipart upload using its <strong id="EN-US_TOPIC_0125560361__b49111773">uploadId</strong>. The <strong id="EN-US_TOPIC_0125560361__b39352775">Upload Part – Copy</strong> operation allows you to upload a part by copying data from an existing object as data source.</p>
<p id="EN-US_TOPIC_0125560361__p2314758717741">This operation makes server-side encryption available.</p>
<div class="notice" id="EN-US_TOPIC_0125560361__note9327152813295"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="EN-US_TOPIC_0125560361__p10492174092913">You cannot determine whether a request is executed successfully only using <strong id="EN-US_TOPIC_0125560361__b16338446141618">status_code</strong> in the header returned by HTTP.</p>
<p id="EN-US_TOPIC_0125560361__p1949244062917">If <strong id="EN-US_TOPIC_0125560361__b1768146112917">200</strong> in <strong id="EN-US_TOPIC_0125560361__b17593165151614">status_code</strong> is returned, the server has received the request and starts to process the request from the upload part. The body in the response shows whether the upload operation succeeds. The upload operation succeeds only when the body has ETags. Otherwise, the upload operation fails.</p>
<p id="EN-US_TOPIC_0125560361__p849294082914">Copy the source object as <strong id="EN-US_TOPIC_0125560361__b7240156102916">part1</strong>. If part1 already exists before you copy the source object, the old <strong id="EN-US_TOPIC_0125560361__b16347691719">part1</strong> will be overwritten by the new <strong id="EN-US_TOPIC_0125560361__b1476711313308">part1</strong>.</p>
<p id="EN-US_TOPIC_0125560361__p949219402298">After the source object is copied, only the latest <strong id="EN-US_TOPIC_0125560361__b1594591918174">part1</strong> is listed. The old <strong id="EN-US_TOPIC_0125560361__b97442612174">part1</strong> will be deleted. Before using the copy interface, ensure that the target part does not exist or is useless to avoid incorrect data deletion.</p>
<p id="EN-US_TOPIC_0125560361__p15492184010296">During the copy process, the source object is not changed.</p>
</div></div>
<div class="section" id="EN-US_TOPIC_0125560361__section3886489515555"><h4 class="sectiontitle">OBS Cold Objects</h4><p id="EN-US_TOPIC_0125560361__p2993514715595">If source objects are OBS cold objects, check the restore status of the objects. You can copy the OBS cold objects only after the objects are restored. If the objects are not restored or are being restored, the copy fails, and error "403 Forbidden" is returned. The fault is described as follows:</p>
<p id="EN-US_TOPIC_0125560361__p98086915595">ErrorCode: InvalidObjectState</p>
<p id="EN-US_TOPIC_0125560361__p882782315595">ErrorMessage: Operation is not valid for the source object's storage class</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560361__section11408737"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560361__screen47686534114312">PUT /ObjectName?partNumber=partNum&amp;uploadId=UploadID HTTP/1.1
User-Agent: agent
Host: bucketname.obs.example.com
Accept: */*
Date: date
x-amz-copy-source: sourceobject
x-amz-copy-source-range:bytes=start-end
Authorization: auth
Content-Length: length</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560361__section35569777"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0125560361__p46864519">This request uses parameters to specify the ID of a multipart upload and part number. <a href="#EN-US_TOPIC_0125560361__table12334196">Table 1</a> describes the parameters.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560361__table12334196"></a><a name="table12334196"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560361__table12334196" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0125560361__row56919892"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.6.3.2.4.1.1"><p id="EN-US_TOPIC_0125560361__p47108560">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.6.3.2.4.1.2"><p id="EN-US_TOPIC_0125560361__p57697049">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.6.3.2.4.1.3"><p id="EN-US_TOPIC_0125560361__p42949398">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560361__row56349232"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560361__p885070">partNumber</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560361__p4581849">Indicates the number that identifies a part to be uploaded.</p>
<p id="EN-US_TOPIC_0125560361__p41236642">Type: Integer</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560361__p51833723">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560361__row63850324"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560361__p4493716">uploadId</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560361__p28446688">Indicates the ID of a multipart upload.</p>
<p id="EN-US_TOPIC_0125560361__p54693607">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560361__p997169">Mandatory</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560361__section51692544"><h4 class="sectiontitle">Request Headers</h4><p id="EN-US_TOPIC_0125560361__p55848097">This request uses headers listed in <a href="#EN-US_TOPIC_0125560361__table6620500">Table 2</a> in addition to common headers.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560361__table6620500"></a><a name="table6620500"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560361__table6620500" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request headers</caption><thead align="left"><tr id="EN-US_TOPIC_0125560361__row64282674"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.7.3.2.4.1.1"><p id="EN-US_TOPIC_0125560361__p39514120">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.7.3.2.4.1.2"><p id="EN-US_TOPIC_0125560361__p46527158">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.7.3.2.4.1.3"><p id="EN-US_TOPIC_0125560361__p10603493">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560361__row53576637"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560361__p44740325">x-amz-copy-source</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560361__p87685">Indicates the source object to be copied.</p>
<p id="EN-US_TOPIC_0125560361__p789170">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560361__p63922810">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560361__row38434383"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560361__p26177353">x-amz-copy-source-range</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560361__p39990876">Indicates the range of bytes (start-end) to be copied from the source object. <strong id="EN-US_TOPIC_0125560361__b24373566">start</strong> indicates the start byte of the part to be copied and <strong id="EN-US_TOPIC_0125560361__b18035503">end</strong> indicates the end byte.</p>
<p id="EN-US_TOPIC_0125560361__p28101800">Type: Integer</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560361__p61653310">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560361__row3775240104116"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560361__p15457196171120">x-amz-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560361__p44073379171120">Indicates an algorithm used to encrypt a destination part. The header is used in SSE-C mode.</p>
<p id="EN-US_TOPIC_0125560361__p61116098171120">Type: string</p>
<p id="EN-US_TOPIC_0125560361__p13173975171120">Example: x-amz-server-side-encryption-customer-algorithm:AES256</p>
<p id="EN-US_TOPIC_0125560361__p51456915171120">Constraints: This header must be used together with <strong id="EN-US_TOPIC_0125560361__b60459055171120">x-amz-server-side-encryption-customer-key</strong> and <strong id="EN-US_TOPIC_0125560361__b7260588171120">x-amz-server-side-encryption-customer-key-MD5</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560361__p51236790171120">No. This header is mandatory when SSE-C is used. The encryption algorithm must be the same as the algorithm used to initiate multipart upload tasks.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560361__row56120066104125"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560361__p39092131171120">x-amz-server-side-encryption-customer-key</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560361__p12346013171120">Indicates a key used to encrypt a destination part. The header is used in SSE-C mode.</p>
<p id="EN-US_TOPIC_0125560361__p44005255171120">Type: string</p>
<p id="EN-US_TOPIC_0125560361__p60502979171120">Example: x-amz-server-side-encryption-customer-key:K7QkYpBkM5+hcs27fsNkUnNVaobncnLht/rCB2o/9Cw=</p>
<p id="EN-US_TOPIC_0125560361__p7655907171120">Constraints: This header is a base64-encoded 256-bit or 512-bit key and must be used together with <strong id="EN-US_TOPIC_0125560361__b1794303171120">x-amz-server-side-encryption-customer-algorithm</strong> and <strong id="EN-US_TOPIC_0125560361__b16148727171120">x-amz-server-side-encryption-customer-key-MD5</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560361__p32978540171120">No. This header is mandatory when SSE-C is used. The key must be the same as that used to initiate multipart upload tasks.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560361__row30895979104122"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560361__p16382907171120">x-amz-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560361__p51947096171120">Indicates the MD5 value of a key used to encrypt a destination part. The header is used in SSE-C mode. The MD5 value is used to check whether any error occurs during the transmission of the key.</p>
<p id="EN-US_TOPIC_0125560361__p64870686171120">Type: string</p>
<p id="EN-US_TOPIC_0125560361__p46965266171120">Example: x-amz-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</p>
<p id="EN-US_TOPIC_0125560361__p20034213171120">Constraints: This header is a base64-encoded 128-bit MD5 value and must be used together with <strong id="EN-US_TOPIC_0125560361__b46090192171120">x-amz-server-side-encryption-customer-algorithm</strong> and <strong id="EN-US_TOPIC_0125560361__b12158548171120">x-amz-server-side-encryption-customer-key</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560361__p45318356171120">No. This header is mandatory when SSE-C is used. The MD5 value must be the same as that used to initiate multipart upload tasks.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560361__row62470581171042"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560361__p19520950171120">x-amz-copy-source-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560361__p37693078171120">Indicates an algorithm used by a source object. The header is used in SSE-C mode.</p>
<p id="EN-US_TOPIC_0125560361__p3693383171120">Type: string</p>
<p id="EN-US_TOPIC_0125560361__p33240450171120">Example: x-amz-copy-source-server-side-encryption-customer-algorithm:AES256</p>
<p id="EN-US_TOPIC_0125560361__p30728601171120">Constraints: This header must be used together with <strong id="EN-US_TOPIC_0125560361__b368315326171">x-amz-copy-source-server-side-encryption-customer-key</strong> and <strong id="EN-US_TOPIC_0125560361__b5988739171120">x-amz-copy-source-server-side-encryption-customer-key-MD5</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560361__p15325870171120">No. This header is mandatory when SSE-C is used to copy a source object.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560361__row58030305171045"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p style="color:#FF0001;" id="EN-US_TOPIC_0125560361__p28508285171211"><span style="color:#000000;">x-amz-copy-source-server-side-encryption-customer-key</span></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p style="color:#FF0001;" id="EN-US_TOPIC_0125560361__p27469759171211"><span style="color:#000000;">Indicates the customer-provided key used to decrypt the source object when customer-provided keys are used.</span></p>
<p style="color:#FF0001;" id="EN-US_TOPIC_0125560361__p45901246171211"><span style="color:#000000;">Type: string</span></p>
<p id="EN-US_TOPIC_0125560361__p10458030171211">Example: x-amz-copy-source-server-side-encryption-customer-key:K7QkYpBkM5+hcs27fsNkUnNVaobncnLht/rCB2o/9Cw=</p>
<p style="color:#FF0001;" id="EN-US_TOPIC_0125560361__p29878705171211"><span style="color:#000000;">Constraints: This header is a base64-encoded 256-bit or 512-bit key and must be used together with </span><strong style="color:#000000;" id="EN-US_TOPIC_0125560361__b61144017170">x-amz-copy-source-server-side-encryption-customer-algorithm</strong><span style="color:#000000;"> and </span><strong id="EN-US_TOPIC_0125560361__b4256021171211"><span style="color:#000000;">x-amz-copy-source-server-side-encryption-customer-key-MD5</span></strong><span style="color:#000000;">.</span></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560361__p10665747183114">No.</p>
<p style="color:#FF0001;" id="EN-US_TOPIC_0125560361__p15631862171211"><span style="color:#000000;">This header is mandatory when customer-provided keys are used to copy source objects.</span></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560361__row65640039171048"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p style="color:#FF0001;" id="EN-US_TOPIC_0125560361__p54229804171211"><span style="color:#000000;">x-amz-copy-source-server-side-encryption-customer-key-MD5</span></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p style="color:#FF0001;" id="EN-US_TOPIC_0125560361__p30538035171211"><span style="color:#000000;">Indicates the MD5 value of the customer-provided key used to decrypt the source object when customer-provided keys are used.</span></p>
<p style="color:#FF0001;" id="EN-US_TOPIC_0125560361__p6406859171211"><span style="color:#000000;">Type: string</span></p>
<p style="color:#FF0001;" id="EN-US_TOPIC_0125560361__p57661733171211"><span style="color:#000000;">Example: x-amz-copy-source-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</span></p>
<p style="color:#FF0001;" id="EN-US_TOPIC_0125560361__p49193555171211"><span style="color:#000000;">Constraints: This header is a 128-bit base64-encoded string and must be used together with </span><strong style="color:#000000;" id="EN-US_TOPIC_0125560361__b1097174871711">x-amz-copy-source-server-side-encryption-customer-algorithm</strong><span style="color:#000000;"> and </span><strong id="EN-US_TOPIC_0125560361__b25254995171211"><span style="color:#000000;">x-amz-copy-source-server-side-encryption-customer-key</span></strong><span style="color:#000000;">.</span></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560361__p196246112322">No.</p>
<p style="color:#FF0001;" id="EN-US_TOPIC_0125560361__p23063064171211"><span style="color:#000000;">This header is mandatory when customer-provided keys are used to copy source objects.</span></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560361__row78811024164014"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560361__p12787226114018">x-amz-security-token</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560361__p77873262402">Header field used to identify the request of a federated user. When the federal authentication function is enabled, users sending such requests are identified as federated users.</p>
<p id="EN-US_TOPIC_0125560361__p1078718261401">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560361__p278712265406">Optional. This parameter must be carried in the request sent by federated users.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560361__section62579720"><h4 class="sectiontitle">Request Elements</h4><p id="EN-US_TOPIC_0125560361__p49433658">This request involves no elements.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560361__section41575528"><h4 class="sectiontitle">Response Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560361__screen32764463114335">HTTP/1.1 status_code
x-amz-id-2: id
x-amz-request-id: request id
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
Content-Type: type
Date: date
Server: server
Transfer-Encoding: chunked
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;CopyPartResult xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;LastModified&gt;modifiedDate&lt;/LastModified&gt;
&lt;ETag&gt;etagValue&lt;/ETag&gt;
&lt;/CopyPartResult&gt; </pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560361__section38635439"><h4 class="sectiontitle">Response Headers</h4><p id="EN-US_TOPIC_0125560361__p38409975">This response uses common headers. For details about common response headers, see section <a href="en-us_topic_0125560484.html">Common Response Headers</a>.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560361__table37553038104158" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Response Headers</caption><thead align="left"><tr id="EN-US_TOPIC_0125560361__row55004863104158"><th align="left" class="cellrowborder" valign="top" width="39.629999999999995%" id="mcps1.3.10.3.2.3.1.1"><p id="EN-US_TOPIC_0125560361__p7661080104233">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60.370000000000005%" id="mcps1.3.10.3.2.3.1.2"><p id="EN-US_TOPIC_0125560361__p16567776104233">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560361__row23588107104158"><td class="cellrowborder" valign="top" width="39.629999999999995%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560361__p99682917136">x-amz-server-side-encryption</p>
</td>
<td class="cellrowborder" valign="top" width="60.370000000000005%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560361__p1363432817136">This header is included in a response if SSE-KMS is used.</p>
<p id="EN-US_TOPIC_0125560361__p5560008917136">Type: string</p>
<p id="EN-US_TOPIC_0125560361__p93561753183319">Example: x-amz-server-side-encryption:aws:kms</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560361__row9705093104158"><td class="cellrowborder" valign="top" width="39.629999999999995%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560361__p5551271517136">x-amz-server-side-encryption-aws-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="60.370000000000005%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560361__p23602817136">Indicates the master key ID. This header is included in a response if SSE-KMS is used.</p>
<p id="EN-US_TOPIC_0125560361__p74823673418">Example: x-amz-server-side-encryption-aws-kms-key-id:arn:aws:kms:sichuan:domainiddomainiddomainiddoma0001:key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560361__row33446976104158"><td class="cellrowborder" valign="top" width="39.629999999999995%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560361__p507861617136">x-amz-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="60.370000000000005%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560361__p871477117136">Indicates an encryption algorithm. This header is included in a response if SSE-C is used.</p>
<p id="EN-US_TOPIC_0125560361__p1132408017136">Type: string</p>
<p id="EN-US_TOPIC_0125560361__p75301113103410">Example: x-amz-server-side-encryption-customer-algorithm:AES256</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560361__row63746658104158"><td class="cellrowborder" valign="top" width="39.629999999999995%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560361__p778157017136">x-amz-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="60.370000000000005%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560361__p2632744217136">Indicates the MD5 value of a key used to encrypt objects. This header is included in a response if SSE-C is used.</p>
<p id="EN-US_TOPIC_0125560361__p3562038817136">Type: string</p>
<p id="EN-US_TOPIC_0125560361__p642020167342">Example: x-amz-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560361__section12174636"><h4 class="sectiontitle">Response Elements</h4><p id="EN-US_TOPIC_0125560361__p14062795">This response contains elements to indicate the copy results. <a href="#EN-US_TOPIC_0125560361__table44628158">Table 4</a> describes the elements.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560361__table44628158"></a><a name="table44628158"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560361__table44628158" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response elements</caption><thead align="left"><tr id="EN-US_TOPIC_0125560361__row48346426"><th align="left" class="cellrowborder" valign="top" width="39.72%" id="mcps1.3.11.3.2.3.1.1"><p id="EN-US_TOPIC_0125560361__p23746403">Element</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60.28%" id="mcps1.3.11.3.2.3.1.2"><p id="EN-US_TOPIC_0125560361__p44410452">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560361__row40476854"><td class="cellrowborder" valign="top" width="39.72%" headers="mcps1.3.11.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560361__p57399728">LastModified</p>
</td>
<td class="cellrowborder" valign="top" width="60.28%" headers="mcps1.3.11.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560361__p18866411">Indicates the date the part was last modified.</p>
<p id="EN-US_TOPIC_0125560361__p35579976">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560361__row51784335"><td class="cellrowborder" valign="top" width="39.72%" headers="mcps1.3.11.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560361__p33781570">ETag</p>
</td>
<td class="cellrowborder" valign="top" width="60.28%" headers="mcps1.3.11.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560361__p51952687">Indicates the ETag of the source part.</p>
<p id="EN-US_TOPIC_0125560361__p64921002">Type: String</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560361__section42462864"><h4 class="sectiontitle">Error Responses</h4><ul id="EN-US_TOPIC_0125560361__ul1599023493414"><li id="EN-US_TOPIC_0125560361__li1498813341342">If an AccessKey or signature is invalid, OBS returns status code <strong id="EN-US_TOPIC_0125560361__b69881534183410">403 Forbidden</strong> and error code <strong id="EN-US_TOPIC_0125560361__b9988133413343">AccessDenied</strong>.</li><li id="EN-US_TOPIC_0125560361__li598812343347">If the requested bucket does not exist, OBS returns status code <strong id="EN-US_TOPIC_0125560361__b119881134153411">404 Not Found</strong> and error code <strong id="EN-US_TOPIC_0125560361__b99881134203410">NoSuchBucket</strong>.</li><li id="EN-US_TOPIC_0125560361__li139881834163410">If the requested source object does not exist, OBS returns status code <strong id="EN-US_TOPIC_0125560361__b1698817342347">404 Not Found</strong> and error code <strong id="EN-US_TOPIC_0125560361__b189881434173412">NoSuchKey</strong>.</li><li id="EN-US_TOPIC_0125560361__li098983443412">If the requester does not have <strong id="EN-US_TOPIC_0125560361__b1498933483416">READ</strong> permission for the requested bucket, OBS returns status code <strong id="EN-US_TOPIC_0125560361__b189893342345">403 Forbidden</strong> and error code <strong id="EN-US_TOPIC_0125560361__b199891234163414">AccessDenied</strong>.</li><li id="EN-US_TOPIC_0125560361__li79891634113410">If the requester does not have <strong id="EN-US_TOPIC_0125560361__b17989634183419">WRITE</strong> permission for the requested bucket, OBS returns status code <strong id="EN-US_TOPIC_0125560361__b798919349344">403 Forbidden</strong> and error code <strong id="EN-US_TOPIC_0125560361__b998973473414">AccessDenied</strong>.</li><li id="EN-US_TOPIC_0125560361__li10989434143412">If the requested multipart upload does not exist, OBS returns status code <strong id="EN-US_TOPIC_0125560361__b198963433418">404 Not Found</strong> and error code <strong id="EN-US_TOPIC_0125560361__b1989123433417">NoSuchUpload</strong>.</li><li id="EN-US_TOPIC_0125560361__li19901334173411">If the requester is not the initiator of the multipart upload, OBS returns status code <strong id="EN-US_TOPIC_0125560361__b4989133411347">403 Forbidden</strong> and error code <strong id="EN-US_TOPIC_0125560361__b119891834133410">AccessDenied</strong>.</li><li id="EN-US_TOPIC_0125560361__li89901234103418">If the part size is greater than 5 GB, OBS returns status code <strong id="EN-US_TOPIC_0125560361__b16990183473420">400 Bad Request</strong>.</li><li id="EN-US_TOPIC_0125560361__li69901634133419">If the part number exceeds the range of 1 to 10,000, OBS returns status code <strong id="EN-US_TOPIC_0125560361__b59901834123414">400 Bad Request</strong>.</li></ul>
<p id="EN-US_TOPIC_0125560361__p34585209">For details about other error responses, see <a href="en-us_topic_0125560440.html#EN-US_TOPIC_0125560440__table30733758">Table 1</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560361__section6063624"><h4 class="sectiontitle">Sample Request</h4><pre class="screen" id="EN-US_TOPIC_0125560361__screen47235892114351">PUT /newobject?partNumber=1&amp;uploadId=VCVsb2FkIElEIGZvciBlbZZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZR HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/3.1
Host: bucketname.obs.example.com
Accept: */*
Date: Mon, 11 Apr 2011 20:34:56 GMT
x-amz-copy-source: /source-bucket/sourceobject
x-amz-copy-source-range:bytes=500-6291456
Authorization: AWS AKIAIOSFODNN7EXAMPLE:VGhpcyBtZXNzYWdlIHNpZ25lZGGieSRlbHZpbmc=
Content-Length: 5120</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560361__section54572624"><h4 class="sectiontitle">Sample Response</h4><pre class="screen" id="EN-US_TOPIC_0125560361__screen2602372811445">HTTP/1.1 200 OK
Server: OBS
x-amz-id-2: Vvag1LuByRx9e6j5Onimru9pO4ZVKnJ2Qz7/C1NPcfTWAtRPfTaOFg==
x-amz-request-id: 656c76696e6727732072657175657374
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
Content-Type: application/xml
Date: Mon, 11 Apr 2011 20:34:56 GMT
Transfer-Encoding: chunked
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;CopyPartResult xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;LastModified&gt;2009-10-28T22:32:00&lt;/LastModified&gt; &lt;ETag&gt;"9b2cf535f27731c974343645a3985328"&lt;/ETag&gt;
&lt;/CopyPartResult&gt; </pre>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0125560489.html">Operations on Objects</a></div>
</div>
</div>
View Git Blame Copy Permalink