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>
145 lines
12 KiB
HTML
145 lines
12 KiB
HTML
<a name="obs_11_0019"></a><a name="obs_11_0019"></a>
|
|
|
|
<h1 class="topictitle1">Listing Multipart Upload Tasks</h1>
|
|
<div id="body1543218301375"><div class="section" id="obs_11_0019__section12810504216"><h4 class="sectiontitle">Function</h4><p id="obs_11_0019__p9999175242119">You can use this command to query multipart upload tasks in a bucket.</p>
|
|
</div>
|
|
<div class="section" id="obs_11_0019__section315294314215"><h4 class="sectiontitle">Command Line Structure</h4><ul id="obs_11_0019__ul58796448547"><li id="obs_11_0019__li0879164435415">In Windows<pre class="screen" id="obs_11_0019__screen446719211557">obsutil ls obs://bucket[/prefix] [-s] [-d] -m [-a] [-uploadIdMarker=xxx] [-marker=xxx] [-limit=1] [-config=xxx] </pre>
|
|
</li><li id="obs_11_0019__li5449164865411">In Linux or macOS<pre class="screen" id="obs_11_0019__screen1717420915512">./obsutil ls obs://bucket[/prefix] [-s] [-d] -m [-a] [-uploadIdMarker=xxx] [-marker=xxx] [-limit=1] [-config=xxx] </pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="obs_11_0019__section69087220415"><h4 class="sectiontitle">Examples</h4><ul id="obs_11_0019__ul1690813221410"><li id="obs_11_0019__li7908182213412">Take the Windows OS as an example. Run the <strong id="obs_11_0019__b1749332852013">obsutil ls obs://bucket-test -m -limit=10</strong> command to query the multipart upload tasks in the bucket.<pre class="screen" id="obs_11_0019__screen13908182217418"><strong id="obs_11_0019__b139081122144120">obsutil ls obs://bucket-test -m -limit=10</strong>
|
|
|
|
Listing multipart uploads.
|
|
|
|
Upload list:
|
|
Key Initiated
|
|
StorageClass UploadId
|
|
obs://bucket-test/aaa 2018-11-27T03:49:07Z
|
|
standard 000001675348ED21860C3F61EF955BD3
|
|
|
|
obs://bucket-test/dir1/10GB.txt 2018-11-07T06:58:09Z
|
|
standard 00000166ECF6CF7C860D1DBAF3F76013
|
|
|
|
obs://bucket-test/dir1/1GB.txt 2018-11-07T06:58:09Z
|
|
standard 00000166ECF6CF6F860B7FBE95D01B03
|
|
|
|
obs://bucket-test/dir1/50GB.txt 2018-11-07T06:58:09Z
|
|
standard 00000166ECF6CF86860D1DC2C8E8F66B
|
|
|
|
obs://bucket-test/dir1/5GB.txt 2018-11-07T06:58:09Z
|
|
standard 00000166ECF6CF75860CDA7780CB52C3
|
|
|
|
obs://bucket-test/test11/20GB.txt 2018-11-27T08:21:26Z
|
|
standard 0000016754423D24860CA8A4D06C2054
|
|
|
|
Folder number: 0
|
|
Upload number: 6</pre>
|
|
</li></ul>
|
|
<ul id="obs_11_0019__ul10909152219416"><li id="obs_11_0019__li129091922114113">For more examples, see <a href="obs_11_0027.html">Common Examples</a>.</li></ul>
|
|
</div>
|
|
<div class="section" id="obs_11_0019__section358316614229"><h4 class="sectiontitle">Parameter Description</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_11_0019__table11357111919227" frame="border" border="1" rules="all"><thead align="left"><tr id="obs_11_0019__row19450419112217"><th align="left" class="cellrowborder" valign="top" width="18.181818181818183%" id="mcps1.3.4.2.1.4.1.1"><p id="obs_11_0019__p9450619132218">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25.252525252525253%" id="mcps1.3.4.2.1.4.1.2"><p id="obs_11_0019__p1045051914221">Optional or Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="56.565656565656575%" id="mcps1.3.4.2.1.4.1.3"><p id="obs_11_0019__p34505193226">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="obs_11_0019__row1145014197226"><td class="cellrowborder" valign="top" width="18.181818181818183%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0019__p4450141912217">bucket</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0019__p19450219142210">Mandatory</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.565656565656575%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0019__p18452619122215">The bucket name</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0019__row745261918223"><td class="cellrowborder" valign="top" width="18.181818181818183%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0019__p345261932219">prefix</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0019__p345211982219">Optional</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.565656565656575%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0019__p1445231992218">The object name prefix for listing multipart uploads</p>
|
|
<div class="note" id="obs_11_0019__note172548512206"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0019__p7254145112017">If this parameter is left blank, all multipart upload tasks in the bucket are listed.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0019__row1845231962214"><td class="cellrowborder" valign="top" width="18.181818181818183%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0019__p14452919202212">s</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0019__p9452161922213">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.565656565656575%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0019__p12452161914224">Displays simplified query result.</p>
|
|
<div class="note" id="obs_11_0019__note1452085114212"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0019__p252035122111">In the simplified format, the returned result contains only the object name and upload ID of the multipart upload.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0019__row14452219102219"><td class="cellrowborder" valign="top" width="18.181818181818183%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0019__p1345291912217">d</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0019__p245215195224">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.565656565656575%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0019__p1445218197221">Lists only the multipart upload tasks and sub-directories in the current directory are listed, instead of recursively listing all the multipart upload tasks and sub-directories.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0019__row154291518173013"><td class="cellrowborder" valign="top" width="18.181818181818183%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0019__p1645215197222">m</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0019__p18452019162217">Mandatory (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.565656565656575%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0019__p745214195227">Lists multipart upload tasks in the bucket.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0019__row87391618304"><td class="cellrowborder" valign="top" width="18.181818181818183%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0019__p19452121932218">a</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0019__p0452141914224">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.565656565656575%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0019__p114521319172214">Lists the objects and the multipart upload tasks in the bucket.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0019__row127451045183012"><td class="cellrowborder" valign="top" width="18.181818181818183%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0019__p17557916141117">marker</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0019__p1155818161117">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.565656565656575%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0019__p5558816151116">The start position for listing multipart upload tasks in a bucket. The multipart upload tasks following this start position are sorted in lexicographical order by object name.</p>
|
|
<div class="note" id="obs_11_0019__note14528254193716"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0019__p252885413370">For details about how to use this parameter, see <a href="obs_11_0032.html">Listing Multipart Upload Tasks</a>.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0019__row6215919119"><td class="cellrowborder" valign="top" width="18.181818181818183%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0019__p118791410119">uploadIdMarker</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0019__p1189914161120">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.565656565656575%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0019__p1190101461115">The start position for listing multipart upload tasks in a bucket. This parameter must be used together with <strong id="obs_11_0019__b11400330113014">marker</strong>. The multipart upload tasks following this start position are sorted in lexicographical order by object name and upload ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0019__row1256251542913"><td class="cellrowborder" valign="top" width="18.181818181818183%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0019__p29791221132910">limit</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0019__p119801421162916">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.565656565656575%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0019__p1298142132912">The maximum number of objects that can be listed. If the value is less than or equal to <strong id="obs_11_0019__b13187171310819">0</strong>, all objects are listed.</p>
|
|
<div class="note" id="obs_11_0019__note11900183831617"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="obs_11_0019__p17979111612385">If there are a large number of multipart upload tasks in a bucket, you are advised to set this parameter to limit the number of multipart upload tasks each time. If not all tasks are listed, <strong id="obs_11_0019__b264333592411">marker</strong> and <strong id="obs_11_0019__b1694848122418">uploadIdMarker</strong> of the next request will be returned in the result, which you can use to list the remaining tasks.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_11_0019__row1643849183617"><td class="cellrowborder" valign="top" width="18.181818181818183%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0019__p153951131317">config</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0019__p12395135316">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.565656565656575%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0019__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_0019__row7111140279"><td class="cellrowborder" valign="top" width="18.181818181818183%" headers="mcps1.3.4.2.1.4.1.1 "><p id="obs_11_0019__p1966666191820">payer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.4.2.1.4.1.2 "><p id="obs_11_0019__p1266611611820">Optional (additional parameter)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.565656565656575%" headers="mcps1.3.4.2.1.4.1.3 "><p id="obs_11_0019__p1166617619181">Specifies that requester pays is enabled.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</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>
|
|
|