doc-exports/docs/obs/s3api/en-us_topic_0125560402.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

73 lines
6.5 KiB
HTML

<a name="EN-US_TOPIC_0125560402"></a><a name="EN-US_TOPIC_0125560402"></a>
<h1 class="topictitle1">Abort Multipart Upload</h1>
<div id="body38341088"><p class="msonormal" id="EN-US_TOPIC_0125560402__p5207733">You can use this operation to abort a multipart upload. After the request is sent, parts associated to the multipart upload cannot be uploaded or listed.</p>
<div class="section" id="EN-US_TOPIC_0125560402__section4482025"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560402__screen4759447114814">DELETE /ObjectName?uploadId=uplaodID HTTP/1.1
User-Agent: agent
Host: bucketname.obs.example.com
Accept: */*
Date: date
Authorization: auth</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560402__section40338225"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0125560402__p50805071">This request uses one parameter to specify the ID of the multipart upload to be completed. <a href="#EN-US_TOPIC_0125560402__table46411854">Table 1</a> describes the parameter.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560402__table46411854"></a><a name="table46411854"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560402__table46411854" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameter</caption><thead align="left"><tr id="EN-US_TOPIC_0125560402__row54874371"><th align="left" class="cellrowborder" valign="top" width="26.552655265526553%" id="mcps1.3.3.3.2.4.1.1"><p id="EN-US_TOPIC_0125560402__p15639030">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="45.92459245924592%" id="mcps1.3.3.3.2.4.1.2"><p id="EN-US_TOPIC_0125560402__p58801955">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="27.522752275227525%" id="mcps1.3.3.3.2.4.1.3"><p id="EN-US_TOPIC_0125560402__p65337904">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560402__row57878853"><td class="cellrowborder" valign="top" width="26.552655265526553%" headers="mcps1.3.3.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560402__p57675531">uploadId</p>
</td>
<td class="cellrowborder" valign="top" width="45.92459245924592%" headers="mcps1.3.3.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560402__p41206441">Indicates the ID of the multipart upload to be aborted.</p>
<p id="EN-US_TOPIC_0125560402__p35313657">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="27.522752275227525%" headers="mcps1.3.3.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560402__p41834000">Mandatory</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560402__section27499711"><h4 class="sectiontitle">Request Headers</h4><p id="EN-US_TOPIC_0125560402__p29561768">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_0125560402__section46170811"><h4 class="sectiontitle">Request Elements</h4><p id="EN-US_TOPIC_0125560402__p10144233">This request involves no elements.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560402__section1451448"><h4 class="sectiontitle">Response Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560402__screen9987254114829">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
Date: date
Server: server</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560402__section13063034"><h4 class="sectiontitle">Response Headers</h4><p id="EN-US_TOPIC_0125560402__p45352290">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>
<div class="section" id="EN-US_TOPIC_0125560402__section50458444"><h4 class="sectiontitle">Response Elements</h4><p id="EN-US_TOPIC_0125560402__p62784588">This response involves no elements.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560402__section51472815"><h4 class="sectiontitle">Error Responses</h4><ul id="EN-US_TOPIC_0125560402__ul10537112512416"><li id="EN-US_TOPIC_0125560402__li353562514414">If an AK or signature is invalid, OBS returns status code <strong id="EN-US_TOPIC_0125560402__b2535625114119">403 Forbidden</strong> and error code <strong id="EN-US_TOPIC_0125560402__b153515251417">AccessDenied</strong>.</li><li id="EN-US_TOPIC_0125560402__li11536122594111">If the requested bucket does not exist, OBS returns status code <strong id="EN-US_TOPIC_0125560402__b1353522518418">404 Not Found</strong> and error code <strong id="EN-US_TOPIC_0125560402__b1853692517414">NoSuchBucket</strong>.</li><li id="EN-US_TOPIC_0125560402__li11536142504112">If the requester is neither the initiator of a multipart upload nor the bucket owner, OBS returns status code <strong id="EN-US_TOPIC_0125560402__b45362025174117">403 Forbidden</strong> and error code <strong id="EN-US_TOPIC_0125560402__b15536152514410">AccessDenied</strong>.</li><li id="EN-US_TOPIC_0125560402__li45371025194112">If the operation succeeded, OBS returns status code <strong id="EN-US_TOPIC_0125560402__b155361425144115">204 No Content</strong>.</li></ul>
<p id="EN-US_TOPIC_0125560402__p66506508">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_0125560402__section8332925"><h4 class="sectiontitle">Sample Request</h4><pre class="screen" id="EN-US_TOPIC_0125560402__screen60165485114843">DELETE /example-object?uploadId=VXBsb2FkIElEIGZvciBlbHZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZ 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
Authorization: AWS AKIAIOSFODNN7EXAMPLE:0RQf3/cRonhpaBX5sCYVf1bNRuU=</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560402__section7887465"><h4 class="sectiontitle">Sample Response</h4><pre class="screen" id="EN-US_TOPIC_0125560402__screen3578300114852">HTTP/1.1 204 No Content
x-amz-id-2: Weag1LuByRx9e6j5Onimru9pO4ZVKnJ2Qz7/C1NPcfTWAtRPfTaOFg==
x-amz-request-id: 996c76696e6727732072657175657374
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
Date: Mon, 1 Nov 2010 20:34:56 GMT
Server: OBS</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>