forked from docs/doc-exports
weihongmin1
a41a4e0331
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com> Co-authored-by: weihongmin1 <weihongmin1@huawei.com> Co-committed-by: weihongmin1 <weihongmin1@huawei.com>
135 lines
12 KiB
HTML
135 lines
12 KiB
HTML
<a name="obs_11_0020"></a><a name="obs_11_0020"></a>
|
|
|
|
<h1 class="topictitle1">Deleting a Multipart Upload Task</h1>
|
|
<div id="body1542440101580"><div class="section" id="obs_11_0020__section1479112110815"><h4 class="sectiontitle">Function</h4><ul id="obs_11_0020__ul61984520588"><li id="obs_11_0020__li12198352584">You can use this command to delete a multipart upload task in a specified bucket by using the multipart upload ID.</li><li id="obs_11_0020__li91980516581">You can also use this command to delete multipart upload tasks in batches based on a specified object name prefix.</li></ul>
|
|
</div>
|
|
<div class="section" id="obs_11_0020__section1220752192216"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0020__ul3951713145815"><li id="obs_11_0020__li119511113105810">In Windows<ul id="obs_11_0020__ul193328254584"><li id="obs_11_0020__li18441223155818">Deleting a single multipart upload task<pre class="screen" id="obs_11_0020__screen3547465593">obsutil abort obs://bucket/key -u=xxx [-f] [-fr] [-o=xxx] [-config=xxx] </pre>
|
|
</li><li id="obs_11_0020__li20491337155820">Deleting multipart upload tasks in batches<pre class="screen" id="obs_11_0020__screen9940161019596">obsutil abort obs://bucket[/key] -r [-f] [-o=xxx] [-j=1] [-config=xxx] </pre>
|
|
</li></ul>
|
|
</li><li id="obs_11_0020__li14461418135812">In Linux or macOS<ul id="obs_11_0020__ul105417065911"><li id="obs_11_0020__li59871095914">Deleting a single multipart upload task<pre class="screen" id="obs_11_0020__screen1754563812598">./obsutil abort obs://bucket/key -u=xxx [-f] [-fr] [-o=xxx] [-config=xxx] </pre>
|
|
</li><li id="obs_11_0020__li149897015598">Deleting multipart upload tasks in batches<pre class="screen" id="obs_11_0020__screen17222141813595">./obsutil abort obs://bucket[/key] -r [-f] [-o=xxx] [-j=1] [-config=xxx] </pre>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="obs_11_0020__section173791391418"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0020__ul838053915412"><li id="obs_11_0020__li73801039104117">Take the Windows OS as an example. Run the <strong id="obs_11_0020__b457411313143">obsutil abort obs://bucket-test/key -u=xxx -f</strong> command to delete a single multipart upload task.<pre class="screen" id="obs_11_0020__screen9380539124119"><strong id="obs_11_0020__b338023924119">obsutil abort obs://bucket-test/key -u=xxx -f</strong>
|
|
|
|
Start at 2024-10-08 01:25:55.6771288 +0000 UTC
|
|
|
|
[--------------------------------------------------] 100.00% tps:0.00 1/1 106ms
|
|
Succeed count: 1 Failed count: 0
|
|
Metrics [max cost:54 ms, min cost:54 ms, average cost:54.00 ms, average tps:8.77]
|
|
|
|
Task id: 4972589c-c775-41be-a288-bbee3edaaee9</pre>
|
|
</li></ul>
|
|
<ul id="obs_11_0020__ul18380163916417"><li id="obs_11_0020__li0380639184111">Take the Windows OS as an example. Run the <strong id="obs_11_0020__b153291461773">obsutil abort obs://bucket-test -r -f</strong> command to delete all multipart upload tasks in the bucket in batches.<pre class="screen" id="obs_11_0020__screen1538013912413"><strong id="obs_11_0020__b14380163916412">obsutil abort obs://bucket-test -r -f</strong>
|
|
Start at 2024-10-08 01:28:29.1980739 +0000 UTC
|
|
|
|
[-----------------------------------------------] 100.00% tps:2924.55 3/3 202ms
|
|
Succeed count: 3 Failed count: 0
|
|
Metrics [max cost:148 ms, min cost:61 ms, average cost:113.33 ms, average tps:14.63]
|
|
|
|
Task id: cd2fd08e-fc31-47d9-b4b0-9f9a3376435f</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="obs_11_0020__section6559191102418"><h4 class="sectiontitle">Parameter Description</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_11_0020__table10831182114445" frame="border" border="1" rules="all"><thead align="left"><tr id="obs_11_0020__row683212154419"><th align="left" class="cellrowborder" valign="top" width="17%" id="mcps1.3.4.2.1.4.1.1"><p id="obs_11_0020__p118329219446">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="28.000000000000004%" id="mcps1.3.4.2.1.4.1.2"><p id="obs_11_0020__p15137125919108">Optional or Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="55.00000000000001%" id="mcps1.3.4.2.1.4.1.3"><p id="obs_11_0020__p12832121184414">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="obs_11_0020__row108328217449"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0020__p64495172515">bucket</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0020__p154316502519">Mandatory</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0020__p17425512259">The bucket name</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0020__row20647122314615"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0020__p864719233464">key</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0020__p52017286567">Mandatory for deleting a multipart upload task.</p>
|
|
<p id="obs_11_0020__p741812412475">Optional for deleting multipart upload tasks in batches.</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0020__p1864718233461">The object name involved in a multipart upload task to be deleted, or the name prefix of the objects involved in multipart upload tasks to be deleted in batches</p>
|
|
<div class="note" id="obs_11_0020__note7180183222110"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0020__p81802321215">If this parameter is left blank when deleting multipart upload tasks in batches, all multipart upload tasks in the bucket are deleted.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0020__row15278410149"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0020__p152884115145">u</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0020__p12874171412">Mandatory for deleting a single multipart upload task (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0020__p63113823">The ID of the multipart upload task to be deleted</p>
|
|
<div class="note" id="obs_11_0020__note1295362512190"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0020__p2953162521914">You can obtain the value of this parameter from <a href="obs_11_0019.html">Listing Multipart Upload Tasks</a>.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0020__row135170431481"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0020__p8517143114816">fr</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0020__p1965455113483">Optional for deleting a single multipart upload task (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0020__p1951718433487">Generates an operation result file when deleting a multipart upload task.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0020__row536914065314"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0020__p9369940145311">f</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0020__p1272453612483">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0020__p972417362487">Runs in force mode.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0020__row1215934213533"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0020__p71594425537">r</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0020__p1273555018488">Mandatory for deleting multipart upload tasks (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0020__p1173519509481">Deletes multipart upload tasks in batches based on a specified object name prefix.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0020__row616420205485"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0020__p187441222114815">j</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0020__p17745112212488">Optional for deleting multipart upload tasks (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0020__p47481922194811">The maximum number of concurrent tasks for deleting multipart uploads in batches. The default value is the value of <strong id="obs_11_0020__b16444613907">defaultJobs</strong> in the configuration file.</p>
|
|
<div class="note" id="obs_11_0020__note891964620819"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0020__p1091964618820">The value is ensured to be greater than or equal to 1.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0020__row11857124714532"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0020__p138574472533">o</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0020__p7281628155011">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0020__p4924117181112">The folder that stores the result files. After the command is executed, result files (possibly success and failure files) will be created in the specified folder. The default value is <strong id="obs_11_0020__b1282711418120">.obsutil_output</strong>, a subfolder in the user's home directory where obsutil commands are executed.</p>
|
|
<div class="note" id="obs_11_0020__note351244972418"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="obs_11_0020__ul101190347408"><li id="obs_11_0020__li111993418408">A result file should be named as follows: <strong id="obs_11_0020__b1994120441411">abort_{succeed | failed}_report_</strong><em id="obs_11_0020__i109451441842">time</em><strong id="obs_11_0020__b16948194419413">_TaskId.txt</strong>.</li><li id="obs_11_0020__li412103664016">By default, the maximum size of a single result file is 30 MB and the maximum number of result files that can be retained is 1,024. You can set the maximum size and number by configuring <strong id="obs_11_0020__b1683913020464">recordMaxLogSize</strong> and <strong id="obs_11_0020__b1183993014461">recordBackups</strong> in the configuration file.</li></ul>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0020__row81209083710"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0020__p153951131317">config</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0020__p12395135316">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0020__obs_11_0008_p1750111452317">The user-defined configuration file for executing the current command. For details about parameters that can be configured, see <a href="obs_11_0035.html">Configuration Parameters</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0020__row196660615186"><td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0020__p1966666191820">payer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0020__p1266611611820">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0020__p1166617619181">Specifies that requester pays is enabled.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="obs_11_0020__section6926520122416"><h4 class="sectiontitle">Response</h4><p id="obs_11_0020__p21251255183018">Refer to <a href="obs_11_0013.html#obs_11_0013__section6926520122416">Response</a> for uploading an object.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_11_0012.html">Object Commands</a></div>
|
|
</div>
|
|
</div>
|
|
|