vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/obs/s3api/en-us_topic_0125560338.html
zhangyue 6fcdbfd13e OBS S3 API DOC 
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>
2024-02-26 11:17:13 +00:00

281 lines
25 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0125560338"></a><a name="EN-US_TOPIC_0125560338"></a>
<h1 class="topictitle1">Complete Multipart Upload</h1>
<div id="body54296197"><p id="EN-US_TOPIC_0125560338__p11215161319376">After uploading all parts for a multipart upload, you can use this operation to complete the multipart upload.</p>
<p id="EN-US_TOPIC_0125560338__p57260105">Upon receiving a Complete Multipart Upload request, OBS concatenates the specified parts to create a new object. All associated parts cannot be downloaded until the multipart upload is complete.</p>
<p id="EN-US_TOPIC_0125560338__p45578897">When starting to complete a multipart upload, OBS first copies the header information from the metadata of associated parts and then incorporates the header information into the metadata of the newly created object.</p>
<p id="EN-US_TOPIC_0125560338__p7556889">Before a multipart upload is completed, all associated parts occupy storage quota. After the multipart upload is completed, only parts included in the part list specified in the <strong id="EN-US_TOPIC_0125560338__b35915832">Complete Multipart Upload</strong> request are concatenated. These parts still occupy storage quota while other parts are deleted to release storage quota.</p>
<p id="EN-US_TOPIC_0125560338__p903138">After a multipart upload is completed, you can send a <strong id="EN-US_TOPIC_0125560338__b169371259111717">GET</strong> request to obtain the newly created object or some parts comprising this object by specifying a range in the request. You can also send a <strong id="EN-US_TOPIC_0125560338__b1910198121817">DELETE</strong> request to delete all parts uploaded for the multipart upload. The deleted parts cannot be restored.</p>
<p id="EN-US_TOPIC_0125560338__p8128245">The MD5 value recorded in the ETag of a newly created object is calculated using the MD5 values of the parts comprising this object. The object ETag is calculated as follows:</p>
<p id="EN-US_TOPIC_0125560338__p6045348"><em id="EN-US_TOPIC_0125560338__i10185002">MD5(M<sub id="EN-US_TOPIC_0125560338__sub24556156">1</sub>M<sub id="EN-US_TOPIC_0125560338__sub19678815">2</sub>......M<sub id="EN-US_TOPIC_0125560338__sub42891613">N</sub>)-N</em></p>
<p id="EN-US_TOPIC_0125560338__p54408134">where</p>
<p id="EN-US_TOPIC_0125560338__p19911166"><strong id="EN-US_TOPIC_0125560338__b50480197"><em id="EN-US_TOPIC_0125560338__i51668594">M<sub id="EN-US_TOPIC_0125560338__sub62364163">n</sub></em></strong> is the MD5 value of part N</p>
<p id="EN-US_TOPIC_0125560338__p44982772"><strong id="EN-US_TOPIC_0125560338__b24406563"><em id="EN-US_TOPIC_0125560338__i18332482">N</em></strong> is the total number of parts</p>
<div class="section" id="EN-US_TOPIC_0125560338__section2191769"><h4 class="sectiontitle">Versioning</h4><p id="EN-US_TOPIC_0125560338__p8536106">If a bucket has versioning enabled, a unique version ID is generated for an object created from a multipart upload in this bucket and the version ID is returned in response header <strong id="EN-US_TOPIC_0125560338__b116641821181816">x-amz-version-id</strong>. If the bucket has versioning suspended, the version ID of the object is <strong id="EN-US_TOPIC_0125560338__b20335970">null</strong>. For details about bucket versioning, see section <a href="en-us_topic_0125560444.html">PUT Bucket versioning</a>.</p>
<div class="notice" id="EN-US_TOPIC_0125560338__note6240173483817"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="EN-US_TOPIC_0125560338__p4241134113814">If 10 parts are uploaded but only 9 parts are selected for combination, the part that is not combined will be automatically deleted. After the part is deleted, it cannot be restored. Before combining the parts, adopt the interface used to list the parts that have been uploaded to check all parts to ensure that no part is missed.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0125560338__section867910481251"><h4 class="sectiontitle">WORM</h4><p id="EN-US_TOPIC_0125560338__p1566012417013">If a bucket has WORM enabled, the WORM protection will be automatically applied to the object generated after a multipart upload is complete. If you specify WORM headers and a retention expiration date when you initiate a multipart upload, the protection for the assembled object ends on the specified date. If you do not specify WORM headers during the initiation, but have configured the default bucket-level retention policy, this default policy is automatically applied and the protection starts when the multipart upload is complete. After a multipart upload is complete, you can still configure object-level WORM retention policies for the assembled object, see section <a href="en-us_topic_0000001806154009.html">Configuring WORM Retention for an Object</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560338__section4329874"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560338__screen3730276614517">POST /ObjectName?uploadId=uploadID HTTP/1.1
User-Agent: agent
Host: bucketname.obs.example.com
Accept: */*
Date: date
Content-Length: length
Authorization: auth
Expect: expect
&lt;CompleteMultipartUpload&gt;
&lt;Part&gt;
&lt;PartNumber&gt;partNum1&lt;/PartNumber&gt;
&lt;ETag&gt;etag1&lt;/ETag&gt;
&lt;/Part&gt;
&lt;Part&gt;
&lt;PartNumber&gt;partNum2&lt;/PartNumber&gt;
&lt;ETag&gt;etag2&lt;/ETag&gt;
&lt;/Part&gt;
&lt;Part&gt;
&lt;PartNumber&gt;partNum3&lt;/PartNumber&gt;
&lt;ETag&gt;etag3&lt;/ETag&gt;
&lt;/Part&gt;
&lt;/CompleteMultipartUpload&gt;</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560338__section38968871"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0125560338__p37868737">This request uses one parameter to specify the ID of the multipart upload to be completed. <a href="#EN-US_TOPIC_0125560338__table6473820">Table 1</a> describes the parameter.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560338__table6473820"></a><a name="table6473820"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560338__table6473820" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameter</caption><thead align="left"><tr id="EN-US_TOPIC_0125560338__row27116914"><th align="left" class="cellrowborder" valign="top" width="21.04210421042104%" id="mcps1.3.14.3.2.4.1.1"><p id="EN-US_TOPIC_0125560338__p48986392">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="52.705270527052704%" id="mcps1.3.14.3.2.4.1.2"><p id="EN-US_TOPIC_0125560338__p8474815">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="26.25262526252625%" id="mcps1.3.14.3.2.4.1.3"><p id="EN-US_TOPIC_0125560338__p15371406">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560338__row37124398"><td class="cellrowborder" valign="top" width="21.04210421042104%" headers="mcps1.3.14.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560338__p54286279">uploadId</p>
</td>
<td class="cellrowborder" valign="top" width="52.705270527052704%" headers="mcps1.3.14.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560338__p35112448">Indicates the ID of the multipart upload to be completed.</p>
<p id="EN-US_TOPIC_0125560338__p47576576">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="26.25262526252625%" headers="mcps1.3.14.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560338__p28497420">Mandatory</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560338__section15175522"><h4 class="sectiontitle">Request Headers</h4><p id="EN-US_TOPIC_0125560338__p37980797">This request uses common headers. For details about common request headers, see section <a href="en-us_topic_0125560462.html">Common Request Headers</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560338__section2361972"><h4 class="sectiontitle">Request Elements</h4><p id="EN-US_TOPIC_0125560338__p16801916">This request contains elements to specify the part list for the multipart upload to be completed. <a href="#EN-US_TOPIC_0125560338__table57330131">Table 2</a> describes the elements.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560338__table57330131"></a><a name="table57330131"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560338__table57330131" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request elements</caption><thead align="left"><tr id="EN-US_TOPIC_0125560338__row419316"><th align="left" class="cellrowborder" valign="top" width="23.212321232123212%" id="mcps1.3.16.3.2.4.1.1"><p id="EN-US_TOPIC_0125560338__p33964601">Element</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="51.035103510351036%" id="mcps1.3.16.3.2.4.1.2"><p id="EN-US_TOPIC_0125560338__p66778138">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25.752575257525752%" id="mcps1.3.16.3.2.4.1.3"><p id="EN-US_TOPIC_0125560338__p40320129">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560338__row44704979"><td class="cellrowborder" valign="top" width="23.212321232123212%" headers="mcps1.3.16.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560338__p64333562">CompleteMultipartUpload</p>
</td>
<td class="cellrowborder" valign="top" width="51.035103510351036%" headers="mcps1.3.16.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560338__p43636062">Indicates the container for the list of parts to be concatenated.</p>
<p id="EN-US_TOPIC_0125560338__p57180242">Type: XML</p>
</td>
<td class="cellrowborder" valign="top" width="25.752575257525752%" headers="mcps1.3.16.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560338__p1088027">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560338__row9792251"><td class="cellrowborder" valign="top" width="23.212321232123212%" headers="mcps1.3.16.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560338__p54974852">PartNumber</p>
</td>
<td class="cellrowborder" valign="top" width="51.035103510351036%" headers="mcps1.3.16.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560338__p23778026">Indicates the number that identifies a part.</p>
<p id="EN-US_TOPIC_0125560338__p12675643">Type: Integer</p>
</td>
<td class="cellrowborder" valign="top" width="25.752575257525752%" headers="mcps1.3.16.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560338__p20094134">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560338__row46629482"><td class="cellrowborder" valign="top" width="23.212321232123212%" headers="mcps1.3.16.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560338__p18891734">ETag</p>
</td>
<td class="cellrowborder" valign="top" width="51.035103510351036%" headers="mcps1.3.16.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560338__p53835453">Indicates the ETag returned after a part is uploaded.</p>
<p id="EN-US_TOPIC_0125560338__p14757035">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="25.752575257525752%" headers="mcps1.3.16.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560338__p54469209">Mandatory</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560338__section6261685"><h4 class="sectiontitle">Response Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560338__screen32325485145229">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
x-reserved-indicator: indicator
Content-Type: type
Date: date
Connection: state
Server: server
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;CompleteMultipartUploadResult xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;Location&gt;http://example-Bucket.obs.example.com/example-Object&lt;/Location&gt;
&lt;Bucket&gt;BucketName&lt;/Bucket&gt;
&lt;Key&gt;ObjectName&lt;/Key&gt;
&lt;ETag&gt;ETag&lt;/ETag&gt;
&lt;/CompleteMultipartUploadResult&gt;</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560338__section56355167"><h4 class="sectiontitle">Response Headers</h4><p id="EN-US_TOPIC_0125560338__p24648685">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>
<p id="EN-US_TOPIC_0125560338__p50825259">This response also uses one optional header, as described in <a href="#EN-US_TOPIC_0125560338__table49929783">Table 3</a>.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560338__table49929783"></a><a name="table49929783"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560338__table49929783" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Optional response header</caption><thead align="left"><tr id="EN-US_TOPIC_0125560338__row56148564"><th align="left" class="cellrowborder" valign="top" width="42.77%" id="mcps1.3.18.4.2.3.1.1"><p id="EN-US_TOPIC_0125560338__p51739874">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.230000000000004%" id="mcps1.3.18.4.2.3.1.2"><p id="EN-US_TOPIC_0125560338__p30180276">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560338__row28683315"><td class="cellrowborder" valign="top" width="42.77%" headers="mcps1.3.18.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560338__p41647174">x-amz-version-id</p>
</td>
<td class="cellrowborder" valign="top" width="57.230000000000004%" headers="mcps1.3.18.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560338__p17977942">Indicates the version ID of the object created from a multipart upload.</p>
<p id="EN-US_TOPIC_0125560338__p27583752">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560338__row47127628104355"><td class="cellrowborder" valign="top" width="42.77%" headers="mcps1.3.18.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560338__p7599119171420">x-amz-server-side-encryption</p>
</td>
<td class="cellrowborder" valign="top" width="57.230000000000004%" headers="mcps1.3.18.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560338__p11548897171420">This header is included in a response if SSE-KMS is used.</p>
<p id="EN-US_TOPIC_0125560338__p36831211171420">Type: string</p>
<p id="EN-US_TOPIC_0125560338__p63045451171420">Example: x-amz-server-side-encryption:aws:kms</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560338__row2030036510440"><td class="cellrowborder" valign="top" width="42.77%" headers="mcps1.3.18.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560338__p57671339171420">x-amz-server-side-encryption-aws-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="57.230000000000004%" headers="mcps1.3.18.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560338__p40866906171420">Indicates the master key ID. This header is included in a response if SSE-KMS is used.</p>
<p id="EN-US_TOPIC_0125560338__p32257837171420">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_0125560338__row6543377910443"><td class="cellrowborder" valign="top" width="42.77%" headers="mcps1.3.18.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560338__p27861469171420">x-amz-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="57.230000000000004%" headers="mcps1.3.18.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560338__p42186497171420">Indicates an encryption algorithm. This header is included in a response if SSE-C is used.</p>
<p id="EN-US_TOPIC_0125560338__p44134156171420">Type: string</p>
<p id="EN-US_TOPIC_0125560338__p61663090171420">Example: x-amz-server-side-encryption-customer-algorithm:AES256</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560338__section37434462"><h4 class="sectiontitle">Response Elements</h4><p id="EN-US_TOPIC_0125560338__p43005067">This response contains elements to indicate the results of completing a multipart upload. <a href="#EN-US_TOPIC_0125560338__table32583578">Table 4</a> describes the elements.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560338__table32583578"></a><a name="table32583578"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560338__table32583578" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response elements</caption><thead align="left"><tr id="EN-US_TOPIC_0125560338__row51931690"><th align="left" class="cellrowborder" valign="top" width="29.01%" id="mcps1.3.19.3.2.3.1.1"><p id="EN-US_TOPIC_0125560338__p45717377">Element</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="70.99%" id="mcps1.3.19.3.2.3.1.2"><p id="EN-US_TOPIC_0125560338__p12120085">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560338__row42202829"><td class="cellrowborder" valign="top" width="29.01%" headers="mcps1.3.19.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560338__p62986002">Location</p>
</td>
<td class="cellrowborder" valign="top" width="70.99%" headers="mcps1.3.19.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560338__p1592523">Indicates the URL of the newly created object.</p>
<p id="EN-US_TOPIC_0125560338__p14332711">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560338__row61885537"><td class="cellrowborder" valign="top" width="29.01%" headers="mcps1.3.19.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560338__p46672571">Bucket</p>
</td>
<td class="cellrowborder" valign="top" width="70.99%" headers="mcps1.3.19.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560338__p22381889">Indicates the bucket that contains the newly created object.</p>
<p id="EN-US_TOPIC_0125560338__p110417">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560338__row993757"><td class="cellrowborder" valign="top" width="29.01%" headers="mcps1.3.19.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560338__p13385460">Key</p>
</td>
<td class="cellrowborder" valign="top" width="70.99%" headers="mcps1.3.19.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560338__p10480496">Indicates the key of the newly created object.</p>
<p id="EN-US_TOPIC_0125560338__p27215608">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560338__row43613881"><td class="cellrowborder" valign="top" width="29.01%" headers="mcps1.3.19.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560338__p43063478">ETag</p>
</td>
<td class="cellrowborder" valign="top" width="70.99%" headers="mcps1.3.19.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560338__p65589712">Indicates the ETag that identifies the metadata of the newly created object. This ETag is calculated using the MD5 values of parts comprising the newly created object.</p>
<p id="EN-US_TOPIC_0125560338__p53436499">Type: String</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560338__section1365842"><h4 class="sectiontitle">Error Responses</h4><ul id="EN-US_TOPIC_0125560338__ul08841452173910"><li id="EN-US_TOPIC_0125560338__li12879652153915">If the request contains no request body, OBS returns status code <strong id="EN-US_TOPIC_0125560338__b787919524396">400 Bad Request</strong>.</li><li id="EN-US_TOPIC_0125560338__li387985243911">If the request contains a request body in incorrect syntax, OBS returns status code <strong id="EN-US_TOPIC_0125560338__b1687935223910">400 Bad Request</strong>.</li><li id="EN-US_TOPIC_0125560338__li988015214392">If parts are not listed in the request body in ascending order, OBS returns status code <strong id="EN-US_TOPIC_0125560338__b1088055215392">400 Bad Request</strong> and error code <strong id="EN-US_TOPIC_0125560338__b6880165214394">InvalidPartOrder</strong>.</li><li id="EN-US_TOPIC_0125560338__li1688015263914">If an AK or signature is invalid, OBS returns status code <strong id="EN-US_TOPIC_0125560338__b198801752113912">403 Forbidden</strong> and error code <strong id="EN-US_TOPIC_0125560338__b888005220398">AccessDenied</strong>.</li><li id="EN-US_TOPIC_0125560338__li148811252173919">If the requested bucket does not exist, OBS returns status code <strong id="EN-US_TOPIC_0125560338__b11880195218392">404 Not Found</strong> and error code <strong id="EN-US_TOPIC_0125560338__b108801452153911">NoSuchBucket</strong>.</li><li id="EN-US_TOPIC_0125560338__li188811052173918">If the requested multipart upload does not exist, OBS returns <strong id="EN-US_TOPIC_0125560338__b208811852193919">404 NotFound</strong> and error code <strong id="EN-US_TOPIC_0125560338__b18881165211391">NoSuchUpload</strong>.</li><li id="EN-US_TOPIC_0125560338__li198831952183910">If the requester is not the initiator of the multipart upload, OBS returns status code <strong id="EN-US_TOPIC_0125560338__b3881165220393">403 Forbidden</strong> and error code <strong id="EN-US_TOPIC_0125560338__b168825521396">AccessDenied</strong>.</li><li id="EN-US_TOPIC_0125560338__li1688345212392">If the part list contains nonexistent parts, OBS returns status code <strong id="EN-US_TOPIC_0125560338__b10883552143911">400 Bad Request</strong> and error code <strong id="EN-US_TOPIC_0125560338__b18883175210396">InvalidPart</strong>.</li><li id="EN-US_TOPIC_0125560338__li2883135283918">If the ETag of a part in the part list is incorrect, OBS returns status code <strong id="EN-US_TOPIC_0125560338__b20883125243917">400 Bad Request</strong> and error code <strong id="EN-US_TOPIC_0125560338__b788335212397">InvalidPart</strong>.</li><li id="EN-US_TOPIC_0125560338__li15884105213912">If the size of a part (excluding the last part) in the part list is smaller than 5 MB, OBS returns status code <strong id="EN-US_TOPIC_0125560338__b3883175211396">400 Bad Request</strong>.</li><li id="EN-US_TOPIC_0125560338__li1388485213396">If the size of the newly created object is greater than 48.8 TB, OBS returns status code <strong id="EN-US_TOPIC_0125560338__b1088445253919">400 Bad Request</strong>.</li></ul>
<p id="EN-US_TOPIC_0125560338__p27274421">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_0125560338__section15624539"><h4 class="sectiontitle">Sample Request</h4><pre class="screen" id="EN-US_TOPIC_0125560338__screen3451272014535">POST /example-object?uploadId=AAAsb2FkIElEIGZvciBlbHZpbmcncyWeeS1tb3ZpZS5tMnRzIRRwbG9hZA HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/3.1
Host: bucketname.obs.example.com
Accept: */*
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 391
Authorization: AWS AKIAIOSFODNN7EXAMPLE:0RQf4/cRonhpaBX5sCYVf1bNRuU=
Expect: 100-continue
&lt;CompleteMultipartUpload&gt;
&lt;Part&gt;
&lt;PartNumber&gt;1&lt;/PartNumber&gt;
&lt;ETag&gt;"a54357aff0632cce46d942af68356b38"&lt;/ETag&gt;
&lt;/Part&gt;
&lt;Part&gt;
&lt;PartNumber&gt;2&lt;/PartNumber&gt;
&lt;ETag&gt;"0c78aef83f66abc1fa1e8477f296d394"&lt;/ETag&gt;
&lt;/Part&gt;
&lt;Part&gt;
&lt;PartNumber&gt;3&lt;/PartNumber&gt;
&lt;ETag&gt;"acbd18db4cc2f85cedef654fccc4a4d8"&lt;/ETag&gt;
&lt;/Part&gt;
&lt;/CompleteMultipartUpload&gt;</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560338__section6403130"><h4 class="sectiontitle">Sample Response</h4><pre class="screen" id="EN-US_TOPIC_0125560338__screen24996122145342">HTTP/1.1 200 OK
x-amz-id-2: Uuag1LuByRx9e6j5Onimru9pO4ZVKnJ2Qz7/C1NPcfTWAtRPfTaOFg==
x-amz-request-id: 656c76696e6727732072657175657374
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
x-reserved-indicator: 3
Content-Type: application/xml
Date: Mon, 1 Nov 2010 20:34:56 GMT
Connection: close
Content-Length: 306
Server: OBS
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;CompleteMultipartUploadResult xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;Location&gt;http://example-Bucket.obs.example.com/example-Object&lt;/Location&gt;
&lt;Bucket&gt;Example-Bucket&lt;/Bucket&gt;
&lt;Key&gt;Example-Object&lt;/Key&gt;
&lt;ETag&gt;"3858f62230ac3c915f300c664312c11f-9"&lt;/ETag&gt;
&lt;/CompleteMultipartUploadResult&gt;</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560338__section48891485"><h4 class="sectiontitle">Sample Request (Getting an Object Created from a Multipart Upload with Version ID Specified)</h4><pre class="screen" id="EN-US_TOPIC_0125560338__screen20756777145424"> POST /object?uploadId=DCD2FC9CAB7800000143947AB58A5094 HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/3.1
Host: bucketname.obs.example.com
Accept: */*
Date: Wed, 15 Jan 2014 06:09:39 +0000
Authorization: AWS C9590CEB8EC051BDEC9D:xQ9EFib6cohqMu2bLLJ0soseeUI=
Content-Length: 155
Expect: 100-continue
&lt;CompleteMultipartUpload&gt;
&lt;Part&gt;
&lt;PartNumber&gt;1&lt;/PartNumber&gt;
&lt;ETag&gt;"9fd2e548507ceef1a2183a8328b5cf2c"&lt;/ETag&gt;
&lt;/Part&gt;
&lt;/CompleteMultipartUpload&gt;</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560338__section37370189"><h4 class="sectiontitle">Sample Response (Getting an Object Created from a Multipart Upload with Version ID Specified)</h4><pre class="screen" id="EN-US_TOPIC_0125560338__screen46236342145454">HTTP/1.1 200 OK
Server: OBS
x-amz-request-id: DCD2FC9CAB78000001439484FB045617
x-amz-id-2: xw5X6Y7YIpWnQgHNYG3ce4+lj8O1GjiGvFXSgdPV1x2tYn2iZXFnTJm0yh5X5XnV
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
x-reserved-indicator: 3
Content-Type: application/xml
x-amz-version-id: AAABQ5R6tZ7c0vycq3gAAAAbVURTRkha
Date: Wed, 15 Jan 2014 06:09:39 GMT
Content-Length: 300
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;CompleteMultipartUploadResult xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;Location&gt;/example/multi&lt;/Location&gt;
&lt;Bucket&gt;example&lt;/Bucket&gt;
&lt;Key&gt;multi&lt;/Key&gt;
&lt;ETag&gt;"59297fcb0de64c706cbb46e382d9c625-1"&lt;/ETag&gt;
&lt;/CompleteMultipartUploadResult&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