vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/obs/api-ref/obs_04_0099.html
zhangyue 7d2a7ec198 OBS 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-11-05 16:37:11 +00:00

255 lines
25 KiB
HTML
Raw Blame History

<a name="obs_04_0099"></a><a name="obs_04_0099"></a>
<h1 class="topictitle1">Uploading Parts</h1>
<div id="body47090749"><div class="section" id="obs_04_0099__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0099__p35066376">After a multipart upload task is created, you can upload parts for this task using the obtained multipart upload ID. When parts are uploaded in a multipart upload of an object, the upload sequence does not affect part merging, namely, multiple parts can be uploaded concurrently.</p>
<p class="msonormal" id="obs_04_0099__p47161933">Part sizes range from 100 KB to 5 GB. However, when parts are being merged, the size of the last uploaded part ranges from 0 to 5 GB. The upload part ID ranges from 1 to 10,000.</p>
<p class="msonormal" id="obs_04_0099__p21804221">This operation supports server-side encryption.</p>
<div class="notice" id="obs_04_0099__note21311462"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p class="cautiontext" id="obs_04_0099__p21163563">The value of <strong id="obs_04_0099__b2309841157">partNumber</strong> in a multipart task is unique. If you upload a part of the same <strong id="obs_04_0099__b46531132121512">partNumber</strong> repeatedly, the last part uploaded will overwrite the previous one. When multiple concurrent uploading of the same <strong id="obs_04_0099__b6982162951612">partNumber</strong> part of the same object is performed, the Last Write Win policy is applied. The time of <strong id="obs_04_0099__b560211143175">Last Write</strong> is defined as the time when the metadata of the part is created. To ensure data accuracy, the client must be locked to ensure concurrent upload of the same part of the same object. Concurrent upload of different parts of the same object does not need to be locked.</p>
</div></div>
</div>
<div class="section" id="obs_04_0099__section57585434"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="obs_04_0099__screen42029491">PUT /ObjectName?partNumber=partNum&amp;uploadId=uploadID HTTP/1.1
Host: <em id="obs_04_0099__i123441746202313">bucketname</em>.obs.<em id="obs_04_0099__i034434682311">region</em>.example.com
Date: <em id="obs_04_0099__i8395995">date</em>
Content-Length: length
Authorization: <em id="obs_04_0099__i13774005">authorization</em>
Content-MD5:<em id="obs_04_0099__i27511718141812">md5</em>
&lt;object Content&gt;</pre>
</div>
<div class="section" id="obs_04_0099__section48506860"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0099__p48945599">This request uses parameters to specify the upload task ID and part number. <a href="#obs_04_0099__table8720142719451">Table 1</a> describes the parameters.</p>
<div class="tablenoborder"><a name="obs_04_0099__table8720142719451"></a><a name="table8720142719451"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0099__table8720142719451" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="obs_04_0099__row1272042764511"><th align="left" class="cellrowborder" valign="top" width="24.8%" id="mcps1.3.3.3.2.5.1.1"><p id="obs_04_0099__p1720152713451">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="9%" id="mcps1.3.3.3.2.5.1.2"><p id="obs_04_0099__p1058914484510"><strong id="obs_04_0099__b1051119540459">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="8.32%" id="mcps1.3.3.3.2.5.1.3"><p id="obs_04_0099__p1372062744512"><strong id="obs_04_0099__b1085600142013">Mandatory (Yes/No)</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.879999999999995%" id="mcps1.3.3.3.2.5.1.4"><p id="obs_04_0099__p1372072713458"><strong id="obs_04_0099__b13345122102014">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0099__row19720142715458"><td class="cellrowborder" valign="top" width="24.8%" headers="mcps1.3.3.3.2.5.1.1 "><p id="obs_04_0099__p17720927144516">partNumber</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.3.3.3.2.5.1.2 "><p id="obs_04_0099__p12589104474510">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="8.32%" headers="mcps1.3.3.3.2.5.1.3 "><p id="obs_04_0099__p472062715452">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="57.879999999999995%" headers="mcps1.3.3.3.2.5.1.4 "><p id="obs_04_0099__p7134184955020"><strong id="obs_04_0099__b204163609083840">Explanation</strong>:</p>
<p id="obs_04_0099__p17208279458">Indicates the ID of a part to be uploaded.</p>
<p id="obs_04_0099__p3134134945010"><strong id="obs_04_0099__b12911141902118">Restrictions</strong>:</p>
<p id="obs_04_0099__p530985916110">None</p>
<p id="obs_04_0099__p14567155813338"><strong id="obs_04_0099__b16567158133316">Value range</strong>:</p>
<p id="obs_04_0099__p1156717585338">An integer ranging from 1 to 10000.</p>
<p id="obs_04_0099__p165678588336"><strong id="obs_04_0099__b15671358153318">Default value</strong>:</p>
<p id="obs_04_0099__p256765816332">None</p>
</td>
</tr>
<tr id="obs_04_0099__row10720182714454"><td class="cellrowborder" valign="top" width="24.8%" headers="mcps1.3.3.3.2.5.1.1 "><p id="obs_04_0099__p17720527124513">uploadId</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.3.3.3.2.5.1.2 "><p id="obs_04_0099__p02461353143213">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.32%" headers="mcps1.3.3.3.2.5.1.3 "><p id="obs_04_0099__p4720527184517">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="57.879999999999995%" headers="mcps1.3.3.3.2.5.1.4 "><p id="obs_04_0099__p1680182217712"><strong id="obs_04_0099__b28136642783840">Explanation</strong>:</p>
<p id="obs_04_0099__p9841414334">Indicates a multipart upload ID.</p>
<p id="obs_04_0099__p198014227711"><strong id="obs_04_0099__b6353114418213">Restrictions</strong>:</p>
<p id="obs_04_0099__p1121442323412">None</p>
<p id="obs_04_0099__p18803223712"><strong id="obs_04_0099__b15425874484113">Value range</strong>:</p>
<p id="obs_04_0099__p1673813249348">None</p>
<p id="obs_04_0099__p1801822873"><strong id="obs_04_0099__b15884523758426">Default value</strong>:</p>
<p id="obs_04_0099__p287132510341">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0099__section33908557"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0099__p63738092">This request uses common headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0099__table6350201154610" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Server-side encryption request headers</caption><thead align="left"><tr id="obs_04_0099__row1935031119465"><th align="left" class="cellrowborder" valign="top" width="39.879999999999995%" id="mcps1.3.4.3.2.5.1.1"><p id="obs_04_0099__p9350211124619">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="9.719999999999999%" id="mcps1.3.4.3.2.5.1.2"><p id="obs_04_0099__p8903142734613"><strong id="obs_04_0099__b18884061534">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="10.52%" id="mcps1.3.4.3.2.5.1.3"><p id="obs_04_0099__p153507113464"><strong id="obs_04_0099__b4446132711229">Mandatory (Yes/No)</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="39.879999999999995%" id="mcps1.3.4.3.2.5.1.4"><p id="obs_04_0099__p735018116464">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0099__row11350711104611"><td class="cellrowborder" valign="top" width="39.879999999999995%" headers="mcps1.3.4.3.2.5.1.1 "><p id="obs_04_0099__p13350171114461">x-obs-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="9.719999999999999%" headers="mcps1.3.4.3.2.5.1.2 "><p id="obs_04_0099__p13903192717466">String</p>
</td>
<td class="cellrowborder" valign="top" width="10.52%" headers="mcps1.3.4.3.2.5.1.3 "><p id="obs_04_0099__p53501211174611">No. This header is required when SSE-C is used. The encryption algorithm must be the same as that used to initiate multipart upload tasks.</p>
</td>
<td class="cellrowborder" valign="top" width="39.879999999999995%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0099__p164482717713"><strong id="obs_04_0099__b7770548283840">Explanation</strong>:</p>
<p id="obs_04_0099__p135031118462">The algorithm used for encryption.</p>
<p id="obs_04_0099__p33501111174610">Example: <strong id="obs_04_0099__b886198734">x-obs-server-side-encryption-customer-algorithm:AES256</strong></p>
<p id="obs_04_0099__p6442276711"><strong id="obs_04_0099__b31031223112011">Restrictions</strong>:</p>
<ul id="obs_04_0099__ul106667191155"><li id="obs_04_0099__li5666121910152">Indicates the encryption algorithm used when SSE-C is used.</li><li id="obs_04_0099__li12666319181518">This header must be used together with <strong id="obs_04_0099__b13104680825253">x-obs-server-side-encryption-customer-key</strong> and <strong id="obs_04_0099__b4384346495253">x-obs-server-side-encryption-customer-key-MD5</strong>.</li></ul>
<p id="obs_04_0099__p512665210340"><strong id="obs_04_0099__b712695215349">Value range</strong>:</p>
<p id="obs_04_0099__p1112605215341">AES256</p>
<p id="obs_04_0099__p10126652113415"><strong id="obs_04_0099__b812617527346">Default value</strong>:</p>
<p id="obs_04_0099__p14126135218348">None</p>
</td>
</tr>
<tr id="obs_04_0099__row9350171184613"><td class="cellrowborder" valign="top" width="39.879999999999995%" headers="mcps1.3.4.3.2.5.1.1 "><p id="obs_04_0099__p1235120113466">x-obs-server-side-encryption-customer-key</p>
</td>
<td class="cellrowborder" valign="top" width="9.719999999999999%" headers="mcps1.3.4.3.2.5.1.2 "><p id="obs_04_0099__p8903102719464">String</p>
</td>
<td class="cellrowborder" valign="top" width="10.52%" headers="mcps1.3.4.3.2.5.1.3 "><p id="obs_04_0099__p4351311164612">No. This header is required when SSE-C is used. The key must be the same as that used to initiate multipart upload tasks.</p>
</td>
<td class="cellrowborder" valign="top" width="39.879999999999995%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0099__p18983112918710"><strong id="obs_04_0099__b199223973983840">Explanation</strong>:</p>
<p id="obs_04_0099__p7351911204614">The key used for encrypting an object.</p>
<p id="obs_04_0099__p2351181164620">Example: <strong id="obs_04_0099__b450436444">x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=</strong></p>
<p id="obs_04_0099__p5983329476"><strong id="obs_04_0099__b1655572752019">Restrictions</strong>:</p>
<ul id="obs_04_0099__ul2055211469157"><li id="obs_04_0099__li2055218469159">This header is used only when SSE-C is used for encryption.</li><li id="obs_04_0099__li1855274621513">This header is a Base64-encoded 256-bit key and must be used together with <strong id="obs_04_0099__b1690332532315">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0099__b790419255237">x-obs-server-side-encryption-customer-key-MD5</strong>.</li></ul>
<p id="obs_04_0099__p69834293720"><strong id="obs_04_0099__b209763687384113">Value range</strong>:</p>
<p id="obs_04_0099__p7270781262">None</p>
<p id="obs_04_0099__p3983122914719"><strong id="obs_04_0099__b19439778258426">Default value</strong>:</p>
<p id="obs_04_0099__p6902659165217">None</p>
</td>
</tr>
<tr id="obs_04_0099__row12351911134612"><td class="cellrowborder" valign="top" width="39.879999999999995%" headers="mcps1.3.4.3.2.5.1.1 "><p id="obs_04_0099__p173511811124618">x-obs-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="9.719999999999999%" headers="mcps1.3.4.3.2.5.1.2 "><p id="obs_04_0099__p129031273462">String</p>
</td>
<td class="cellrowborder" valign="top" width="10.52%" headers="mcps1.3.4.3.2.5.1.3 "><p id="obs_04_0099__p844213722118">No. This header is required when SSE-C is used. The MD5 value must be the same as that used to initiate multipart upload tasks.</p>
</td>
<td class="cellrowborder" valign="top" width="39.879999999999995%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0099__p38353310710"><strong id="obs_04_0099__b196822792683840">Explanation</strong>:</p>
<p id="obs_04_0099__p6351711204613">The MD5 value of the encryption key. The MD5 value is used to check whether any error occurs during the transmission of the key. </p>
<p id="obs_04_0099__p15351911154614">Example: <strong id="obs_04_0099__b2088578312">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0099__p1183533777"><strong id="obs_04_0099__b10882143112201">Restrictions</strong>:</p>
<p id="obs_04_0099__p10259184318160">This header is used only when SSE-C is used for encryption.</p>
<p id="obs_04_0099__p1526443283520">This header is a Base64-encoded 128-bit MD5 value and must be used together with <strong id="obs_04_0099__b373333220207">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0099__b18733143272012">x-obs-server-side-encryption-customer-key</strong>.</p>
<p id="obs_04_0099__p1326512129538"><strong id="obs_04_0099__b152650126531">Value range</strong>:</p>
<p id="obs_04_0099__p102651912165313">Base64-encoded MD5 value of the key ID.</p>
<p id="obs_04_0099__p726541265318"><strong id="obs_04_0099__b1826571245319">Default value</strong>:</p>
<p id="obs_04_0099__p18265161217535">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0099__section36741558"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0099__p61081072">This request involves no elements.</p>
</div>
<div class="section" id="obs_04_0099__section62238568"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0099__screen35591885"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>status_code
Date:<span class="w"> </span>date
ETag:<span class="w"> </span>etag
Content-Length:<span class="w"> </span>length
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0099__section23276204"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0099__p1512332591013">The response to the request uses common headers. For details, see <a href="obs_04_0013.html#obs_04_0013__d0e686">Table 1</a>.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0099__table025002574717" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0099__row192501325144719"><th align="left" class="cellrowborder" valign="top" width="28.110000000000003%" id="mcps1.3.7.3.2.4.1.1"><p id="obs_04_0099__p1250725104717">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25.650000000000002%" id="mcps1.3.7.3.2.4.1.2"><p id="obs_04_0099__p1984643124717"><strong id="obs_04_0099__b5980134813545">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="46.239999999999995%" id="mcps1.3.7.3.2.4.1.3"><p id="obs_04_0099__p725014252475">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0099__row22503256471"><td class="cellrowborder" valign="top" width="28.110000000000003%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0099__p1425010255470">x-obs-server-side-encryption</p>
</td>
<td class="cellrowborder" valign="top" width="25.650000000000002%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0099__p315012318381">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.239999999999995%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0099__p817413204155"><strong id="obs_04_0099__b1773799619">Explanation</strong>:</p>
<p id="obs_04_0099__p2174122012155">The encryption method used by the server.</p>
<p id="obs_04_0099__p13174192013155">Example: <strong id="obs_04_0099__b1452580161">x-obs-server-side-encryption:kms</strong></p>
<p id="obs_04_0099__p317482018156"><strong id="obs_04_0099__b34619311256">Restrictions</strong>:</p>
<p id="obs_04_0099__p1817442020151">This header is included in a response if SSE-KMS is used. </p>
<p id="obs_04_0099__p121741520171510"><strong id="obs_04_0099__b131741420181513">Value range</strong>:</p>
<ul id="obs_04_0099__ul971092521519"><li id="obs_04_0099__li13710102516156">kms</li><li id="obs_04_0099__li13710122515157">AES256</li></ul>
<p id="obs_04_0099__p817419207155"><strong id="obs_04_0099__b14174520131519">Default value</strong>:</p>
<p id="obs_04_0099__p171741620121512">None</p>
</td>
</tr>
<tr id="obs_04_0099__row12501425164710"><td class="cellrowborder" valign="top" width="28.110000000000003%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0099__p3250225114711">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="25.650000000000002%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0099__p10703132916389">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.239999999999995%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0099__p1246233102412"><strong id="obs_04_0099__b2736144112413">Explanation</strong>:</p>
<p id="obs_04_0099__p846216315247">ID of a specified key used for SSE-KMS encryption.</p>
<p id="obs_04_0099__p13462113122413"><strong id="obs_04_0099__b258073769">Restrictions</strong>:</p>
<p id="obs_04_0099__p184628315241">This header can only be used when you specify <strong id="obs_04_0099__b5096579703711">kms</strong> for the <strong id="obs_04_0099__b18484099733711">x-obs-server-side-encryption</strong> header.</p>
<p id="obs_04_0099__p14628382412"><strong id="obs_04_0099__b1566293306">Default value</strong>:</p>
<p id="obs_04_0099__p15462173172411">If you specify <strong id="obs_04_0099__b16583731643711">kms</strong> for encryption but do not specify a key ID, the default master key will be used. If there is not a default master key, OBS will create one and use it.</p>
</td>
</tr>
<tr id="obs_04_0099__row17250125124715"><td class="cellrowborder" valign="top" width="28.110000000000003%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0099__p82501025134717">x-obs-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="25.650000000000002%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0099__p137182873913">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.239999999999995%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0099__p12893134920717"><strong id="obs_04_0099__b116843299183840">Explanation</strong>:</p>
<p id="obs_04_0099__p62501255475">The algorithm used for encryption.</p>
<p id="obs_04_0099__p17250725124710">Example: <strong id="obs_04_0099__b34541498208">x-obs-server-side-encryption-customer-algorithm:AES256</strong></p>
<p id="obs_04_0099__p620151811120"><strong id="obs_04_0099__b214212237256">Restrictions</strong>:</p>
<p id="obs_04_0099__p52011318121210">This header is included in a response if SSE-C is used for server-side encryption.</p>
<p id="obs_04_0099__p17693112181618"><strong id="obs_04_0099__b116931628166">Value range</strong>:</p>
<p id="obs_04_0099__p1869312215166">AES256</p>
<p id="obs_04_0099__p1469310220169"><strong id="obs_04_0099__b769352111614">Default value</strong>:</p>
<p id="obs_04_0099__p18693523165">None</p>
</td>
</tr>
<tr id="obs_04_0099__row5250202511471"><td class="cellrowborder" valign="top" width="28.110000000000003%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0099__p172501125194710">x-obs-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="25.650000000000002%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0099__p334229183919">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.239999999999995%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0099__p178458531977"><strong id="obs_04_0099__b44446960383840">Explanation</strong>:</p>
<p id="obs_04_0099__p7250192504715">The MD5 value of the encryption key.</p>
<p id="obs_04_0099__p16250102519472">Example: <strong id="obs_04_0099__b999542934">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0099__p93551620131213"><strong id="obs_04_0099__b1948133462516">Restrictions</strong>:</p>
<p id="obs_04_0099__p199265071311">This header is included in a response if SSE-C is used for server-side encryption.</p>
<p id="obs_04_0099__p752381515169"><strong id="obs_04_0099__b1552341513165">Value range</strong>:</p>
<p id="obs_04_0099__p19523151518161">Base64-encoded MD5 value of the key ID.</p>
<p id="obs_04_0099__p135231115201615"><strong id="obs_04_0099__b1952351551619">Default value</strong>:</p>
<p id="obs_04_0099__p3523715121620">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0099__section8159252"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0099__p58420054">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0099__section6324408"><h4 class="sectiontitle">Error Responses</h4><ol id="obs_04_0099__ol19370155971011"><li class="msonormal" id="obs_04_0099__li9346162171114">If a part number is not within the range from 1 to 10000, OBS returns <strong id="obs_04_0099__b447120499213">400 Bad Request</strong>.</li><li class="msonormal" id="obs_04_0099__li3800147114">If a part size has exceeded 5 GB, the error code <strong id="obs_04_0099__b1619951719227">400 Bad Request</strong> is returned.</li><li class="msonormal" id="obs_04_0099__li1176471115">If the AK or signature is invalid, OBS returns <strong id="obs_04_0099__b5791236152220">403 Forbidden</strong> and the error code is <strong id="obs_04_0099__b102301943202218">AccessDenied</strong>.</li><li class="msonormal" id="obs_04_0099__li62881411101110">Check whether the bucket exists. If the bucket is not found, OBS returns <strong id="obs_04_0099__b1112115112239">404 Not Found</strong> and the error code is <strong id="obs_04_0099__b5658187102315">NoSuchBucket</strong>.</li><li class="msonormal" id="obs_04_0099__li398421318117">View the bucket ACL to check whether the user has the read permission for the requested bucket. If the user does not have the read permission, OBS returns <strong id="obs_04_0099__b7748103113234">403 AccessDenied</strong>.</li><li class="msonormal" id="obs_04_0099__li1382420165111">Check whether the multipart upload task exists. If the task does not exist, OBS returns <strong id="obs_04_0099__b167811456142311">404 Not Found</strong> and the error code is <strong id="obs_04_0099__b13020442414">NoSuchUpload</strong>.</li><li class="msonormal" id="obs_04_0099__li10370459191018">Check whether the request user is the initiator of the multipart upload task. If not, OBS returns <strong id="obs_04_0099__b624211212248">403 Forbidden</strong> and the error code is <strong id="obs_04_0099__b684629112419">AccessDenied</strong>.</li></ol>
<p class="msonormal" id="obs_04_0099__p47007439">Other errors are included in <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>
<div class="section" id="obs_04_0099__section1791150144618"><h4 class="sectiontitle">Sample Request</h4><pre class="screen" id="obs_04_0099__screen1757694184618">PUT /object02?partNumber=1&amp;uploadId=00000163D40171ED8DF4050919BD02B8 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.<em id="obs_04_0099__i12367117502">region</em>.example.com
Accept: */*
Date: WED, 01 Jul 2015 05:15:55 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:ZB0hFwaHubi1aKHv7dSZjJts40g=
Content-Length: 102015348
[102015348 Byte part content]</pre>
</div>
<div class="section" id="obs_04_0099__section1649818566470"><h4 class="sectiontitle">Sample Response</h4><div class="codecoloring" codetype="Xml" id="obs_04_0099__screen152195618473"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span>
<span class="normal">6</span>
<span class="normal">7</span></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>200<span class="w"> </span>OK
Server:<span class="w"> </span>OBS
x-obs-request-id:<span class="w"> </span>8DF400000163D40956A703289CA066F1
ETag:<span class="w"> </span>&quot;b026324c6904b2a9cb4b88d6d61c81d1&quot;
x-obs-id-2:<span class="w"> </span>32AAAQAAEAABAAAQAAEAABAAAQAAEAABCUQu/EOEVSMa04GXVwy0z9WI+BsDKvfh
Date:<span class="w"> </span>WED,<span class="w"> </span>01<span class="w"> </span>Jul<span class="w"> </span>2015<span class="w"> </span>05:15:55<span class="w"> </span>GMT
Content-Length:<span class="w"> </span>0
</pre></div></td></tr></table></div>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0096.html">Operations on Multipart Upload</a></div>
</div>
</div>
View Git Blame Copy Permalink