vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/obs/s3api/en-us_topic_0125560292.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

397 lines
32 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0125560292"></a><a name="EN-US_TOPIC_0125560292"></a>
<h1 class="topictitle1">List Multipart Uploads</h1>
<div id="body47965129"><p class="msonormal" id="EN-US_TOPIC_0125560292__p33113919">You can use this operation to query all in-progress multipart uploads that have been initiated but not been combined or aborted.</p>
<div class="section" id="EN-US_TOPIC_0125560292__section56778103"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560292__screen52955475112113">GET /?uploads&amp;max-uploads=max HTTP/1.1
User-Agent: agent
Host: bucketname.obs.example.com
Accept: */*
Date: Mon, 1 Nov 2010 20:34:56 GMT
Authorization: auth</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560292__section41240880"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0125560292__p40433035">This request uses parameters to specify the query range for multipart uploads. <a href="#EN-US_TOPIC_0125560292__table25002124">Table 1</a> describes the parameters.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560292__table25002124"></a><a name="table25002124"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560292__table25002124" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0125560292__row20781721"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.3.2.4.1.1"><p id="EN-US_TOPIC_0125560292__p5597801">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.3.2.4.1.2"><p id="EN-US_TOPIC_0125560292__p50768709">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.3.2.4.1.3"><p id="EN-US_TOPIC_0125560292__p18624790">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560292__row33405390"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p21482089">delimiter</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p62327661">Character used to group object keys.</p>
<p id="EN-US_TOPIC_0125560292__p24078037">All keys that contain the same string between <strong id="EN-US_TOPIC_0125560292__b15375744">prefix</strong>, if specified, and the first occurrence of the delimiter after <strong id="EN-US_TOPIC_0125560292__b4163976">prefix</strong> are grouped under a single result element <strong id="EN-US_TOPIC_0125560292__b37475789">CommonPrefixes</strong>. <strong id="EN-US_TOPIC_0125560292__b1737784">CommonPrefix</strong> contains no information about any multipart upload. It is only used for informing users of the following: multipart uploads are contained in this group.</p>
<p id="EN-US_TOPIC_0125560292__p15640058">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p58885167">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row60204461"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p44723138">prefix</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p65804403">Lists in-progress uploads only for those object keys that begin with the specified prefix.</p>
<p id="EN-US_TOPIC_0125560292__p55368722">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p55681530">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row31371724"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p58081731">max-uploads</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p6999799">Sets the maximum number (ranging from 1 to 1000) of multipart uploads to be returned in the response body. If the value is not in this range, 1000 is returned by default.</p>
<p id="EN-US_TOPIC_0125560292__p62998195">Type: Integer</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p2580172">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row23221556"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p1897869">key-marker</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p19509699">Indicates the multipart upload after which the listing begins.</p>
<p id="EN-US_TOPIC_0125560292__p41369564">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p62600359">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row26532323"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p1634591">upload-id-marker</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p65293014">Indicates the multipart upload after which the listing begins. This parameter is used together with <strong id="EN-US_TOPIC_0125560292__b50766220">key-marker</strong>.</p>
<p id="EN-US_TOPIC_0125560292__p54242802">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p31590875">Optional</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560292__section35623602"><h4 class="sectiontitle">Request Headers</h4><p id="EN-US_TOPIC_0125560292__p11407934">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_0125560292__section52176966"><h4 class="sectiontitle">Request Elements</h4><p id="EN-US_TOPIC_0125560292__p21074804">This request involves no elements.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560292__section32948183"><h4 class="sectiontitle">Response Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560292__screen59032484112150">HTTP/1.1 status_code
Server: OBS
x-amz-request-id: request id
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
x-amz-id-2: id2
Content-Length: length
Date: date
Connection: connect state
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;ListMultipartUploadsResult xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;Bucket&gt;bucket&lt;/Bucket&gt;
&lt;KeyMarker&gt;&lt;/KeyMarker&gt;
&lt;UploadIdMarker&gt;&lt;/UploadIdMarker&gt;
&lt;NextKeyMarker&gt;nextMarker&lt;/NextKeyMarker&gt;
&lt;NextUploadIdMarker&gt;idMarker&lt;/NextUploadIdMarker&gt;
&lt;Delimiter&gt;&lt;/Delimiter&gt;
&lt;Prefix&gt;&lt;/Prefix&gt;
&lt;MaxUploads&gt;maxUploads&lt;/MaxUploads&gt;
&lt;IsTruncated&gt;true&lt;/IsTruncated&gt;
&lt;Upload&gt;
&lt;Key&gt;key&lt;/Key&gt;
&lt;UploadId&gt;uploadID&lt;/UploadId&gt;
&lt;Initiator&gt;
&lt;ID&gt;id&lt;/ID&gt;
&lt;DisplayName&gt;name&lt;/DisplayName&gt;
&lt;/Initiator&gt;
&lt;Owner&gt;
&lt;ID&gt;ownerID&lt;/ID&gt;
&lt;DisplayName&gt;OwnerDisplayName&lt;/DisplayName&gt;
&lt;/Owner&gt;
&lt;StorageClass&gt;STANDARD&lt;/StorageClass&gt;
&lt;Initiated&gt;initiatedDate&lt;/Initiated&gt;
&lt;/Upload&gt;
&lt;/ListMultipartUploadsResult&gt;</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560292__section28098193"><h4 class="sectiontitle">Response Headers</h4><p id="EN-US_TOPIC_0125560292__p63500868">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_0125560292__section51557149"><h4 class="sectiontitle">Response Elements</h4><p id="EN-US_TOPIC_0125560292__p17367658">This response contains elements to provide details about the listed multipart uploads. <a href="#EN-US_TOPIC_0125560292__table36296664">Table 2</a> describes the elements.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560292__table36296664"></a><a name="table36296664"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560292__table36296664" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response elements</caption><thead align="left"><tr id="EN-US_TOPIC_0125560292__row62252322"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.8.3.2.4.1.1"><p id="EN-US_TOPIC_0125560292__p9273323">Element</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.8.3.2.4.1.2"><p id="EN-US_TOPIC_0125560292__p12941733">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.8.3.2.4.1.3"><p id="EN-US_TOPIC_0125560292__p41647480">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560292__row39283002"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p27806564">ListMultipartUploads Result</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p37739194">Container for the response</p>
<p id="EN-US_TOPIC_0125560292__p4108434">Type: Container</p>
<p id="EN-US_TOPIC_0125560292__p36975910">Children: <strong id="EN-US_TOPIC_0125560292__b64347734">Bucket</strong>, <strong id="EN-US_TOPIC_0125560292__b42258701">KeyMarker</strong>, <strong id="EN-US_TOPIC_0125560292__b44783995">UploadIdMarker</strong>, <strong id="EN-US_TOPIC_0125560292__b402777">NextKeyMarker</strong>, <strong id="EN-US_TOPIC_0125560292__b3625001">NextUploadIdMarker</strong>, <strong id="EN-US_TOPIC_0125560292__b32625010">Delimiter</strong>, <strong id="EN-US_TOPIC_0125560292__b25189639">Prefix</strong>, <strong id="EN-US_TOPIC_0125560292__b25380159">MaxUploads</strong>, <strong id="EN-US_TOPIC_0125560292__b27094845">IsTruncated</strong>, <strong id="EN-US_TOPIC_0125560292__b42527017">Upload</strong>, and <strong id="EN-US_TOPIC_0125560292__b47198836">CommonPrefixes</strong></p>
<p id="EN-US_TOPIC_0125560292__p22136343">Ancestor: None</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p48213362">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row31267075"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p49605164">Bucket</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p58595317">Name of the bucket to which the multipart upload was initiated</p>
<p id="EN-US_TOPIC_0125560292__p57595805">Type: String</p>
<p id="EN-US_TOPIC_0125560292__p48600198">Ancestor: <strong id="EN-US_TOPIC_0125560292__b34748601">ListMultipartUploadsResult</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p63173322">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row31688994"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p16671741">KeyMarker</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p8233793">Object keys at or after which the multipart upload listing begins</p>
<p id="EN-US_TOPIC_0125560292__p6995273">Type: String</p>
<p id="EN-US_TOPIC_0125560292__p62957460">Ancestor: <strong id="EN-US_TOPIC_0125560292__b29746236">ListMultipartUploadsResult</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p60634924">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row8843406"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p45227267">UploadIdMarker</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p39530025">Upload ID after which the multipart upload listing begins</p>
<p id="EN-US_TOPIC_0125560292__p20225910">Type: String</p>
<p id="EN-US_TOPIC_0125560292__p47815463">Ancestor: <strong id="EN-US_TOPIC_0125560292__b27685991">ListMultipartUploadsResult</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p27972830">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row50428878"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p58207302">NextKeyMarker</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p17170998">Value of <strong id="EN-US_TOPIC_0125560292__b20321259">KeyMarker</strong> in a subsequent request after a multipart upload list is truncated</p>
<p id="EN-US_TOPIC_0125560292__p48673607">Type: String</p>
<p id="EN-US_TOPIC_0125560292__p35409283">Ancestor: <strong id="EN-US_TOPIC_0125560292__b50248096">ListMultipartUploadsResult</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p43564010">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row56531777"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p15671223">NextUploadIdMarker</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p61409521">Value of <strong id="EN-US_TOPIC_0125560292__b15814779">UploadMarker</strong> in a subsequent request after a multipart upload list is truncated</p>
<p id="EN-US_TOPIC_0125560292__p8115287">Type: String</p>
<p id="EN-US_TOPIC_0125560292__p5928727">Ancestor: <strong id="EN-US_TOPIC_0125560292__b53358547">ListMultipartUploadsResult</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p27075018">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row42348576"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p7682654">MaxUploads</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p18315212">Maximum of multipart uploads to be returned in the response</p>
<p id="EN-US_TOPIC_0125560292__p30619180">Type: Integer</p>
<p id="EN-US_TOPIC_0125560292__p7137170">Ancestor: <strong id="EN-US_TOPIC_0125560292__b64234534">ListMultipartUploadsResult</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p35614756">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row52097352"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p59136008">IsTruncated</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p25287361">Indicates whether the returned list of multipart uploads is truncated. <strong id="EN-US_TOPIC_0125560292__b26259658">true</strong> indicates that the list was truncated and <strong id="EN-US_TOPIC_0125560292__b35010330">false</strong> indicates that the list was not truncated.</p>
<p id="EN-US_TOPIC_0125560292__p46657514">Type: Boolean</p>
<p id="EN-US_TOPIC_0125560292__p17264443">Ancestor: <strong id="EN-US_TOPIC_0125560292__b21162262">ListMultipartUploadsResult</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p36421687">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row59359735"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p43409250">Upload</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p26488374">Container for elements related to a specific multipart upload</p>
<p id="EN-US_TOPIC_0125560292__p37068774">Type: Container</p>
<p id="EN-US_TOPIC_0125560292__p65183513">Children: <strong id="EN-US_TOPIC_0125560292__b49780713">Key</strong>, <strong id="EN-US_TOPIC_0125560292__b45373238">UploadId</strong>, <strong id="EN-US_TOPIC_0125560292__b5705961">InitiatorOwner</strong>, <strong id="EN-US_TOPIC_0125560292__b51353651">StorageClass</strong>, <strong id="EN-US_TOPIC_0125560292__b59529677">Initiated</strong></p>
<p id="EN-US_TOPIC_0125560292__p66005048">Ancestor: <strong id="EN-US_TOPIC_0125560292__b57174526">ListMultipartUploadsResult</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p624995">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row5624956"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p52968331">Key</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p62576451">Key of the object for which the multipart upload was initiated</p>
<p id="EN-US_TOPIC_0125560292__p26317149">Type: String</p>
<p id="EN-US_TOPIC_0125560292__p35527755">Ancestor: <strong id="EN-US_TOPIC_0125560292__b51314340">Upload</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p62820904">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row28517228"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p28194133">UploadId</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p2023471">ID of the multipart upload</p>
<p id="EN-US_TOPIC_0125560292__p18211246">Type: String</p>
<p id="EN-US_TOPIC_0125560292__p29683490">Ancestor: <strong id="EN-US_TOPIC_0125560292__b65824820">Upload</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p30210174">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row3456112"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p11509660">Initiator</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p59867264">Container element that identifies who initiated the multipart upload</p>
<p id="EN-US_TOPIC_0125560292__p1934471">Children: <strong id="EN-US_TOPIC_0125560292__b17410245">ID</strong>, <strong id="EN-US_TOPIC_0125560292__b22474483">DisplayName</strong></p>
<p id="EN-US_TOPIC_0125560292__p943763">Type: Container</p>
<p id="EN-US_TOPIC_0125560292__p8493868">Ancestor: <strong id="EN-US_TOPIC_0125560292__b9335953">Upload</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p18014695">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row27914531"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p46484529">ID</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p7150508">DomainId of the user.</p>
<p id="EN-US_TOPIC_0125560292__p64354573">Type: String</p>
<p id="EN-US_TOPIC_0125560292__p42320251">Ancestor: <strong id="EN-US_TOPIC_0125560292__b45337942">Initiator</strong>, <strong id="EN-US_TOPIC_0125560292__b5388295">Owner</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p33798711">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row35752944"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p10307346">DisplayName</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p29588684">Initiator name</p>
<p id="EN-US_TOPIC_0125560292__p64971570">Type: String</p>
<p id="EN-US_TOPIC_0125560292__p47873223">Ancestor: <strong id="EN-US_TOPIC_0125560292__b28205828">Initiator</strong>, <strong id="EN-US_TOPIC_0125560292__b52525867">Owner</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p26736798">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row39304598"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p29555878">Owner</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p45215898">Container element that identifies the object owner. This element is the same as <strong id="EN-US_TOPIC_0125560292__b4289901">Initiator</strong> and compatible with Amazon S3. In S3, if a multipart upload is initiated by an IAM user, <strong id="EN-US_TOPIC_0125560292__b38609115">Initiator</strong> may differ from <strong id="EN-US_TOPIC_0125560292__b11937715">Owner</strong>.</p>
<p id="EN-US_TOPIC_0125560292__p40330576">Type: Container</p>
<p id="EN-US_TOPIC_0125560292__p27430865">Children: <strong id="EN-US_TOPIC_0125560292__b45551201">ID</strong>, <strong id="EN-US_TOPIC_0125560292__b7307632">DisplayName</strong></p>
<p id="EN-US_TOPIC_0125560292__p65768696">Ancestor: <strong id="EN-US_TOPIC_0125560292__b55047352">Upload</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p29650512">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row65528017"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p6169189">StorageClass</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p29942301">Type of storage that will be used for storing objects after the multipart upload is complete.</p>
<p id="EN-US_TOPIC_0125560292__p1045258">Type: Enumeration</p>
<p id="EN-US_TOPIC_0125560292__p9407330">Ancestor: <strong id="EN-US_TOPIC_0125560292__b17557108">Upload</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p12839671">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row48448177"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p31988235">Initiated</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p40910225">Date and time at which the multipart upload was initiated</p>
<p id="EN-US_TOPIC_0125560292__p32647713">Type: Date</p>
<p id="EN-US_TOPIC_0125560292__p25393965">Ancestor: <strong id="EN-US_TOPIC_0125560292__b27219093">Upload</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p57262954">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row45604544"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p2980617">ListMultipartUploadsResult.Prefix</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p40103430">Contains the prefix specified in the request.</p>
<p id="EN-US_TOPIC_0125560292__p25386556">Type: String</p>
<p id="EN-US_TOPIC_0125560292__p27152416">Ancestor: <strong id="EN-US_TOPIC_0125560292__b43045155">ListMultipartUploadsResult</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p64105522">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row40078793"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p25156776">Delimiter</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p24432964">Contains the delimiter specified in the request.</p>
<p id="EN-US_TOPIC_0125560292__p18570084">Type: String</p>
<p id="EN-US_TOPIC_0125560292__p32913028">Ancestor: <strong id="EN-US_TOPIC_0125560292__b27781797">ListMultipartUploadsResult</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p35733079">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row53162257"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p11175599">CommonPrefixes</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p32808337">If you specify a delimiter in the request, the result returns each distinct key prefix containing the delimiter in a <strong id="EN-US_TOPIC_0125560292__b5531242155811">CommonPrefixes</strong> element.</p>
<p id="EN-US_TOPIC_0125560292__p40229664">Type: Container</p>
<p id="EN-US_TOPIC_0125560292__p26522659">Ancestor: <strong id="EN-US_TOPIC_0125560292__b37377347">ListMultipartUploadsResult</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p7666275">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560292__row1887613"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560292__p18678946">CommonPrefixes. Prefix</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560292__p36599672">Prefix contained in a <strong id="EN-US_TOPIC_0125560292__b365945245812">CommonPrefix</strong> element</p>
<p id="EN-US_TOPIC_0125560292__p11783462">Type: String</p>
<p id="EN-US_TOPIC_0125560292__p38942302">Ancestor: <strong id="EN-US_TOPIC_0125560292__b14936405">CommonPrefixes</strong></p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560292__p1889325">Mandatory</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560292__section61361165"><h4 class="sectiontitle">Error Responses</h4><ol id="EN-US_TOPIC_0125560292__ol35140862"><li id="EN-US_TOPIC_0125560292__li47832309">If an AK or signature is invalid, OBS returns status code <strong id="EN-US_TOPIC_0125560292__b27837602">403 Forbidden</strong> and error code <strong id="EN-US_TOPIC_0125560292__b49211830">AccessDenied</strong>.</li><li id="EN-US_TOPIC_0125560292__li40253290">If the requested bucket does not exist, OBS returns status code <strong id="EN-US_TOPIC_0125560292__b26735295">404 Not Found</strong> and error code <strong id="EN-US_TOPIC_0125560292__b39291071">NoSuchBucket</strong>.</li><li id="EN-US_TOPIC_0125560292__li18075321">If the requester does not have <strong id="EN-US_TOPIC_0125560292__b28460168">READ</strong> permission for the requested bucket, OBS returns status code <strong id="EN-US_TOPIC_0125560292__b54814924">403 Forbidden</strong> and error code <strong id="EN-US_TOPIC_0125560292__b23572270">AccessDenied</strong>.</li><li id="EN-US_TOPIC_0125560292__li10823839">If the value of <strong id="EN-US_TOPIC_0125560292__b30305688">maxUploads</strong> is a non-integer or smaller than 0, OBS returns status code <strong id="EN-US_TOPIC_0125560292__b4315738">400 Bad Request</strong>.</li></ol>
<p id="EN-US_TOPIC_0125560292__p38841646">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_0125560292__section48013777"><h4 class="sectiontitle">Sample Request</h4><pre class="screen" id="EN-US_TOPIC_0125560292__screen34211523112232">GET /?uploads&amp;max-uploads=3 HTTP/1.1
User-Agent: curl/7.19.0
Host: bucketname.obs.example.com
Accept: */*
Date: Mon, 1 Nov 2010 20:34:56 GMT
Authorization: AWS AKIAIOSFODNN7EXAMPLE:0RQf4/cRonhpaBX5sCYVf1bNRuU=</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560292__section29470815"><h4 class="sectiontitle">Sample Response</h4><pre class="screen" id="EN-US_TOPIC_0125560292__screen8933840112257">HTTP/1.1 200 OK
Server: OBS
x-amz-request-id: 656c76696e6727732072657175657374
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
x-amz-id-2: Uuag1LuByRx9e6j5Onimru9pO4ZVKnJ2Qz7/C1NPcfTWAtRPfTaOFg==
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 1330
Connection: keep-alive
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;ListMultipartUploadsResult xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;Bucket&gt;bucket&lt;/Bucket&gt;
&lt;KeyMarker&gt;&lt;/KeyMarker&gt;
&lt;UploadIdMarker&gt;&lt;/UploadIdMarker&gt;
&lt;NextKeyMarker&gt;my-movie.m2ts&lt;/NextKeyMarker&gt;
&lt;NextUploadIdMarker&gt;YW55gd2h5IGVsdmluZydzIHVwbG9hZCBmYWlsZWQ&lt;/NextUploadIdMarker&gt;
&lt;Delimiter&gt;&lt;/Delimiter&gt;
&lt;Prefix&gt;&lt;/Prefix&gt;
&lt;MaxUploads&gt;3&lt;/MaxUploads&gt;
&lt;IsTruncated&gt;true&lt;/IsTruncated&gt;
&lt;Upload&gt;
&lt;Key&gt;my-divisor&lt;/Key&gt;
&lt;UploadId&gt;XMgbGlrZSBlbHZpbmcncyBub3QgaGF2aW5nIG11Y2ggbHVjaw&lt;/UploadId&gt;
&lt;Initiator&gt;
&lt;ID&gt;b1d16700c70b0b05597d7acd6a3f92be&lt;/ID&gt;
&lt;DisplayName&gt;InitiatorDisplayName&lt;/DisplayName&gt;
&lt;/Initiator&gt;
&lt;Owner&gt;
&lt;ID&gt;75aa57f09aa0c8caeab4f84e99d10f8e&lt;/ID&gt;
&lt;DisplayName&gt;OwnerDisplayName&lt;/DisplayName&gt;
&lt;/Owner&gt;
&lt;StorageClass&gt;STANDARD&lt;/StorageClass&gt;
&lt;Initiated&gt;2010-11-10T20:48:33.000Z&lt;/Initiated&gt;
&lt;/Upload&gt;
&lt;Upload&gt;
&lt;Key&gt;my-movie.m2ts&lt;/Key&gt;
&lt;UploadId&gt;VXBsb2FkIElEIGZvciBlbHZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZA&lt;/UploadId&gt;
&lt;Initiator&gt;
&lt;ID&gt;b1d16700c70b0b05597d7acd6a3f92be&lt;/ID&gt;
&lt;DisplayName&gt;InitiatorDisplayName&lt;/DisplayName&gt;
&lt;/Initiator&gt;
&lt;Owner&gt;
&lt;ID&gt;b1d16700c70b0b05597d7acd6a3f92be&lt;/ID&gt;
&lt;DisplayName&gt;InitiatorDisplayName&lt;/DisplayName&gt;
&lt;/Owner&gt;
&lt;StorageClass&gt;STANDARD&lt;/StorageClass&gt;
&lt;Initiated&gt;2010-11-10T20:48:33.000Z&lt;/Initiated&gt;
&lt;/Upload&gt;
&lt;Upload&gt;
&lt;Key&gt;my-movie.m2ts&lt;/Key&gt;
&lt;UploadId&gt;YW55IGlkZWEgd2h5IGVsdmluZydzIHVwbG9hZCBmYWlsZWQ&lt;/UploadId&gt;
&lt;Initiator&gt;
&lt;ID&gt;75aa57f09aa0c8caeab4f84e99d10f8e&lt;/ID&gt;
&lt;DisplayName&gt;OwnerDisplayName&lt;/DisplayName&gt;
&lt;/Initiator&gt;
&lt;Owner&gt;
&lt;ID&gt;b1d16700c70b0b05597d7acd6a3f92be&lt;/ID&gt;
&lt;DisplayName&gt;InitiatorDisplayName&lt;/DisplayName&gt;
&lt;/Owner&gt;
&lt;StorageClass&gt;STANDARD&lt;/StorageClass&gt;
&lt;Initiated&gt;2010-11-10T20:49:33.000Z&lt;/Initiated&gt;
&lt;/Upload&gt;
&lt;/ListMultipartUploadsResult&gt;</pre>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0125560493.html">Operations on Buckets</a></div>
</div>
</div>
View Git Blame Copy Permalink