forked from docs/doc-exports
weihongmin1
285f8e4a64
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com> Co-authored-by: weihongmin1 <weihongmin1@huawei.com> Co-committed-by: weihongmin1 <weihongmin1@huawei.com>
143 lines
13 KiB
HTML
143 lines
13 KiB
HTML
<a name="obs_04_0103"></a><a name="obs_04_0103"></a>
|
|
|
|
<h1 class="topictitle1">Canceling a Multipart Upload Task</h1>
|
|
<div id="body41058758"><div class="section" id="obs_04_0103__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0103__p40202410">You can call this API to cancel a multipart upload task. You cannot upload or list parts after operations to merge parts or abort a multipart upload are performed.</p>
|
|
</div>
|
|
<div class="section" id="obs_04_0103__section26277376"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0103__screen21639489"><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>DELETE<span class="w"> </span>/ObjectName?uploadId=uplaodID<span class="w"> </span>HTTP/1.1<span class="w"> </span>
|
|
Host:<span class="w"> </span>bucketname.obs.region.example.com
|
|
Date:<span class="w"> </span>date
|
|
Authorization:<span class="w"> </span>auth
|
|
</pre></div></td></tr></table></div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="obs_04_0103__section35169792"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0103__p4605046">This request uses message parameters to specify the multipart upload task number. <a href="#obs_04_0103__table46411854">Table 1</a> describes the parameters.</p>
|
|
|
|
<div class="tablenoborder"><a name="obs_04_0103__table46411854"></a><a name="table46411854"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0103__table46411854" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="obs_04_0103__row5822871"><th align="left" class="cellrowborder" valign="top" width="24.240000000000002%" id="mcps1.3.3.3.2.4.1.1"><p id="obs_04_0103__p1890565">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="56.57%" id="mcps1.3.3.3.2.4.1.2"><p id="obs_04_0103__p36044731">Description</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.189999999999998%" id="mcps1.3.3.3.2.4.1.3"><p id="obs_04_0103__p37043600">Mandatory</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="obs_04_0103__row27021358"><td class="cellrowborder" valign="top" width="24.240000000000002%" headers="mcps1.3.3.3.2.4.1.1 "><p id="obs_04_0103__p41246365">uploadId</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.3.3.3.2.4.1.2 "><p id="obs_04_0103__p52621257">Indicates a multipart upload.</p>
|
|
<p id="obs_04_0103__p3829265">Type: string</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.3.3.2.4.1.3 "><p id="obs_04_0103__p41735010">Yes</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="obs_04_0103__section48092677"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0103__p25092644">This request uses common headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
|
|
<p id="obs_04_0103__p1153442642015">In addition to the common request headers, the header listed in <a href="#obs_04_0103__table101171333196">Table 2</a> may be used.</p>
|
|
|
|
<div class="tablenoborder"><a name="obs_04_0103__table101171333196"></a><a name="table101171333196"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0103__table101171333196" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Additional request header</caption><thead align="left"><tr id="obs_04_0103__obs_04_0082_row6117193312912"><th align="left" class="cellrowborder" valign="top" width="19.93%" id="mcps1.3.4.4.2.5.1.1"><p id="obs_04_0103__obs_04_0082_p1117153318914"><strong id="obs_04_0103__b179437277495246">Header</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="12.629999999999999%" id="mcps1.3.4.4.2.5.1.2"><p id="obs_04_0103__obs_04_0082_p18410532121819"><strong id="obs_04_0103__b156315545195356">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="11.66%" id="mcps1.3.4.4.2.5.1.3"><p id="obs_04_0103__obs_04_0082_p121171433497"><strong id="obs_04_0103__b76617675395345">Mandatory (Yes/No)</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="55.779999999999994%" id="mcps1.3.4.4.2.5.1.4"><p id="obs_04_0103__obs_04_0082_p16117183315914"><strong id="obs_04_0103__b5091634029539">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="obs_04_0103__obs_04_0082_row10117163317911"><td class="cellrowborder" valign="top" width="19.93%" headers="mcps1.3.4.4.2.5.1.1 "><p id="obs_04_0103__obs_04_0082_p81172334910">x-obs-request-payer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.629999999999999%" headers="mcps1.3.4.4.2.5.1.2 "><p id="obs_04_0103__obs_04_0082_p74101432101810">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.66%" headers="mcps1.3.4.4.2.5.1.3 "><p id="obs_04_0103__obs_04_0082_p1811710339915">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.779999999999994%" headers="mcps1.3.4.4.2.5.1.4 "><p id="obs_04_0103__obs_04_0082_p4915529112011"><strong id="obs_04_0103__b78508727795413">Definition</strong>:</p>
|
|
<p id="obs_04_0103__obs_04_0082_p155114443566">Indicates that the requester agrees to pay for the request and traffic.</p>
|
|
<p id="obs_04_0103__obs_04_0082_p159151529172013"><strong id="obs_04_0103__b58720013595529">Constraints</strong>:</p>
|
|
<p id="obs_04_0103__obs_04_0082_p143311938205210">If this header is not included in the request when the requester tries to access a requester-pays bucket, the authentication fails and error "403 Forbidden" is returned.</p>
|
|
<p id="obs_04_0103__obs_04_0082_p1091519295206"><strong id="obs_04_0103__b134516823795745">Range</strong>:</p>
|
|
<p id="obs_04_0103__obs_04_0082_p10891636161916">requester</p>
|
|
<p id="obs_04_0103__obs_04_0082_p5915112992010"><strong id="obs_04_0103__b100007018895541">Default value</strong>:</p>
|
|
<p id="obs_04_0103__obs_04_0082_p854916466518">None</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="obs_04_0103__section30180910"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0103__p38926708">This request involves no elements.</p>
|
|
</div>
|
|
<div class="section" id="obs_04_0103__section3192742"><h4 class="sectiontitle">Response Syntax</h4><pre class="screen" id="obs_04_0103__screen48907781">HTTP/1.1 <em id="obs_04_0103__i57629981">status_code</em>
|
|
Date: <em id="obs_04_0103__i37516848">date</em></pre>
|
|
</div>
|
|
<div class="section" id="obs_04_0103__section28734685"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0103__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>
|
|
<p id="obs_04_0103__p143785356613">In addition to the common response headers, the header listed in <a href="#obs_04_0103__table172904210301">Table 3</a> may be used.</p>
|
|
|
|
<div class="tablenoborder"><a name="obs_04_0103__table172904210301"></a><a name="table172904210301"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0103__table172904210301" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response header</caption><thead align="left"><tr id="obs_04_0103__obs_04_0086_row029110203010"><th align="left" class="cellrowborder" valign="top" width="23.14%" id="mcps1.3.7.4.2.4.1.1"><p id="obs_04_0103__obs_04_0086_p182917217303"><strong id="obs_04_0103__b168411972295246">Header</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="11.99%" id="mcps1.3.7.4.2.4.1.2"><p id="obs_04_0103__obs_04_0086_p1078810532411"><strong id="obs_04_0103__b4676210095356">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="64.87%" id="mcps1.3.7.4.2.4.1.3"><p id="obs_04_0103__obs_04_0086_p142912215302"><strong id="obs_04_0103__b466033169539">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="obs_04_0103__obs_04_0086_row229182183011"><td class="cellrowborder" valign="top" width="23.14%" headers="mcps1.3.7.4.2.4.1.1 "><p id="obs_04_0103__obs_04_0086_p4291112123010">x-obs-request-payer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.99%" headers="mcps1.3.7.4.2.4.1.2 "><p id="obs_04_0103__obs_04_0086_p17789115172410">string</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.87%" headers="mcps1.3.7.4.2.4.1.3 "><p id="obs_04_0103__obs_04_0086_p451692516220"><strong id="obs_04_0103__b209285967795413">Definition</strong>:</p>
|
|
<p id="obs_04_0103__obs_04_0086_p7516202518210">Indicates that the requester agrees to pay for the request and traffic.</p>
|
|
<p id="obs_04_0103__obs_04_0086_p1551619258218"><strong id="obs_04_0103__b157039810695529">Constraints</strong>:</p>
|
|
<p id="obs_04_0103__obs_04_0086_p145161125625">If this header is not included in the request when the requester tries to access a requester-pays bucket, the authentication fails and error "403 Forbidden" is returned.</p>
|
|
<p id="obs_04_0103__obs_04_0086_p165161259212"><strong id="obs_04_0103__b189617504595745">Range</strong>:</p>
|
|
<p id="obs_04_0103__obs_04_0086_p051615259213">requester</p>
|
|
<p id="obs_04_0103__obs_04_0086_p20516162510216"><strong id="obs_04_0103__b168294724995541">Default value</strong>:</p>
|
|
<p id="obs_04_0103__obs_04_0086_p1851614251728">None</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="obs_04_0103__section57285581"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0103__p1704444">This response contains no elements.</p>
|
|
</div>
|
|
<div class="section" id="obs_04_0103__section45808181"><h4 class="sectiontitle">Error Responses</h4><ol id="obs_04_0103__ol4433265132"><li class="msonormal" id="obs_04_0103__li1129382921313">If the AK or signature is invalid, OBS returns <strong id="obs_04_0103__b12261141601120">403 Forbidden</strong> and the error code is <strong id="obs_04_0103__b162627164114">AccessDenied</strong>.</li><li class="msonormal" id="obs_04_0103__li15549173131312">If the requested bucket is not found, OBS returns <strong id="obs_04_0103__b499639113310">404 Not Found</strong> and the error code is <strong id="obs_04_0103__b0100103943311">NoSuchBucket</strong>.</li><li class="msonormal" id="obs_04_0103__li17491133201313">If you are neither the initiator of a multipart upload nor the bucket owner, OBS returns <strong id="obs_04_0103__b93162046111119">403 Forbidden</strong>.</li><li class="msonormal" id="obs_04_0103__li1343102616132">If the operation is successful, OBS returns <strong id="obs_04_0103__b04195414123">204 No Content</strong> to the user.</li></ol>
|
|
<p class="msonormal" id="obs_04_0103__p43303331">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_0103__section7359175714244"><h4 class="sectiontitle">Sample Request</h4><div class="codecoloring" codetype="Xml" id="obs_04_0103__screen123212113257"><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></pre></div></td><td class="code"><div><pre><span></span>DELETE<span class="w"> </span>/object02?uploadId=00000163D46218698DF407362295674C<span class="w"> </span>HTTP/1.1
|
|
User-Agent:<span class="w"> </span>curl/7.29.0
|
|
Host:<span class="w"> </span>examplebucket.obs.region.example.com
|
|
Accept:<span class="w"> </span>*/*
|
|
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:28:27<span class="w"> </span>GMT
|
|
Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEBQQCEC:QmM2d1DBXZ/b8drqtEv1QJHPbM0=
|
|
</pre></div></td></tr></table></div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="obs_04_0103__section1256614588720"><h4 class="sectiontitle">Sample Response</h4><div class="codecoloring" codetype="Xml" id="obs_04_0103__screen196141958677"><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></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>204<span class="w"> </span>No<span class="w"> </span>Content
|
|
Server:<span class="w"> </span>OBS
|
|
x-obs-request-id:<span class="w"> </span>8DF400000163D463E02A07EC2295674C
|
|
x-obs-id-2:<span class="w"> </span>32AAAQAAEAABAAAQAAEAABAAAQAAEAABCTp5YDlzn0UgqG3laRfkHLGyz7RpR9ON
|
|
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:28:27<span class="w"> </span>GMT
|
|
</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>
|
|
|