youjiageng1/doc-exports
1
0
Fork 0
forked from laiweijian4/doc-exports
Code Pull Requests Activity
doc-exports/docs/obs/api-ref/obs_04_0097.html
zhangyue d84e24d182 OBS API doc 
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com>
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>
2023-03-03 09:35:22 +00:00

425 lines
32 KiB
HTML
Raw Blame History

<a name="obs_04_0097"></a><a name="obs_04_0097"></a>
<h1 class="topictitle1">Listing Initiated Multipart Uploads in a Bucket</h1>
<div id="body12251880"><div class="section" id="obs_04_0097__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0097__p51265933">This operation queries all the multipart upload tasks that are initialized but have not been merged or canceled in a bucket.</p>
</div>
<div class="section" id="obs_04_0097__section58740215"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="obs_04_0097__screen32023046">GET /?uploads&amp;max-uploads=max HTTP/1.1
Host: <em id="obs_04_0097__i123441746202313">bucketname</em>.obs.<em id="obs_04_0097__i034434682311">region</em>.example.com
Date: <em id="obs_04_0097__i48297358">date</em>
Authorization: <em id="obs_04_0097__i19771962">authorization</em></pre>
</div>
<div class="section" id="obs_04_0097__section58899893"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0097__p58025057">This request uses parameters to specify the query range for multipart uploads. <a href="#obs_04_0097__table416285709507">Table 1</a> describes the parameters.</p>
<div class="tablenoborder"><a name="obs_04_0097__table416285709507"></a><a name="table416285709507"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0097__table416285709507" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="obs_04_0097__row57198952"><th align="left" class="cellrowborder" valign="top" width="22.220000000000002%" id="mcps1.3.3.3.2.4.1.1"><p id="obs_04_0097__p2603527">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="62.629999999999995%" id="mcps1.3.3.3.2.4.1.2"><p id="obs_04_0097__p18923573">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.15%" id="mcps1.3.3.3.2.4.1.3"><p id="obs_04_0097__p37967849">Mandatory</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0097__row29709965"><td class="cellrowborder" valign="top" width="22.220000000000002%" headers="mcps1.3.3.3.2.4.1.1 "><p id="obs_04_0097__p57696990">delimiter</p>
</td>
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.3.3.2.4.1.2 "><p id="obs_04_0097__p42944652">For a multipart upload that contains delimiters, the string between the first character and the first delimiter in the object name (excluding the prefix specified in the request, if any) are returned as <strong id="obs_04_0097__b13461129124012">CommonPrefix</strong>. Multipart uploads with objects that contain <strong id="obs_04_0097__b1433216212402">CommonPrefix</strong> are considered as a group and returned as one record. The record contains no information about the tasks, only informing the user that the group involves multipart uploads.</p>
<p id="obs_04_0097__p50957553">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="15.15%" headers="mcps1.3.3.3.2.4.1.3 "><p id="obs_04_0097__p33921141">No</p>
</td>
</tr>
<tr id="obs_04_0097__row36854813"><td class="cellrowborder" valign="top" width="22.220000000000002%" headers="mcps1.3.3.3.2.4.1.1 "><p id="obs_04_0097__p32449872">prefix</p>
</td>
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.3.3.2.4.1.2 "><p id="obs_04_0097__p11193984">If a prefix is specified, the response only contains tasks whose names start with the prefix value.</p>
<p id="obs_04_0097__p33636994">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="15.15%" headers="mcps1.3.3.3.2.4.1.3 "><p id="obs_04_0097__p40241975">No</p>
</td>
</tr>
<tr id="obs_04_0097__row26633461"><td class="cellrowborder" valign="top" width="22.220000000000002%" headers="mcps1.3.3.3.2.4.1.1 "><p id="obs_04_0097__p9826698">max-uploads</p>
</td>
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.3.3.2.4.1.2 "><p id="obs_04_0097__p57765051">Maximum number of multipart upload tasks returned. The value ranges from 1 to 1000. If the value has exceeded this range, 1000 tasks are returned by default.</p>
<p id="obs_04_0097__p50123418">Type: integer</p>
</td>
<td class="cellrowborder" valign="top" width="15.15%" headers="mcps1.3.3.3.2.4.1.3 "><p id="obs_04_0097__p33465090">No</p>
</td>
</tr>
<tr id="obs_04_0097__row32750356"><td class="cellrowborder" valign="top" width="22.220000000000002%" headers="mcps1.3.3.3.2.4.1.1 "><p id="obs_04_0097__p35533195">key-marker</p>
</td>
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.3.3.2.4.1.2 "><p id="obs_04_0097__p59616575">Lists multipart uploads that follow the value of <strong id="obs_04_0097__b1361451504211">key-marker</strong>.</p>
<p id="obs_04_0097__p66787131">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="15.15%" headers="mcps1.3.3.3.2.4.1.3 "><p id="obs_04_0097__p41048532">No</p>
</td>
</tr>
<tr id="obs_04_0097__row33892476"><td class="cellrowborder" valign="top" width="22.220000000000002%" headers="mcps1.3.3.3.2.4.1.1 "><p id="obs_04_0097__p60936021">upload-id-marker</p>
</td>
<td class="cellrowborder" valign="top" width="62.629999999999995%" headers="mcps1.3.3.3.2.4.1.2 "><p id="obs_04_0097__p36870667">Lists multipart tasks that follow the value of <strong id="obs_04_0097__b3611163110427">upload-id-marker</strong> in <strong id="obs_04_0097__b1654143804211">key-marker</strong>. This parameter only functions together with <strong id="obs_04_0097__b1618474812420">key-marker</strong>.</p>
<p id="obs_04_0097__p63400548">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="15.15%" headers="mcps1.3.3.3.2.4.1.3 "><p id="obs_04_0097__p35170735">No</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0097__section60336990"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0097__p30257291">This request uses common headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
</div>
<div class="section" id="obs_04_0097__section6162005"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0097__p45858078">This request involves no elements.</p>
</div>
<div class="section" id="obs_04_0097__section55458050"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0097__screen37538751"><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>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</span>
<span class="normal">18</span>
<span class="normal">19</span>
<span class="normal">20</span>
<span class="normal">21</span>
<span class="normal">22</span>
<span class="normal">23</span>
<span class="normal">24</span>
<span class="normal">25</span>
<span class="normal">26</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
Content-Length:<span class="w"> </span>length
<span class="cp">&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; standalone=&quot;yes&quot;?&gt;</span><span class="w"> </span>
<span class="nt">&lt;ListMultipartUploadsResult</span><span class="w"> </span><span class="na">xmlns=</span><span class="s">&quot;http://obs.region.example.com/doc/2015-06-30/&quot;</span><span class="nt">&gt;</span>
<span class="w"> </span><span class="nt">&lt;Bucket&gt;</span>bucketname<span class="nt">&lt;/Bucket&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;KeyMarker/&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;UploadIdMarker/&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;NextKeyMarker&gt;</span>nextMarker<span class="nt">&lt;/NextKeyMarker&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;NextUploadIdMarker&gt;</span>idMarker<span class="nt">&lt;/NextUploadIdMarker&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;MaxUploads&gt;</span>maxUploads<span class="nt">&lt;/MaxUploads&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;IsTruncated&gt;</span>true<span class="nt">&lt;/IsTruncated&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Upload&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Key&gt;</span>key<span class="nt">&lt;/Key&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;UploadId&gt;</span>uploadID<span class="nt">&lt;/UploadId&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Initiator&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;ID&gt;</span>domainID/domainID:userID/userID<span class="nt">&lt;/ID&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;/Initiator&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Owner&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;ID&gt;</span>ownerID<span class="nt">&lt;/ID&gt;</span>
<span class="w"> </span><span class="nt">&lt;/Owner&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;StorageClass&gt;</span>storageclass<span class="nt">&lt;/StorageClass&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;Initiated&gt;</span>initiatedDate<span class="nt">&lt;/Initiated&gt;</span><span class="w"> </span>
<span class="w"> </span><span class="nt">&lt;/Upload&gt;</span><span class="w"> </span>
<span class="nt">&lt;/ListMultipartUploadsResult&gt;</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0097__section29360406"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0097__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>
<div class="section" id="obs_04_0097__section62917066"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0097__p19941988">This response contains elements of information about the multipart uploads. <a href="#obs_04_0097__table6365698795048">Table 2</a> describes the elements.</p>
<div class="tablenoborder"><a name="obs_04_0097__table6365698795048"></a><a name="table6365698795048"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0097__table6365698795048" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response elements</caption><thead align="left"><tr id="obs_04_0097__row51830180"><th align="left" class="cellrowborder" valign="top" width="32.5%" id="mcps1.3.8.3.2.3.1.1"><p id="obs_04_0097__p37495056">Element</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="67.5%" id="mcps1.3.8.3.2.3.1.2"><p id="obs_04_0097__p20588507">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0097__row13743917"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p39515511">ListMultipartUploadsResult</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p46639813">Container for responses of requests.</p>
<p id="obs_04_0097__p17105137">Type: container</p>
<p id="obs_04_0097__p19728512">Children: Bucket, KeyMarker, UploadIdMarker, NextKeyMarker, NextUploadIdMarker, MaxUploads, Delimiter, Prefix, Upload, CommonPrefixes, IsTruncated</p>
<p id="obs_04_0097__p43338881">Ancestor: none</p>
</td>
</tr>
<tr id="obs_04_0097__row52878683"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p55314891">Bucket</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p51321159">Name of the bucket to which the multipart upload was initiated</p>
<p id="obs_04_0097__p59237254">Type: string</p>
<p id="obs_04_0097__p63373240">Ancestor: ListMultipartUploadsResult</p>
</td>
</tr>
<tr id="obs_04_0097__row28194235"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p2031711">KeyMarker</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p30350866">Object keys at or after which the multipart upload listing begins</p>
<p id="obs_04_0097__p4722346">Type: string</p>
<p id="obs_04_0097__p42501119">Ancestor: ListMultipartUploadsResult</p>
</td>
</tr>
<tr id="obs_04_0097__row46129710"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p45519023">UploadIdMarker</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p63162212">Upload ID after which the multipart upload listing begins</p>
<p id="obs_04_0097__p31588997">Type: string</p>
<p id="obs_04_0097__p15865525">Ancestor: ListMultipartUploadsResult</p>
</td>
</tr>
<tr id="obs_04_0097__row23243756"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p3696068">NextKeyMarker</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p30946068">Value of <strong id="obs_04_0097__b1225211712469">KeyMarker</strong> in a subsequent request after a multipart upload list is truncated</p>
<p id="obs_04_0097__p10079161">Type: string</p>
<p id="obs_04_0097__p23603589">Ancestor: ListMultipartUploadsResult</p>
</td>
</tr>
<tr id="obs_04_0097__row27147574"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p51469871">NextUploadIdMarker</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p8310021">Value of UploadMarker in a subsequent request when a multipart upload list is truncated.</p>
<p id="obs_04_0097__p7681326">Type: string</p>
<p id="obs_04_0097__p2023071">Ancestor: ListMultipartUploadsResult</p>
</td>
</tr>
<tr id="obs_04_0097__row65532821"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p6558281">MaxUploads</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p61458782">Maximum of multipart uploads to be returned in the response</p>
<p id="obs_04_0097__p16258132">Type: integer</p>
<p id="obs_04_0097__p12105468">Ancestor: ListMultipartUploadsResult</p>
</td>
</tr>
<tr id="obs_04_0097__row33625114"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p39279732">IsTruncated</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p27541714">Indicates whether the returned list of multipart uploads is truncated. <strong id="obs_04_0097__b773114255012">true</strong>: Not all results are returned. <strong id="obs_04_0097__b773624210501">false</strong>: All results have been returned.</p>
<p id="obs_04_0097__p46548838">Type: boolean</p>
<p id="obs_04_0097__p16286365">Ancestor: ListMultipartUploadsResult</p>
</td>
</tr>
<tr id="obs_04_0097__row61600159"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p23556952">Upload</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p29064921">Container for elements related to a specific multipart upload</p>
<p id="obs_04_0097__p60257700">Type: container</p>
<p id="obs_04_0097__p5448395">Children: Key, UploadId, InitiatorOwner, StorageClass, Initiated</p>
<p id="obs_04_0097__p49035557">Ancestor: ListMultipartUploadsResult</p>
</td>
</tr>
<tr id="obs_04_0097__row45006112"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p21616468">Key</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p6103447">Indicates the name of the object for which a multipart upload is initiated.</p>
<p id="obs_04_0097__p54931031">Type: string</p>
<p id="obs_04_0097__p24617236">Ancestor: Upload</p>
</td>
</tr>
<tr id="obs_04_0097__row27898619"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p45195660">UploadId</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p36969809">ID of the multipart upload</p>
<p id="obs_04_0097__p64292826">Type: string</p>
<p id="obs_04_0097__p41764530">Ancestor: Upload</p>
</td>
</tr>
<tr id="obs_04_0097__row46027617"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p37249481">Initiator</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p64417961">Container element that identifies who initiated the multipart upload</p>
<p id="obs_04_0097__p42890742">Children: ID</p>
<p id="obs_04_0097__p50472362">Type: container</p>
<p id="obs_04_0097__p51598078">Ancestor: Upload</p>
</td>
</tr>
<tr id="obs_04_0097__row34035501"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p5412224">ID</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p35736979">ID of the account to which the owner belongs.</p>
<p id="obs_04_0097__p53197356">Type: string</p>
<p id="obs_04_0097__p9014158">Ancestor: Initiator or Owner</p>
</td>
</tr>
<tr id="obs_04_0097__row63077189"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p8978684">Owner</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p56184795">Owner of the part.</p>
<p id="obs_04_0097__p35901114">Type: container</p>
<p id="obs_04_0097__p54674571">Children: ID</p>
<p id="obs_04_0097__p22309097">Ancestor: <strong id="obs_04_0097__b18141487">Upload</strong></p>
</td>
</tr>
<tr id="obs_04_0097__row22986877"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p49997710">StorageClass</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p23282704">Indicates the storage class that will be used for storing an object when the multipart is uploaded.</p>
<p id="obs_04_0097__p8217746">Type: string</p>
<p id="obs_04_0097__p6850858">Ancestor: Upload</p>
</td>
</tr>
<tr id="obs_04_0097__row28220082"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p4125329">Initiated</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p65716228">Date and time when the multipart upload was initiated</p>
<p id="obs_04_0097__p54575145">Type: date</p>
<p id="obs_04_0097__p21414260">Ancestor: Upload</p>
</td>
</tr>
<tr id="obs_04_0097__row41739275"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p25438129">ListMultipartUploadsResult.Prefix</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p47222575">Specified prefix in a request.</p>
<p id="obs_04_0097__p22349999">Type: string</p>
<p id="obs_04_0097__p66932270">Ancestor: ListMultipartUploadsResult</p>
</td>
</tr>
<tr id="obs_04_0097__row5481352"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p41336383">Delimiter</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p59912755">Delimiter in a request.</p>
<p id="obs_04_0097__p2343887">Type: string</p>
<p id="obs_04_0097__p21094987">Ancestor: ListMultipartUploadsResult</p>
</td>
</tr>
<tr id="obs_04_0097__row10316146"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p30301525">CommonPrefixes</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p38504440">Indicates group information. If you specify a delimiter in the request, the response contains group information in <strong id="obs_04_0097__b108641153125016">CommonPrefixes</strong>.</p>
<p id="obs_04_0097__p10995641">Type: container</p>
<p id="obs_04_0097__p31851907">Ancestor: ListMultipartUploadsResult</p>
</td>
</tr>
<tr id="obs_04_0097__row373659"><td class="cellrowborder" valign="top" width="32.5%" headers="mcps1.3.8.3.2.3.1.1 "><p id="obs_04_0097__p30266386">CommonPrefixes. Prefix</p>
</td>
<td class="cellrowborder" valign="top" width="67.5%" headers="mcps1.3.8.3.2.3.1.2 "><p id="obs_04_0097__p35658222">Indicates a different prefix in the group information in <strong id="obs_04_0097__b54731934192918">CommonPrefixes</strong>.</p>
<p id="obs_04_0097__p52488550">Type: string</p>
<p id="obs_04_0097__p2634903">Ancestor: <strong id="obs_04_0097__b59960418">CommonPrefixes</strong></p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0097__section29382687"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0097__p40624238">If the value of <strong id="obs_04_0097__b84235270674044">maxUploads</strong> is a non-integer or smaller than 0, OBS returns <strong id="obs_04_0097__b84235270674138">400 Bad Request</strong>.</p>
<p class="msonormal" id="obs_04_0097__p30073825">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_0097__section8651130153911"><h4 class="sectiontitle">Sample Request 1</h4><p id="obs_04_0097__p4978114417264"><strong id="obs_04_0097__b115482562305">List the initialized multipart tasks without any parameter</strong>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0097__screen250717511394"><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>GET<span class="w"> </span>/?uploads<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>04:51:21<span class="w"> </span>GMT
Authorization:<span class="w"> </span>OBS<span class="w"> </span>UDSIAMSTUBTEST000008:XdmZgYQ+ZVy1rjxJ9/KpKq+wrU0=
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0097__section6321192184111"><h4 class="sectiontitle">Sample Response 1</h4><div class="codecoloring" codetype="Xml" id="obs_04_0097__screen19381122174118"><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>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</span>
<span class="normal">18</span>
<span class="normal">19</span>
<span class="normal">20</span>
<span class="normal">21</span>
<span class="normal">22</span>
<span class="normal">23</span>
<span class="normal">24</span>
<span class="normal">25</span>
<span class="normal">26</span>
<span class="normal">27</span>
<span class="normal">28</span>
<span class="normal">29</span>
<span class="normal">30</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>8DF400000163D405534D046A2295674C
x-obs-id-2:<span class="w"> </span>32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSDaHP+a+Bp0RI6Mm9XvCOrf7q3qvBQW
Content-Type:<span class="w"> </span>application/xml
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>04:51:21<span class="w"> </span>GMT
Content-Length:<span class="w"> </span>681
<span class="cp">&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; standalone=&quot;yes&quot;?&gt;</span>
<span class="nt">&lt;ListMultipartUploadsResult</span><span class="w"> </span><span class="na">xmlns=</span><span class="s">&quot;http://obs.example.com/doc/2015-06-30/&quot;</span><span class="nt">&gt;</span>
<span class="w"> </span><span class="nt">&lt;Bucket&gt;</span>examplebucket<span class="nt">&lt;/Bucket&gt;</span>
<span class="w"> </span><span class="nt">&lt;KeyMarker/&gt;</span>
<span class="w"> </span><span class="nt">&lt;UploadIdMarker/&gt;</span>
<span class="w"> </span><span class="nt">&lt;Delimiter/&gt;</span>
<span class="w"> </span><span class="nt">&lt;Prefix/&gt;</span>
<span class="w"> </span><span class="nt">&lt;MaxUploads&gt;</span>1000<span class="nt">&lt;/MaxUploads&gt;</span>
<span class="w"> </span><span class="nt">&lt;IsTruncated&gt;</span>false<span class="nt">&lt;/IsTruncated&gt;</span>
<span class="w"> </span><span class="nt">&lt;Upload&gt;</span>
<span class="w"> </span><span class="nt">&lt;Key&gt;</span>obj2<span class="nt">&lt;/Key&gt;</span>
<span class="w"> </span><span class="nt">&lt;UploadId&gt;</span>00000163D40171ED8DF4050919BD02B8<span class="nt">&lt;/UploadId&gt;</span>
<span class="w"> </span><span class="nt">&lt;Initiator&gt;</span>
<span class="w"> </span><span class="nt">&lt;ID&gt;</span>domainID/b4bf1b36d9ca43d984fbcb9491b6fce9:userID/71f390117351534r88115ea2c26d1999<span class="nt">&lt;/ID&gt;</span>
<span class="w"> </span><span class="nt">&lt;/Initiator&gt;</span>
<span class="w"> </span><span class="nt">&lt;Owner&gt;</span>
<span class="w"> </span><span class="nt">&lt;ID&gt;</span>b4bf1b36d9ca43d984fbcb9491b6fce9<span class="nt">&lt;/ID&gt;</span>
<span class="w"> </span><span class="nt">&lt;/Owner&gt;</span>
<span class="w"> </span><span class="nt">&lt;StorageClass&gt;</span>STANDARD<span class="nt">&lt;/StorageClass&gt;</span>
<span class="w"> </span><span class="nt">&lt;Initiated&gt;</span>2015-07-01T02:30:54.582Z<span class="nt">&lt;/Initiated&gt;</span>
<span class="w"> </span><span class="nt">&lt;/Upload&gt;</span>
<span class="nt">&lt;/ListMultipartUploadsResult&gt;</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0097__section32871958184516"><h4 class="sectiontitle">Sample Request 2</h4><p id="obs_04_0097__p149319344297"><strong id="obs_04_0097__b181041628183112">List the initialized multipart tasks with the prefix and delimiter</strong>.</p>
<p id="obs_04_0097__p1259795115464">The following example describes how to list two initiated multipart uploads (with objects <strong id="obs_04_0097__b17891201620301">multipart-object001</strong> and <strong id="obs_04_0097__b4515101963013">part2-key02</strong> in bucket <strong id="obs_04_0097__b974332983019">examplebucket</strong>. In this listing operation, <strong id="obs_04_0097__b198393173015">prefix</strong> is set to <strong id="obs_04_0097__b1496733811304">multipart</strong> and <strong id="obs_04_0097__b10903124319307">object001</strong> is set to <strong id="obs_04_0097__b66534481307">delimiter</strong>.</p>
<pre class="screen" id="obs_04_0097__screen65372308460">GET /?uploads&amp;delimiter=object001&amp;prefix=multipart HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.<em id="obs_04_0097__i16622171212817">region</em>.example.com
Accept: */*
Date: WED, 01 Jul 2015 04:51:21 GMT
Authorization: OBS UDSIAMSTUBTEST000008:XdmZgYQ+ZVy1rjxJ9/KpKq+wrU0=</pre>
</div>
<div class="section" id="obs_04_0097__section3921182910539"><h4 class="sectiontitle">Sample Response 2</h4><div class="codecoloring" codetype="Xml" id="obs_04_0097__screen39681829165318"><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>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</span>
<span class="normal">18</span>
<span class="normal">19</span>
<span class="normal">20</span>
<span class="normal">21</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>5DEB00000164A27A1610B8250790D703
x-obs-id-2:<span class="w"> </span>32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSq3ls2ZtLDD6pQLcJq1yGITXgspSvBR
Content-Type:<span class="w"> </span>application/xml
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>04:51:21<span class="w"> </span>GMT
Content-Length:<span class="w"> </span>681
<span class="cp">&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; standalone=&quot;yes&quot;?&gt;</span>
<span class="nt">&lt;ListMultipartUploadsResult</span><span class="w"> </span><span class="na">xmlns=</span><span class="s">&quot;http://obs.example.com/doc/2015-06-30/&quot;</span><span class="nt">&gt;</span>
<span class="w"> </span><span class="nt">&lt;Bucket&gt;</span>newbucket0001<span class="nt">&lt;/Bucket&gt;</span>
<span class="w"> </span><span class="nt">&lt;KeyMarker&gt;&lt;/KeyMarker&gt;</span>
<span class="w"> </span><span class="nt">&lt;UploadIdMarker&gt;</span>
<span class="w"> </span><span class="nt">&lt;/UploadIdMarker&gt;</span>
<span class="w"> </span><span class="nt">&lt;Delimiter&gt;</span>object<span class="nt">&lt;/Delimiter&gt;</span>
<span class="w"> </span><span class="nt">&lt;Prefix&gt;</span>multipart<span class="nt">&lt;/Prefix&gt;</span>
<span class="w"> </span><span class="nt">&lt;MaxUploads&gt;</span>1000<span class="nt">&lt;/MaxUploads&gt;</span>
<span class="w"> </span><span class="nt">&lt;IsTruncated&gt;</span>false<span class="nt">&lt;/IsTruncated&gt;</span>
<span class="w"> </span><span class="nt">&lt;CommonPrefixes&gt;</span>
<span class="w"> </span><span class="nt">&lt;Prefix&gt;</span>multipart-object001<span class="nt">&lt;/Prefix&gt;</span>
<span class="w"> </span><span class="nt">&lt;/CommonPrefixes&gt;</span>
<span class="nt">&lt;/ListMultipartUploadsResult&gt;</span>
</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