vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/obs/api-ref/obs_04_0022.html
zhangyue 8ba86cabc9 OBS API DOC 
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>
2024-05-28 10:01:19 +00:00

670 lines
52 KiB
HTML
Raw Blame History

<a name="obs_04_0022"></a><a name="obs_04_0022"></a>
<h1 class="topictitle1">Listing Objects in a Bucket</h1>
<div id="body49142923"><div class="section" id="obs_04_0022__section5584184924715"><h4 class="sectiontitle">Functions</h4><p id="obs_04_0022__p2379878">This operation lists objects in a bucket. To use this operation, you must have the permission to read the bucket.</p>
<p id="obs_04_0022__p21418904">If you specify only the bucket name in the request, OBS returns descriptions for some or all of the objects (a maximum of 1,000 objects) in the bucket. If you also specify one or more parameters among <strong id="obs_04_0022__b476019011422">prefix</strong>, <strong id="obs_04_0022__b156641433424">marker</strong>, <strong id="obs_04_0022__b763014614217">max-keys</strong>, and <strong id="obs_04_0022__b189545125426">delimiter</strong> in the request, OBS returns a list of objects based on the semantics specified in <a href="#obs_04_0022__table14681180">Table 1</a>.</p>
<p id="obs_04_0022__p71702028165217">You can also add the <strong id="obs_04_0022__b1878613614433">versions</strong> parameter to the request to list multiple versions of an object in a bucket.</p>
</div>
<div class="section" id="obs_04_0022__section57209668"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0022__screen56166629"><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></pre></div></td><td class="code"><div><pre><span></span>GET<span class="w"> </span>/<span class="w"> </span>HTTP/1.1<span class="w"> </span>
<span class="w"> </span>
Host:<span class="w"> </span>bucketname.obs.region.example.com
Date:<span class="w"> </span>date
Authorization:<span class="w"> </span>authorization
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0022__section45124968"><h4 class="sectiontitle">Request Syntax (for multi-version objects)</h4><div class="codecoloring" codetype="Xml" id="obs_04_0022__screen15747352"><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></pre></div></td><td class="code"><div><pre><span></span>GET<span class="w"> </span>/?versions<span class="w"> </span>HTTP/1.1<span class="w"> </span>
Host:<span class="w"> </span>bucketname.obs.region.example.com
Date:<span class="w"> </span>date
Authorization:<span class="w"> </span>authorization
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0022__section3471528"><h4 class="sectiontitle">Request Parameters</h4><p id="obs_04_0022__p16521811">This request uses parameters to list some objects in a bucket. <a href="#obs_04_0022__table14681180">Table 1</a> describes the parameters.</p>
<div class="tablenoborder"><a name="obs_04_0022__table14681180"></a><a name="table14681180"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0022__table14681180" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="obs_04_0022__row39988035"><th align="left" class="cellrowborder" valign="top" width="13.130000000000003%" id="mcps1.3.4.3.2.4.1.1"><p id="obs_04_0022__p17805368">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="68.69000000000001%" id="mcps1.3.4.3.2.4.1.2"><p id="obs_04_0022__p28102680">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.180000000000003%" id="mcps1.3.4.3.2.4.1.3"><p id="obs_04_0022__p18650850">Mandatory</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0022__row34323897"><td class="cellrowborder" valign="top" width="13.130000000000003%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0022__p28772301">prefix</p>
</td>
<td class="cellrowborder" valign="top" width="68.69000000000001%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0022__p48855045">Lists objects that begin with the specified prefix.</p>
<p id="obs_04_0022__p37042226">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="18.180000000000003%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_04_0022__p47630364">No</p>
</td>
</tr>
<tr id="obs_04_0022__row26020099"><td class="cellrowborder" valign="top" width="13.130000000000003%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0022__p27253273">marker</p>
</td>
<td class="cellrowborder" valign="top" width="68.69000000000001%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0022__p60031475">Specifies a marker when listing objects in a bucket. With a marker configured, objects after this marker will be returned in alphabetical order. This field is used only for listing objects.</p>
<p id="obs_04_0022__p3412365">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="18.180000000000003%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_04_0022__p7966153">No</p>
</td>
</tr>
<tr id="obs_04_0022__row4586517"><td class="cellrowborder" valign="top" width="13.130000000000003%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0022__p35963564">max-keys</p>
</td>
<td class="cellrowborder" valign="top" width="68.69000000000001%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0022__p27367592">Specifies the maximum number (from <strong id="obs_04_0022__b16432172375911">1</strong> to <strong id="obs_04_0022__b54321323125915">1000</strong>) of objects returned (in alphabetical order) in the response. If the value is beyond this range, only 1,000 objects are returned by default.</p>
<p id="obs_04_0022__p44981744">Type: integer</p>
</td>
<td class="cellrowborder" valign="top" width="18.180000000000003%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_04_0022__p19642622">No</p>
</td>
</tr>
<tr id="obs_04_0022__row42565870"><td class="cellrowborder" valign="top" width="13.130000000000003%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0022__p25283464">delimiter</p>
</td>
<td class="cellrowborder" valign="top" width="68.69000000000001%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0022__p54017354815">Separator used to group object names. If a prefix is specified, objects with the same string from the prefix to the first delimiter are grouped into one <strong id="obs_04_0022__b20945155175712">CommonPrefixes</strong>. If no prefix is specified, objects with the same string from the first character to the first delimiter are grouped into one <strong id="obs_04_0022__b547108125711">CommonPrefixes</strong>.</p>
<p id="obs_04_0022__p1140173114819">For example, there are three objects (<strong id="obs_04_0022__b17596122435716">abcd</strong>, <strong id="obs_04_0022__b388612298570">abcde</strong>, and <strong id="obs_04_0022__b217212335572">bbcde</strong>) in a bucket. If <strong id="obs_04_0022__b14121608584">delimiter</strong> is set to <strong id="obs_04_0022__b13729112145817">d</strong> and <strong id="obs_04_0022__b42663712583">prefix</strong> is set to <strong id="obs_04_0022__b2655191085814">a</strong>, objects <strong id="obs_04_0022__b4106382583">abcd</strong> and <strong id="obs_04_0022__b1937044595817">abcde</strong> are grouped into a <strong id="obs_04_0022__b640611210592">CommonPrefixes</strong> with <strong id="obs_04_0022__b19792231595">abcd</strong> as the prefix. If only <strong id="obs_04_0022__b8385174812013">delimiter</strong> is set to <strong id="obs_04_0022__b11870522019">d</strong>, objects <strong id="obs_04_0022__b26516816216">abcd</strong> and <strong id="obs_04_0022__b6747191116218">abcde</strong> are grouped into a <strong id="obs_04_0022__b81621124824">CommonPrefixes</strong> with <strong id="obs_04_0022__b105054403214">abcd</strong> as the prefix, and <strong id="obs_04_0022__b61471845324">bbcde</strong> is grouped separately into another <strong id="obs_04_0022__b2342149637">CommonPrefixes</strong> with <strong id="obs_04_0022__b1353828332">bbcd</strong> as the prefix.</p>
<p id="obs_04_0022__p1926293982513">For a parallel file system, if this parameter is not specified, all the content in the directory is recursively listed by default, and subdirectories are also listed. In big data scenarios, parallel file systems usually have deep directory levels and each directory has a large number of files. In such case, you are advised to configure <strong id="obs_04_0022__b1874161318585">[delimiter=/]</strong> to list the content in the current directory, but not list subdirectories, thereby improving the listing efficiency.</p>
<p id="obs_04_0022__p440113318486">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="18.180000000000003%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_04_0022__p59499450">No</p>
</td>
</tr>
<tr id="obs_04_0022__row83242794310"><td class="cellrowborder" valign="top" width="13.130000000000003%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0022__p17321827164320">key-marker</p>
</td>
<td class="cellrowborder" valign="top" width="68.69000000000001%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0022__p1298274718474">Position to start with when objects are listed. This field is used only for listing versioned objects.</p>
<p id="obs_04_0022__p17982184724711">Type: string</p>
<p id="obs_04_0022__p186210361515">Valid value: value of <strong id="obs_04_0022__b029210474213">NextKeyMarker</strong> in the response body of the last request</p>
</td>
<td class="cellrowborder" valign="top" width="18.180000000000003%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_04_0022__p133242713438">No</p>
</td>
</tr>
<tr id="obs_04_0022__row65733008"><td class="cellrowborder" valign="top" width="13.130000000000003%" headers="mcps1.3.4.3.2.4.1.1 "><p id="obs_04_0022__p22773420">version-id-marker</p>
</td>
<td class="cellrowborder" valign="top" width="68.69000000000001%" headers="mcps1.3.4.3.2.4.1.2 "><p id="obs_04_0022__p18339153314472">This parameter applies only when versioning is enabled.</p>
<p id="obs_04_0022__p32707692">Specifies the version ID to start with when objects in a bucket are listed. Objects are listed in alphabetical order (a maximum of 1,000 objects are displayed at a time). This parameter is used together with the <strong id="obs_04_0022__b157920685093657">key-marker</strong> in the request. If the value of <strong id="obs_04_0022__b16178829945">version-id-marker</strong> is not a version ID specified by <strong id="obs_04_0022__b11841929443">key-marker</strong>, <strong id="obs_04_0022__b171851129646">version-id-marker</strong> is invalid.</p>
<p id="obs_04_0022__p25933773">Type: string</p>
<p id="obs_04_0022__p32077368">Valid value: object version ID, that is, the value of <strong id="obs_04_0022__b64523179616">NextVersionIdMarker</strong> in the response body of the last request</p>
</td>
<td class="cellrowborder" valign="top" width="18.180000000000003%" headers="mcps1.3.4.3.2.4.1.3 "><p id="obs_04_0022__p30517193">No</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0022__section31243759"><h4 class="sectiontitle">Request Headers</h4><p id="obs_04_0022__p55973588">This request uses common request 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_0022__section12758381"><h4 class="sectiontitle">Request Elements</h4><p id="obs_04_0022__p2556808">This request contains no elements.</p>
</div>
<div class="section" id="obs_04_0022__section47716571"><h4 class="sectiontitle">Response Syntax</h4><pre class="screen" id="obs_04_0022__screen19177179144413">&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;ListBucketResult xmlns="http://obs.otc.t-systems.com/doc/2016-01-01/"&gt;
&lt;Name&gt;bucket_name&lt;/Name&gt;
&lt;Prefix&gt;&lt;/Prefix&gt;
&lt;Marker&gt;&lt;/Marker&gt;
&lt;MaxKeys&gt;1000&lt;/MaxKeys&gt;
&lt;IsTruncated&gt;false&lt;/IsTruncated&gt;
&lt;Contents&gt;
&lt;Key&gt;object_name&lt;/Key&gt;
&lt;LastModified&gt;2022-11-11T11:11:11.111Z&lt;/LastModified&gt;
&lt;ETag&gt;"37f80ab36f7c19abe8250e5e00123456"&lt;/ETag&gt;
&lt;Size&gt;55555&lt;/Size&gt;
&lt;Owner&gt;
&lt;ID&gt;e8df38eb4e4f4f148e06d8db50123456&lt;/ID&gt;
&lt;/Owner&gt;
&lt;StorageClass&gt;STANDARD&lt;/StorageClass&gt;
&lt;/Contents&gt;
&lt;/ListBucketResult&gt;</pre>
</div>
<div class="section" id="obs_04_0022__section26795963"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0022__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_0022__section39837076"><h4 class="sectiontitle">Response Elements</h4><p id="obs_04_0022__p31592957">This response lists objects in XML format. Specific elements are described in <a href="#obs_04_0022__table17753706155228">Table 2</a>.</p>
<div class="tablenoborder"><a name="obs_04_0022__table17753706155228"></a><a name="table17753706155228"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0022__table17753706155228" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response elements</caption><thead align="left"><tr id="obs_04_0022__row5816417"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.9.3.2.3.1.1"><p id="obs_04_0022__p1367796"><strong id="obs_04_0022__b17732133018472">Element</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.9.3.2.3.1.2"><p id="obs_04_0022__p57599360"><strong id="obs_04_0022__b153917267470">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0022__row46893646"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p40288978">ListBucketResult</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p42181815">A list of objects in a bucket</p>
<p id="obs_04_0022__p44092021">Type: XML</p>
</td>
</tr>
<tr id="obs_04_0022__row61283877"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p65046979">Contents</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p34313913">Object metadata</p>
<p id="obs_04_0022__p40389765">Type: XML</p>
<p id="obs_04_0022__p27963568">Parent: ListBucketResult</p>
</td>
</tr>
<tr id="obs_04_0022__row50345523"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p51455566">CommonPrefixes</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p7151293">Group information. If you specify a delimiter in the request, the response contains group information in <strong id="obs_04_0022__b1537116282101626">CommonPrefixes</strong>.</p>
<p id="obs_04_0022__p64361640">Type: XML</p>
<p id="obs_04_0022__p42383849">Parent: ListBucketResult</p>
</td>
</tr>
<tr id="obs_04_0022__row45910321"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p27748482">Delimiter</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p33034564">The delimiter parameter specified in a request</p>
<p id="obs_04_0022__p28875622">Type: string</p>
<p id="obs_04_0022__p58554014">Parent: ListBucketResult</p>
</td>
</tr>
<tr id="obs_04_0022__row4028061"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p57837514">ETag</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p54327039">Base64-encoded 128-bit MD5 digest of an object. ETag is the unique identifier of the object content. It can be used to determine whether the object content is changed. For example, if the ETag value is <strong id="obs_04_0022__b6681248907">A</strong> when an object is uploaded, but this value has changed to <strong id="obs_04_0022__b96811489012">B</strong> when the object is downloaded, it indicates that the object content has been changed. The ETag value is a hash of the object. The ETag reflects changes to the object content, rather than the object metadata. An uploaded object or copied object has a unique ETag after being encrypted using MD5. (If the object is encrypted on the server side, the ETag value is not the MD5 digest of the object, but the unique identifier calculated through server-side encryption.)</p>
<p id="obs_04_0022__p19181309">Type: string</p>
<p id="obs_04_0022__p38414053">Parent: ListBucketResult.Contents</p>
</td>
</tr>
<tr id="obs_04_0022__row13854468401"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p1085411613409">Type</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p1128926124012">Object type. This parameter is returned when the object type is not <strong id="obs_04_0022__b287233651017">Normal</strong>.</p>
<p id="obs_04_0022__p13062604013">Type: string</p>
<p id="obs_04_0022__p6322268407">Parent: ListBucketResult.Contents</p>
</td>
</tr>
<tr id="obs_04_0022__row10182162"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p19448771">ID</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p37562196382">Domain ID of the object owner</p>
<p id="obs_04_0022__p18184394">Type: string</p>
<p id="obs_04_0022__p29441820">Parent: ListBucketResult.Contents.Owner</p>
</td>
</tr>
<tr id="obs_04_0022__row63649794"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p55359666">IsTruncated</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p54947971">Determines whether the returned list of objects is truncated. The value <strong id="obs_04_0022__b44800605">true</strong> indicates that the list was truncated and <strong id="obs_04_0022__b552262">false</strong> indicates that the list was not truncated.</p>
<p id="obs_04_0022__p24769695">Type: boolean</p>
<p id="obs_04_0022__p21600668">Parent: ListBucketResult</p>
</td>
</tr>
<tr id="obs_04_0022__row60188292"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p43413469">Key</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p26830099">Object name</p>
<p id="obs_04_0022__p40144300">Type: string</p>
<p id="obs_04_0022__p25754381">Parent: ListBucketResult.Contents</p>
</td>
</tr>
<tr id="obs_04_0022__row30462839"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p51570899">LastModified</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p16493287">Time (UTC) when an object was last modified</p>
<p id="obs_04_0022__p14221862">Type: date</p>
<p id="obs_04_0022__p60887900">Parent: ListBucketResult.Contents</p>
</td>
</tr>
<tr id="obs_04_0022__row11120194"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p28320555">Marker</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p12263624">Marker for the position from which objects in a bucket will be listed</p>
<p id="obs_04_0022__p43263758">Type: string</p>
<p id="obs_04_0022__p53829506">Parent: ListBucketResult</p>
</td>
</tr>
<tr id="obs_04_0022__row14703509"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p50133572">NextMarker</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p34287556">A marker for the last returned object in the list. <strong id="obs_04_0022__b18730125131318">NextMarker</strong> is returned when not all the objects are listed. You can set the <strong id="obs_04_0022__b1654312581147">Marker</strong> value to list the remaining objects in follow-up requests.</p>
<p id="obs_04_0022__p40152554">Type: string</p>
<p id="obs_04_0022__p25828669">Parent: ListBucketResult</p>
</td>
</tr>
<tr id="obs_04_0022__row31131430"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p38617862">MaxKeys</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p41039090">Maximum number of objects returned</p>
<p id="obs_04_0022__p33807497">Type: string</p>
<p id="obs_04_0022__p35832019">Parent: ListBucketResult</p>
</td>
</tr>
<tr id="obs_04_0022__row54052723"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p16194462">Name</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p36683058">Name of the requested bucket</p>
<p id="obs_04_0022__p61712066">Type: string</p>
<p id="obs_04_0022__p18537685">Parent: ListBucketResult</p>
</td>
</tr>
<tr id="obs_04_0022__row32621445"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p25091397">Owner</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p19137257">User information, including the domain ID and name of the object owner</p>
<p id="obs_04_0022__p38017588">Type: XML</p>
<p id="obs_04_0022__p6613978">Parent: ListBucketResult.Contents</p>
</td>
</tr>
<tr id="obs_04_0022__row744613713302"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p1173362419303">DisplayName</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p1733724143013">Name of the object owner</p>
<p id="obs_04_0022__p1573312240308">Type: string</p>
<p id="obs_04_0022__p1473382403014">Parent: ListBucketResult.Contents.Owner</p>
</td>
</tr>
<tr id="obs_04_0022__row59525802"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p56860664">Prefix</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p1261204118586">Prefix of an object name. Only objects whose names have this prefix are listed.</p>
<p id="obs_04_0022__p42311111">Type: string</p>
<p id="obs_04_0022__p45255687">Parent: ListBucketResult</p>
</td>
</tr>
<tr id="obs_04_0022__row4647999"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p40943623">Size</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p28099143">Object size in bytes</p>
<p id="obs_04_0022__p51565700">Type: string</p>
<p id="obs_04_0022__p61438120">Parent: ListBucketResult.Contents</p>
</td>
</tr>
<tr id="obs_04_0022__row16072172"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.1 "><p id="obs_04_0022__p26777569">StorageClass</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.3.2.3.1.2 "><p id="obs_04_0022__p21499466">Storage class of an object</p>
<p id="obs_04_0022__p59277470">Type: string</p>
<p id="obs_04_0022__p63735184">Value options: <strong id="obs_04_0022__b737918316485">STANDARD</strong>, <strong id="obs_04_0022__b235013333486">WARM</strong>, <strong id="obs_04_0022__b2780535164819">COLD</strong></p>
<p id="obs_04_0022__p36745745">Parent: ListBucketResult.Contents</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0022__table62276250" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Elements in the response message for listing multi-version objects.</caption><thead align="left"><tr id="obs_04_0022__row7159011"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.9.4.2.3.1.1"><p id="obs_04_0022__p43009039"><strong id="obs_04_0022__b198031973496">Element</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.9.4.2.3.1.2"><p id="obs_04_0022__p13750605"><strong id="obs_04_0022__b20215311124912">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0022__row24970367"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p9333837">ListVersionsResult</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p17843336">Container for the list of objects (including objects with multiple version IDs)</p>
<p id="obs_04_0022__p26372297">Type: container</p>
</td>
</tr>
<tr id="obs_04_0022__row36024087"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p32269923">Name</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p63726931">Bucket name</p>
<p id="obs_04_0022__p36671468">Type: string</p>
<p id="obs_04_0022__p61607759">Parent: ListVersionsResult</p>
</td>
</tr>
<tr id="obs_04_0022__row17598926"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p16226888">Prefix</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p39309571">Prefix of an object name. Only objects whose names have this prefix are listed. Type: string</p>
<p id="obs_04_0022__p18241824">Parent: ListVersionsResult</p>
</td>
</tr>
<tr id="obs_04_0022__row29958695"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p10735194">KeyMarker</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p64244423">Marker for the object key from which objects will be listed</p>
<p id="obs_04_0022__p41328898">Type: string</p>
<p id="obs_04_0022__p36415764">Parent: ListVersionsResult</p>
</td>
</tr>
<tr id="obs_04_0022__row59306422"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p39090871">VersionIdMarker</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p12243948"><span style="color:#676A6C;">Object version ID to start with when objects are listed</span></p>
<p id="obs_04_0022__p43086669">Type: string</p>
<p id="obs_04_0022__p52235709">Parent: ListVersionsResult</p>
</td>
</tr>
<tr id="obs_04_0022__row359340"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p29106612">NextKeyMarker</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p8825356">Key marker for the last returned object in the list. <strong id="obs_04_0022__b900848008101353">NextKeyMarker</strong> is returned when not all the objects are listed. You can set the <strong id="obs_04_0022__b1094420250101358">KeyMarker</strong> value to list the remaining objects in follow-up requests.</p>
<p id="obs_04_0022__p12319341">Type: string</p>
<p id="obs_04_0022__p43765212">Parent: ListVersionsResult</p>
</td>
</tr>
<tr id="obs_04_0022__row58342593"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p28129593">NextVersionIdMarker</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p63904574">Version ID marker for the last returned object in the list. <strong id="obs_04_0022__b1324079436101422">NextVersionIdMarker</strong> is returned when not all the objects are listed. You can set the <strong id="obs_04_0022__b1708349606101428">VersionIdMarker</strong> value to list the remaining objects in follow-up requests.</p>
<p id="obs_04_0022__p38270256">Type: string</p>
<p id="obs_04_0022__p8887991">Parent: ListVersionsResult</p>
</td>
</tr>
<tr id="obs_04_0022__row12883059"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p36894838">MaxKeys</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p35691873">Maximum number of objects returned</p>
<p id="obs_04_0022__p52791405">Type: string</p>
<p id="obs_04_0022__p5360605">Parent: ListVersionsResult</p>
</td>
</tr>
<tr id="obs_04_0022__row48245449"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p15567264">IsTruncated</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p52988892">Indicates whether the returned list of objects is truncated. The value <strong id="obs_04_0022__b6466053182618">true</strong> indicates that the list was truncated and <strong id="obs_04_0022__b19467253172613">false</strong> indicates that the list was not truncated.</p>
<p id="obs_04_0022__p7137988">Type: boolean</p>
<p id="obs_04_0022__p64241893">Parent: ListVersionsResult</p>
</td>
</tr>
<tr id="obs_04_0022__row41306130"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p57462200">Version</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p23926623">Container of version information</p>
<p id="obs_04_0022__p14013018">Type: container</p>
<p id="obs_04_0022__p59008302">Parent: ListVersionsResult</p>
</td>
</tr>
<tr id="obs_04_0022__row61312677"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p270916">DeleteMarker</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p21944224">Container for objects with delete markers</p>
<p id="obs_04_0022__p63280288">Type: container</p>
<p id="obs_04_0022__p32651680">Parent: ListVersionsResult</p>
</td>
</tr>
<tr id="obs_04_0022__row25429665"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p46536979">Key</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p11398941">Object name</p>
<p id="obs_04_0022__p35481611">Type: string</p>
<p id="obs_04_0022__p50899048">Parent: ListVersionsResult.Version | ListVersionsResult.DeleteMarker</p>
</td>
</tr>
<tr id="obs_04_0022__row55438253"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p61313532">VersionId</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p340191">Object version ID</p>
<p id="obs_04_0022__p3061724">Type: string</p>
<p id="obs_04_0022__p27555519">Parent: ListVersionsResult.Version | ListVersionsResult.DeleteMarker</p>
</td>
</tr>
<tr id="obs_04_0022__row46673081"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p22423198">IsLatest</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p4339764">Whether the object is the latest version. If the parameter value is <strong id="obs_04_0022__b1087241247101524">true</strong>, the object is the latest version.</p>
<p id="obs_04_0022__p39057881">Type: boolean</p>
<p id="obs_04_0022__p15976610">Parent: ListVersionsResult.Version | ListVersionsResult.DeleteMarker</p>
</td>
</tr>
<tr id="obs_04_0022__row9571770"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p37115937">LastModified</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p53600883">Time (UTC) when an object was last modified</p>
<p id="obs_04_0022__p12645905">Type: date</p>
<p id="obs_04_0022__p46704282">Parent: ListVersionsResult.Version | ListVersionsResult.DeleteMarker</p>
</td>
</tr>
<tr id="obs_04_0022__row17685361"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p23228146">ETag</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p2431675">Base64-encoded 128-bit MD5 digest of an object. ETag is the unique identifier of the object content. It can be used to determine whether the object content is changed. The actual ETag is the hash value of the object. For example, if the ETag value is <strong id="obs_04_0022__b101301544008">A</strong> when an object is uploaded, but this value has changed to <strong id="obs_04_0022__b51301044208">B</strong> when the object is downloaded, it indicates that the object content has been changed. The ETag reflects changes to the object content, rather than the object metadata. An uploaded object or copied object has a unique ETag after being encrypted using MD5.</p>
<p id="obs_04_0022__p21885083">Type: string</p>
<p id="obs_04_0022__p62748021">Parent: ListVersionsResult.Version</p>
</td>
</tr>
<tr id="obs_04_0022__row7498940153710"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p1849817401375">Type</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p4498164083719">Object type. This parameter is returned when the object type is not <strong id="obs_04_0022__b0989173313013">Normal</strong>.</p>
<p id="obs_04_0022__p20721852153713">Type: string</p>
<p id="obs_04_0022__p147285113816">Parent: ListVersionsResult.Version</p>
</td>
</tr>
<tr id="obs_04_0022__row27861284"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p42171530">Size</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p60450740">Object size in bytes</p>
<p id="obs_04_0022__p7185750">Type: string</p>
<p id="obs_04_0022__p64671754">Parent: ListVersionsResult.Version</p>
</td>
</tr>
<tr id="obs_04_0022__row45174882"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p35286822">Owner</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p39660363">User information, including the domain ID and name of the object owner</p>
<p id="obs_04_0022__p21398953">Type: container</p>
<p id="obs_04_0022__p58372857">Parent: ListVersionsResult.Version | ListVersionsResult.DeleteMarker</p>
</td>
</tr>
<tr id="obs_04_0022__row55593666"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p6793103">ID</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p13370489">Domain ID of the object owner</p>
<p id="obs_04_0022__p53225540">Type: string</p>
<p id="obs_04_0022__p9267815">Parent: ListVersionsResult.Version.Owner | ListVersionsResult.DeleteMarker.Owner</p>
</td>
</tr>
<tr id="obs_04_0022__row55364622718"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p6542462276">DisplayName</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p1554154616279">Name of the object owner</p>
<p id="obs_04_0022__p1491819582284">Type: string</p>
<p id="obs_04_0022__p187611034102914">Parent: ListVersionsResult.Version.Owner | ListVersionsResult.DeleteMarker.Owner</p>
</td>
</tr>
<tr id="obs_04_0022__row26394605"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p57588233">StorageClass</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p34135322">Storage class of an object</p>
<p id="obs_04_0022__p38782450">Type: string</p>
<p id="obs_04_0022__p983512824220">Value options: <strong id="obs_04_0022__b383617319217">STANDARD</strong>, <strong id="obs_04_0022__b8836133192117">WARM</strong>, <strong id="obs_04_0022__b1183717317215">COLD</strong></p>
<p id="obs_04_0022__p13497736">Parent: ListVersionsResult.Version</p>
</td>
</tr>
<tr id="obs_04_0022__row54370765"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p41955857">CommonPrefixes</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p42981220">Group information. If you specify a delimiter in the request, the response contains group information in <strong id="obs_04_0022__b1975595415339">CommonPrefixes</strong>.</p>
<p id="obs_04_0022__p51286668">Type: container</p>
<p id="obs_04_0022__p58926833">Parent: ListVersionsResult</p>
</td>
</tr>
<tr id="obs_04_0022__row60579452"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="obs_04_0022__p7988560">Prefix</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="obs_04_0022__p43093617">Indicates a different prefix in the group information in <strong id="obs_04_0022__b25360927">CommonPrefixes</strong>.</p>
<p id="obs_04_0022__p52298233">Type: string</p>
<p id="obs_04_0022__p922054">Parent: ListVersionsResult.CommonPrefixes</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0022__section22989369"><h4 class="sectiontitle">Error Responses</h4><p id="obs_04_0022__p7577527">No special error responses are returned. For details about error responses, see <a href="obs_04_0115.html#obs_04_0115__d0e843">Table 2</a>.</p>
</div>
<div class="section" id="obs_04_0022__section4967514913"><h4 class="sectiontitle">Sample Request: Listing All Objects</h4><div class="codecoloring" codetype="Xml" id="obs_04_0022__screen26315321216"><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>/<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>02:28:25<span class="w"> </span>GMT
Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEBQQCEC:KiyoYze4pmRNPYfmlXBfRTVxt8c=
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0022__section61601145011"><h4 class="sectiontitle">Sample Response: Listing All Objects</h4><div class="codecoloring" codetype="Xml" id="obs_04_0022__screen1022615115320"><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></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>BF260000016435D34E379ABD93320CB9
x-obs-id-2:<span class="w"> </span>32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSXiN7GPL/yXM6OSBaYCUV1zcY5OelWp
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>02:23:30<span class="w"> </span>GMT
Content-Length:<span class="w"> </span>586
<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;ListBucketResult</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;Name&gt;</span>examplebucket<span class="nt">&lt;/Name&gt;</span>
<span class="w"> </span><span class="nt">&lt;Prefix/&gt;</span>
<span class="w"> </span><span class="nt">&lt;Marker/&gt;</span>
<span class="w"> </span><span class="nt">&lt;MaxKeys&gt;</span>1000<span class="nt">&lt;/MaxKeys&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;Contents&gt;</span>
<span class="w"> </span><span class="nt">&lt;Key&gt;</span>object001<span class="nt">&lt;/Key&gt;</span>
<span class="w"> </span><span class="nt">&lt;LastModified&gt;</span>2015-07-01T00:32:16.482Z<span class="nt">&lt;/LastModified&gt;</span>
<span class="w"> </span><span class="nt">&lt;ETag&gt;</span>&quot;2fa3bcaaec668adc5da177e67a122d7c&quot;<span class="nt">&lt;/ETag&gt;</span>
<span class="w"> </span><span class="nt">&lt;Size&gt;</span>12041<span class="nt">&lt;/Size&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;DisplayName&gt;</span>ObjectOwnerName<span class="nt">&lt;/DisplayName&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;/Contents&gt;</span>
<span class="nt">&lt;/ListBucketResult&gt;</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0022__section535111413214"><h4 class="sectiontitle">Sample Request: Listing Some Objects</h4><p id="obs_04_0022__p1693585343617">Assume that you have a bucket <strong id="obs_04_0022__b7597532384">examplebucket</strong> that contains objects <strong id="obs_04_0022__b89541836114117">newfile</strong>, <strong id="obs_04_0022__b658374724117">obj001</strong>, <strong id="obs_04_0022__b0336205244115">obj002</strong>, and <strong id="obs_04_0022__b04067234214">obs001</strong>. If you want to list only object <strong id="obs_04_0022__b136005343811">obj002</strong>, the request message is as follows:</p>
<pre class="screen" id="obs_04_0022__screen11516231145">GET /?marker=obj001&amp;prefix=obj HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.<em id="obs_04_0022__i14163125618202">region</em>.example.com
Accept: */*
Date: WED, 01 Jul 2015 02:28:25 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:KiyoYze4pmRNPYfmlXBfRTVxt8c=</pre>
</div>
<div class="section" id="obs_04_0022__section76081155815"><h4 class="sectiontitle">Sample Response: Listing Some Objects</h4><div class="codecoloring" codetype="Xml" id="obs_04_0022__screen1041419535420"><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></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>BF260000016435D758FBA857E0801874
x-obs-id-2:<span class="w"> </span>32AAAQAAEAABAAAQAAEAABAAAQAAEAABCShn/xAyk/xHBX6qgGSB36WXrbco0X80
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>02:29:48<span class="w"> </span>GMT
Content-Length:<span class="w"> </span>707
<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;ListBucketResult</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="nt">&lt;Name&gt;</span>examplebucket<span class="nt">&lt;/Name&gt;</span>
<span class="nt">&lt;Prefix&gt;</span>obj<span class="nt">&lt;/Prefix&gt;</span>
<span class="nt">&lt;Marker&gt;</span>obj001<span class="nt">&lt;/Marker&gt;</span>
<span class="nt">&lt;MaxKeys&gt;</span>1000<span class="nt">&lt;/MaxKeys&gt;</span>
<span class="nt">&lt;IsTruncated&gt;</span>false<span class="nt">&lt;/IsTruncated&gt;</span>
<span class="w"> </span><span class="nt">&lt;Contents&gt;</span>
<span class="w"> </span><span class="nt">&lt;Key&gt;</span>obj002<span class="nt">&lt;/Key&gt;</span>
<span class="w"> </span><span class="nt">&lt;LastModified&gt;</span>2015-07-01T02:11:19.775Z<span class="nt">&lt;/LastModified&gt;</span>
<span class="w"> </span><span class="nt">&lt;ETag&gt;</span>&quot;a72e382246ac83e86bd203389849e71d&quot;<span class="nt">&lt;/ETag&gt;</span>
<span class="w"> </span><span class="nt">&lt;Size&gt;</span>9<span class="nt">&lt;/Size&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;DisplayName&gt;</span>ObjectOwnerName<span class="nt">&lt;/DisplayName&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;/Contents&gt;</span>
<span class="nt">&lt;/ListBucketResult&gt;</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0022__section10211101623018"><h4 class="sectiontitle">Sample Request: Listing Object Versions</h4><div class="codecoloring" codetype="Xml" id="obs_04_0022__screen8484163863919"><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>/?versions<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>02:29:45<span class="w"> </span>GMT
Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEBQQCEC:iZeDESIMxBK2YODk7vIeVpyO8DI=
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0022__section16842103705414"><h4 class="sectiontitle">Sample Response: Listing Object Versions</h4><div class="codecoloring" codetype="Xml" id="obs_04_0022__screen649271117557"><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>BF260000016435D758FBA857E0801874
x-obs-id-2:<span class="w"> </span>32AAAQAAEAABAAAQAAEAABAAAQAAEAABCShn/xAyk/xHBX6qgGSB36WXrbco0X80
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>02:29:48<span class="w"> </span>GMT
Content-Length:<span class="w"> </span>707
<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;ListVersionsResult</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;Name&gt;</span>bucket02<span class="nt">&lt;/Name&gt;</span>
<span class="w"> </span><span class="nt">&lt;Prefix/&gt;</span>
<span class="w"> </span><span class="nt">&lt;KeyMarker/&gt;</span>
<span class="w"> </span><span class="nt">&lt;VersionIdMarker/&gt;</span>
<span class="w"> </span><span class="nt">&lt;MaxKeys&gt;</span>1000<span class="nt">&lt;/MaxKeys&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;Version&gt;</span>
<span class="w"> </span><span class="nt">&lt;Key&gt;</span>object001<span class="nt">&lt;/Key&gt;</span>
<span class="w"> </span><span class="nt">&lt;VersionId&gt;</span>00011000000000013F16000001643A22E476FFFF9046024ECA3655445346485a<span class="nt">&lt;/VersionId&gt;</span>
<span class="w"> </span><span class="nt">&lt;IsLatest&gt;</span>true<span class="nt">&lt;/IsLatest&gt;</span>
<span class="w"> </span><span class="nt">&lt;LastModified&gt;</span>2015-07-01T00:32:16.482Z<span class="nt">&lt;/LastModified&gt;</span>
<span class="w"> </span><span class="nt">&lt;ETag&gt;</span>&quot;2fa3bcaaec668adc5da177e67a122d7c&quot;<span class="nt">&lt;/ETag&gt;</span>
<span class="w"> </span><span class="nt">&lt;Size&gt;</span>12041<span class="nt">&lt;/Size&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;DisplayName&gt;</span>ObjectOwnerName<span class="nt">&lt;/DisplayName&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;/Version&gt;</span>
<span class="nt">&lt;/ListVersionsResult&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_0019.html">Operations on Buckets</a></div>
</div>
</div>
View Git Blame Copy Permalink