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

298 lines
23 KiB
HTML

<a name="EN-US_TOPIC_0125560266"></a><a name="EN-US_TOPIC_0125560266"></a>
<h1 class="topictitle1">List Parts</h1>
<div id="body33271298"><p class="msonormal" id="EN-US_TOPIC_0125560266__p32265258">You can use this operation to query all parts associated to a multipart upload.</p>
<div class="section" id="EN-US_TOPIC_0125560266__section54014227"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560266__screen2457463114430">GET /ObjectName?uploadId=uploadid&amp;max-parts=max&amp;part-number-marker=marker 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_0125560266__section16365997"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0125560266__p26821252">This request uses parameters to specify associated parts to be listed. <a href="#EN-US_TOPIC_0125560266__table43496416">Table 1</a> describes the parameters.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560266__table43496416"></a><a name="table43496416"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560266__table43496416" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0125560266__row12855810"><th align="left" class="cellrowborder" valign="top" width="23.99239923992399%" id="mcps1.3.3.3.2.4.1.1"><p id="EN-US_TOPIC_0125560266__p34687669">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50.645064506450645%" id="mcps1.3.3.3.2.4.1.2"><p id="EN-US_TOPIC_0125560266__p58237776">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25.36253625362536%" id="mcps1.3.3.3.2.4.1.3"><p id="EN-US_TOPIC_0125560266__p19639420">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560266__row42537056"><td class="cellrowborder" valign="top" width="23.99239923992399%" headers="mcps1.3.3.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560266__p22949479">uploadId</p>
</td>
<td class="cellrowborder" valign="top" width="50.645064506450645%" headers="mcps1.3.3.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560266__p46968531">Indicates the ID of the multipart upload whose parts are to be listed.</p>
<p id="EN-US_TOPIC_0125560266__p20063603">Type: String</p>
<p id="EN-US_TOPIC_0125560266__p46354700">Default value: None</p>
</td>
<td class="cellrowborder" valign="top" width="25.36253625362536%" headers="mcps1.3.3.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560266__p63743225">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row36818119"><td class="cellrowborder" valign="top" width="23.99239923992399%" headers="mcps1.3.3.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560266__p29477662">max-parts</p>
</td>
<td class="cellrowborder" valign="top" width="50.645064506450645%" headers="mcps1.3.3.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560266__p38880413">Sets the maximum number of parts to be listed.</p>
<p id="EN-US_TOPIC_0125560266__p14379404">Type: String</p>
<p id="EN-US_TOPIC_0125560266__p62305773">Default: 1000</p>
</td>
<td class="cellrowborder" valign="top" width="25.36253625362536%" headers="mcps1.3.3.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560266__p13602870">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row55316967"><td class="cellrowborder" valign="top" width="23.99239923992399%" headers="mcps1.3.3.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560266__p51489303">part-number</p>
<p id="EN-US_TOPIC_0125560266__p60750544">-marker</p>
</td>
<td class="cellrowborder" valign="top" width="50.645064506450645%" headers="mcps1.3.3.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560266__p21847026">Specifies the part after which the part listing begins. The OBS lists only parts with greater numbers than that specified by this parameter.</p>
<p id="EN-US_TOPIC_0125560266__p62405508">Type: String</p>
<p id="EN-US_TOPIC_0125560266__p24778668">Default: None</p>
</td>
<td class="cellrowborder" valign="top" width="25.36253625362536%" headers="mcps1.3.3.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560266__p60915111">Optional</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560266__section13076248"><h4 class="sectiontitle">Request Headers</h4><p id="EN-US_TOPIC_0125560266__p48157283">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_0125560266__section50577374"><h4 class="sectiontitle">Request Elements</h4><p id="EN-US_TOPIC_0125560266__p11404934">This request involves no elements.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560266__section45087584"><h4 class="sectiontitle">Response Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560266__screen5971248911450">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
Content-Type: type
Content-Length: length
Connection: state
Server: server
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;ListPartsResult xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;Bucket&gt;BucketName&lt;/Bucket&gt;
&lt;Key&gt;ObjectName &lt;/Key&gt;
&lt;UploadId&gt;uploadid&lt;/UploadId&gt;
&lt;Initiator&gt;
&lt;ID&gt;initiatorid&lt;/ID&gt;
&lt;DisplayName&gt;displayname&lt;/DisplayName&gt;
&lt;/Initiator&gt;
&lt;Owner&gt;
&lt;ID&gt;ownerid&lt;/ID&gt;
&lt;DisplayName&gt;ownername&lt;/DisplayName&gt;
&lt;/Owner&gt;
&lt;StorageClass&gt;STANDARD&lt;/StorageClass&gt;
&lt;PartNumberMarker&gt;partNmebermarker&lt;/PartNumberMarker&gt;
&lt;NextPartNumberMarker&gt;nextpartnumbermarker&lt;/NextPartNumberMarker&gt;
&lt;MaxParts&gt;2&lt;/MaxParts&gt;
&lt;IsTruncated&gt;true&lt;/IsTruncated&gt;
&lt;Part&gt;
&lt;PartNumber&gt;partnumber&lt;/PartNumber&gt;
&lt;LastModified&gt;modifieddate&lt;/LastModified&gt;
&lt;ETag&gt;etag&lt;/ETag&gt;
&lt;Size&gt;etag&lt;/Size&gt;
&lt;/Part&gt;
..
&lt;/ListPartsResult&gt;</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560266__section3135073"><h4 class="sectiontitle">Response Headers</h4><p id="EN-US_TOPIC_0125560266__p59487023">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_0125560266__section28215657"><h4 class="sectiontitle">Response Elements</h4><p id="EN-US_TOPIC_0125560266__p56317343">This response uses elements to provide details about the listed parts. <a href="#EN-US_TOPIC_0125560266__table33229135">Table 2</a> describes the elements.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560266__table33229135"></a><a name="table33229135"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560266__table33229135" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response elements</caption><thead align="left"><tr id="EN-US_TOPIC_0125560266__row12519366"><th align="left" class="cellrowborder" valign="top" width="26.55%" id="mcps1.3.8.3.2.3.1.1"><p id="EN-US_TOPIC_0125560266__p7435725">Element</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="73.45%" id="mcps1.3.8.3.2.3.1.2"><p id="EN-US_TOPIC_0125560266__p65422844">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560266__row51934691"><td class="cellrowborder" valign="top" width="26.55%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560266__p45960418">ListPartsResult</p>
</td>
<td class="cellrowborder" valign="top" width="73.45%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560266__p31806366">Container for the response</p>
<p id="EN-US_TOPIC_0125560266__p17821838">Type: Container</p>
<p id="EN-US_TOPIC_0125560266__p26178814">Children: <strong id="EN-US_TOPIC_0125560266__b34282735">Bucket</strong>, <strong id="EN-US_TOPIC_0125560266__b40109162">Key</strong>, <strong id="EN-US_TOPIC_0125560266__b25438145">UploadId</strong>, <strong id="EN-US_TOPIC_0125560266__b27616715">PartNumberMarker</strong>, <strong id="EN-US_TOPIC_0125560266__b47223851"><em id="EN-US_TOPIC_0125560266__i22361481">NextPartNumberMarker</em></strong>, <strong id="EN-US_TOPIC_0125560266__b67035606">MaxParts</strong>, <strong id="EN-US_TOPIC_0125560266__b66449547">IsTruncated</strong>, <strong id="EN-US_TOPIC_0125560266__b61175018">Part</strong></p>
<p id="EN-US_TOPIC_0125560266__p13704250">Ancestor: None</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row56229389"><td class="cellrowborder" valign="top" width="26.55%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560266__p58286698">Bucket</p>
</td>
<td class="cellrowborder" valign="top" width="73.45%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560266__p23602087">Name of the bucket to which the multipart upload was initiated</p>
<p id="EN-US_TOPIC_0125560266__p11092193">Type: String</p>
<p id="EN-US_TOPIC_0125560266__p32720876">Ancestor: <strong id="EN-US_TOPIC_0125560266__b26052434">ListPartsResult</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row33145314"><td class="cellrowborder" valign="top" width="26.55%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560266__p415920">Key</p>
</td>
<td class="cellrowborder" valign="top" width="73.45%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560266__p33689599">Key of the object for which the multipart upload was initiated</p>
<p id="EN-US_TOPIC_0125560266__p34770943">Type: String</p>
<p id="EN-US_TOPIC_0125560266__p44503031">Ancestor: <strong id="EN-US_TOPIC_0125560266__b64982961">ListPartsResult</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row47975743"><td class="cellrowborder" valign="top" width="26.55%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560266__p60829951">UploadId</p>
</td>
<td class="cellrowborder" valign="top" width="73.45%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560266__p28279008">ID that identifies the multipart upload whose parts are listed</p>
<p id="EN-US_TOPIC_0125560266__p53184484">Type: String</p>
<p id="EN-US_TOPIC_0125560266__p8898313">Ancestor: <strong id="EN-US_TOPIC_0125560266__b12975961">ListPartsResult</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row49674787"><td class="cellrowborder" valign="top" width="26.55%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560266__p64234838">Initiator</p>
</td>
<td class="cellrowborder" valign="top" width="73.45%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560266__p35639369">Container element that identifies who initiated the multipart upload</p>
<p id="EN-US_TOPIC_0125560266__p52318866">Type: Container</p>
<p id="EN-US_TOPIC_0125560266__p1107748">Children: <strong id="EN-US_TOPIC_0125560266__b9969736">ID</strong>, <strong id="EN-US_TOPIC_0125560266__b22618768">DisplayName</strong></p>
<p id="EN-US_TOPIC_0125560266__p2242324">Ancestor: <strong id="EN-US_TOPIC_0125560266__b20180916">ListPartsResult</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row47410523"><td class="cellrowborder" valign="top" width="26.55%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560266__p15047175">Owner</p>
</td>
<td class="cellrowborder" valign="top" width="73.45%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560266__p10861696">Container element that identifies the object owner. This element is the same as <strong id="EN-US_TOPIC_0125560266__b30646405">Initiator</strong> and compatible with Amazon S3. In S3, if a multipart upload is initiated by an IAM user, <strong id="EN-US_TOPIC_0125560266__b7382189">Initiator</strong> may differ from <strong id="EN-US_TOPIC_0125560266__b66439707">Owner</strong>.</p>
<p id="EN-US_TOPIC_0125560266__p61086455">Children: <strong id="EN-US_TOPIC_0125560266__b12907186">ID</strong>, <strong id="EN-US_TOPIC_0125560266__b49055813">DisplayName</strong></p>
<p id="EN-US_TOPIC_0125560266__p38849137">Ancestor: <strong id="EN-US_TOPIC_0125560266__b14097920">ListPartsResult</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row59772417"><td class="cellrowborder" valign="top" width="26.55%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560266__p9727626">ID</p>
</td>
<td class="cellrowborder" valign="top" width="73.45%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560266__p49740211">DomainId of initiator or owner.</p>
<p id="EN-US_TOPIC_0125560266__p45008715">Type: String</p>
<p id="EN-US_TOPIC_0125560266__p2425252">Ancestor: <strong id="EN-US_TOPIC_0125560266__b21827271">Initiator</strong> or <strong id="EN-US_TOPIC_0125560266__b62227718">Owner</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row23178552"><td class="cellrowborder" valign="top" width="26.55%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560266__p65523462">DisplayName</p>
</td>
<td class="cellrowborder" valign="top" width="73.45%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560266__p5800216">Initiator name</p>
<p id="EN-US_TOPIC_0125560266__p52201951">Type: String</p>
<p id="EN-US_TOPIC_0125560266__p55511">Ancestor: <strong id="EN-US_TOPIC_0125560266__b499602">Initiator</strong> or <strong id="EN-US_TOPIC_0125560266__b4496426">Owner</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row57246233154424"><td class="cellrowborder" valign="top" width="26.55%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560266__p196162555511">StorageClass</p>
</td>
<td class="cellrowborder" valign="top" width="73.45%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560266__p92561642384">Storage class.</p>
<p id="EN-US_TOPIC_0125560266__p10256842388">Type: Enumeration</p>
<p id="EN-US_TOPIC_0125560266__p42561042688">Valid values: STANDARD | STANDARD_IA |GLACIER</p>
<p id="EN-US_TOPIC_0125560266__p1925618421087">Ancestor: ListPartsResult</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row40467839"><td class="cellrowborder" valign="top" width="26.55%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560266__p56669516">PartNumberMarker</p>
</td>
<td class="cellrowborder" valign="top" width="73.45%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560266__p26828065">Part number after which the part listing begins</p>
<p id="EN-US_TOPIC_0125560266__p40125999">Type: Integer</p>
<p id="EN-US_TOPIC_0125560266__p25589671">Ancestor: <strong id="EN-US_TOPIC_0125560266__b28980452">ListPartsResult</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row59497477"><td class="cellrowborder" valign="top" width="26.55%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560266__p54566372">NextPartNumber Marker</p>
</td>
<td class="cellrowborder" valign="top" width="73.45%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560266__p57800044">Value of <strong id="EN-US_TOPIC_0125560266__b50438350">PartNumberMarker</strong> in a subsequent request after a part list is truncated.</p>
<p id="EN-US_TOPIC_0125560266__p51291972">Type: Integer</p>
<p id="EN-US_TOPIC_0125560266__p58974565">Ancestor: <strong id="EN-US_TOPIC_0125560266__b61009044">ListPartsResult</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row12210489"><td class="cellrowborder" valign="top" width="26.55%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560266__p49525553">MaxParts</p>
</td>
<td class="cellrowborder" valign="top" width="73.45%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560266__p52146870">Maximum number of parts that are returned</p>
<p id="EN-US_TOPIC_0125560266__p66668648">Type: Integer</p>
<p id="EN-US_TOPIC_0125560266__p63146927">Ancestor: <strong id="EN-US_TOPIC_0125560266__b31451435">ListPartsResult</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row14627461"><td class="cellrowborder" valign="top" width="26.55%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560266__p43973663">IsTruncated</p>
</td>
<td class="cellrowborder" valign="top" width="73.45%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560266__p5096933">Indicates whether the returned part list is truncated. <strong id="EN-US_TOPIC_0125560266__b45872405">true</strong> indicates that the list was truncated and <strong id="EN-US_TOPIC_0125560266__b10198465">false</strong> indicates that the list was not truncated.</p>
<p id="EN-US_TOPIC_0125560266__p24677321">Type: Boolean</p>
<p id="EN-US_TOPIC_0125560266__p20769304">Ancestor: <strong id="EN-US_TOPIC_0125560266__b52706014">ListPartsResult</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row4592084"><td class="cellrowborder" valign="top" width="26.55%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560266__p36414557">Part</p>
</td>
<td class="cellrowborder" valign="top" width="73.45%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560266__p63898010">Container for elements related to a particular part</p>
<p id="EN-US_TOPIC_0125560266__p38211184">Type: String</p>
<p id="EN-US_TOPIC_0125560266__p8356340">Children: <strong id="EN-US_TOPIC_0125560266__b8098199">PartNumber</strong>, <strong id="EN-US_TOPIC_0125560266__b5774930">LastModified</strong>, <strong id="EN-US_TOPIC_0125560266__b51974374">ETag</strong>, <strong id="EN-US_TOPIC_0125560266__b65116189">Size</strong></p>
<p id="EN-US_TOPIC_0125560266__p49174790">Ancestor: <strong id="EN-US_TOPIC_0125560266__b39919932">ListPartsResult</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row23735071"><td class="cellrowborder" valign="top" width="26.55%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560266__p43492568">PartNumber</p>
</td>
<td class="cellrowborder" valign="top" width="73.45%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560266__p33237081">Number that identifies a part</p>
<p id="EN-US_TOPIC_0125560266__p30698276">Type: Integer</p>
<p id="EN-US_TOPIC_0125560266__p7849035">Ancestor: <strong id="EN-US_TOPIC_0125560266__b3532453">ListPartsResult.Part</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row31792085"><td class="cellrowborder" valign="top" width="26.55%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560266__p25022112">LastModified</p>
</td>
<td class="cellrowborder" valign="top" width="73.45%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560266__p13525204">Date and time at which a part was uploaded</p>
<p id="EN-US_TOPIC_0125560266__p54617972">Type: Date</p>
<p id="EN-US_TOPIC_0125560266__p21799703">Ancestor: <strong id="EN-US_TOPIC_0125560266__b61979607">ListPartsResult.Part</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row20945556"><td class="cellrowborder" valign="top" width="26.55%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560266__p18868465">ETag</p>
</td>
<td class="cellrowborder" valign="top" width="73.45%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560266__p51950678">ETag of an uploaded part.</p>
<p id="EN-US_TOPIC_0125560266__p64902924">Type: String</p>
<p id="EN-US_TOPIC_0125560266__p47255404">Ancestor: <strong id="EN-US_TOPIC_0125560266__b22645457">ListPartsResult.Part</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560266__row2482522"><td class="cellrowborder" valign="top" width="26.55%" headers="mcps1.3.8.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560266__p66866633">Size</p>
</td>
<td class="cellrowborder" valign="top" width="73.45%" headers="mcps1.3.8.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560266__p47488225">Size of an uploaded part</p>
<p id="EN-US_TOPIC_0125560266__p24740843">Type: Integer</p>
<p id="EN-US_TOPIC_0125560266__p21341001">Ancestor: <strong id="EN-US_TOPIC_0125560266__b57851282">ListPartsResult.Part</strong></p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560266__section52614321"><h4 class="sectiontitle">Error Responses</h4><ul id="EN-US_TOPIC_0125560266__ul08484295369"><li id="EN-US_TOPIC_0125560266__li184720298362">If an AccessKey or signature is invalid, OBS returns status code <strong id="EN-US_TOPIC_0125560266__b12846122916360">403 Forbidden</strong> and error code <strong id="EN-US_TOPIC_0125560266__b1984752910362">AccessDenied</strong>.</li><li id="EN-US_TOPIC_0125560266__li12847192910365">If the requested bucket does not exist, OBS returns status code <strong id="EN-US_TOPIC_0125560266__b108477293361">404 Not Found</strong> and error code <strong id="EN-US_TOPIC_0125560266__b284712913612">NoSuchBucket</strong>.</li><li id="EN-US_TOPIC_0125560266__li10847172920363">If the requested multipart upload does not exist, OBS returns status code <strong id="EN-US_TOPIC_0125560266__b4847142913610">404 Not Found</strong> and error code <strong id="EN-US_TOPIC_0125560266__b14847112918369">NoSuchUpload</strong>.</li><li id="EN-US_TOPIC_0125560266__li684872953618">If the requester does not have <strong id="EN-US_TOPIC_0125560266__b1684742943618">READ</strong> permission for the requested bucket, OBS returns status code <strong id="EN-US_TOPIC_0125560266__b9847202963612">403 Forbidden</strong> and error code <strong id="EN-US_TOPIC_0125560266__b15847172917366">AccessDenied</strong>.</li></ul>
<p id="EN-US_TOPIC_0125560266__p18688478">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_0125560266__section63777619"><h4 class="sectiontitle">Sample Request</h4><pre class="screen" id="EN-US_TOPIC_0125560266__screen66771746114519">GET /example-object?uploadId=XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA&amp;max-parts=2&amp;part-number-marker=1 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:0RQf4/cRonhpaBX5sCYVf1bNRuU=</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560266__section37127664"><h4 class="sectiontitle">Sample Response</h4><pre class="screen" id="EN-US_TOPIC_0125560266__screen64861163114547">HTTP/1.1 200 OK
x-amz-id-2: Uuag1LuByRx9e6j5Onimru9pO4ZVKnJ2Qz7/C1NPcfTWAtRPfTaOFg==
x-amz-request-id: 656c76696e6727732072657175657374
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
Content-Type: application/xml
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 985
Connection: keep-alive
Server: OBS
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;ListPartsResult xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;Bucket&gt;example-bucket&lt;/Bucket&gt;
&lt;Key&gt;example-object&lt;/Key&gt;
&lt;UploadId&gt;XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA&lt;/UploadId&gt;
&lt;Initiator&gt;
&lt;ID&gt; 11116a31-17b5-4fb7-9df5-b288870f11xx&lt;/ID&gt;
&lt;DisplayName&gt;umat-user-11116a31-17b5-4fb7-9df5-b288870f11xx&lt;/DisplayName&gt;
&lt;/Initiator&gt;
&lt;Owner&gt;
&lt;ID&gt;75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a&lt;/ID&gt;
&lt;DisplayName&gt;someName&lt;/DisplayName&gt;
&lt;/Owner&gt;
&lt;StorageClass&gt;STANDARD&lt;/StorageClass&gt;
&lt;PartNumberMarker&gt;1&lt;/PartNumberMarker&gt;
&lt;NextPartNumberMarker&gt;3&lt;/NextPartNumberMarker&gt;
&lt;MaxParts&gt;2&lt;/MaxParts&gt;
&lt;IsTruncated&gt;true&lt;/IsTruncated&gt;
&lt;Part&gt;
&lt;PartNumber&gt;2&lt;/PartNumber&gt;
&lt;LastModified&gt;2010-11-10T20:48:34.000Z&lt;/LastModified&gt;
&lt;ETag&gt;"7778aef83f66abc1fa1e8477f296d394"&lt;/ETag&gt;
&lt;Size&gt;10485760&lt;/Size&gt;
&lt;/Part&gt;
&lt;Part&gt;
&lt;PartNumber&gt;3&lt;/PartNumber&gt;
&lt;LastModified&gt;2010-11-10T20:48:33.000Z&lt;/LastModified&gt;
&lt;ETag&gt;"aaaa18db4cc2f85cedef654fccc4a4x8"&lt;/ETag&gt;
&lt;Size&gt;10485760&lt;/Size&gt;
&lt;/Part&gt;
&lt;/ListPartsResult&gt;</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>