forked from docs/doc-exports
zhangyue
7d2a7ec198
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com> Co-authored-by: zhangyue <zhangyue164@huawei.com> Co-committed-by: zhangyue <zhangyue164@huawei.com>
1063 lines
94 KiB
HTML
1063 lines
94 KiB
HTML
<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 of the following parameters in the request: <strong id="obs_04_0022__b1255220486101028">prefix</strong>, <strong id="obs_04_0022__b1463130847101028">marker</strong>, <strong id="obs_04_0022__b649741726101028">max-keys</strong>, and <strong id="obs_04_0022__b12291995101028">delimiter</strong>, OBS returns a list of objects based on the semantics specified in <a href="#obs_04_0022__table1745420588">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__table1745420588">Table 1</a> describes the parameters.</p>
|
|
|
|
<div class="tablenoborder"><a name="obs_04_0022__table1745420588"></a><a name="table1745420588"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0022__table1745420588" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="obs_04_0022__row1474519205813"><th align="left" class="cellrowborder" valign="top" width="13.3%" id="mcps1.3.4.3.2.5.1.1"><p id="obs_04_0022__p5745122018820"><strong id="obs_04_0022__b665614535100">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="8.24%" id="mcps1.3.4.3.2.5.1.2"><p id="obs_04_0022__p96319378813"><strong id="obs_04_0022__b8879123798">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="8.9%" id="mcps1.3.4.3.2.5.1.3"><p id="obs_04_0022__p152638494815"><strong id="obs_04_0022__b5351105417106">Mandatory (Yes/No)</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="69.56%" id="mcps1.3.4.3.2.5.1.4"><p id="obs_04_0022__p77453201285"><strong id="obs_04_0022__b7168527111615">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="obs_04_0022__row1574514205818"><td class="cellrowborder" valign="top" width="13.3%" headers="mcps1.3.4.3.2.5.1.1 "><p id="obs_04_0022__p1674512208817">prefix</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.24%" headers="mcps1.3.4.3.2.5.1.2 "><p id="obs_04_0022__p106393714812">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.9%" headers="mcps1.3.4.3.2.5.1.3 "><p id="obs_04_0022__p112633491781">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.56%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0022__p4277941144817"><strong id="obs_04_0022__b27543107083758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p171699714185">Name prefix that the objects to be listed must contain.</p>
|
|
<p id="obs_04_0022__p102471712155611"><strong id="obs_04_0022__b724751210569">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p162471312125611">The value must comply with the format of the object name.</p>
|
|
<p id="obs_04_0022__p524731220564"><strong id="obs_04_0022__b112473125565">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p52474121566">The value can contain 1 to 1,024 characters.</p>
|
|
<p id="obs_04_0022__p9247101213565"><strong id="obs_04_0022__b15247161225611">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p162471126565">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row127455201819"><td class="cellrowborder" valign="top" width="13.3%" headers="mcps1.3.4.3.2.5.1.1 "><p id="obs_04_0022__p1074518201283">marker</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.24%" headers="mcps1.3.4.3.2.5.1.2 "><p id="obs_04_0022__p56303712814">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.9%" headers="mcps1.3.4.3.2.5.1.3 "><p id="obs_04_0022__p1426318491780">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.56%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0022__p136841060202"><strong id="obs_04_0022__b201593769883758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p18255183715132">Name of the object to start with when listing objects in a bucket. All objects following this object are listed in lexicographical order by object name.</p>
|
|
<p id="obs_04_0022__p1684196162012"><strong id="obs_04_0022__b16919426271">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p153420111718">This parameter is used only for listing non-versioned objects.</p>
|
|
<p id="obs_04_0022__p5684166202"><strong id="obs_04_0022__b81879970784032">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p16130111916335">The value can contain 1 to 1,024 characters.</p>
|
|
<p id="obs_04_0022__p1684269202"><strong id="obs_04_0022__b191866327084125">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p158967364518">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row1974582016817"><td class="cellrowborder" valign="top" width="13.3%" headers="mcps1.3.4.3.2.5.1.1 "><p id="obs_04_0022__p16745320488">max-keys</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.24%" headers="mcps1.3.4.3.2.5.1.2 "><p id="obs_04_0022__p207452201985">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.9%" headers="mcps1.3.4.3.2.5.1.3 "><p id="obs_04_0022__p16263124914811">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.56%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0022__p980719503112"><strong id="obs_04_0022__b1840419247291">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p1388762511322">The maximum number of objects returned in the response in alphabetical order</p>
|
|
<p id="obs_04_0022__p1487191415453"><strong id="obs_04_0022__b248731419455">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p19494114844512">None</p>
|
|
<p id="obs_04_0022__p8906132119271"><strong id="obs_04_0022__b19949173312293">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p1056062191815">The value ranges from <strong id="obs_04_0022__b4594153502912">1</strong> to <strong id="obs_04_0022__b9594635112912">1000</strong>. If the specified value is greater than <strong id="obs_04_0022__b9594435142912">1000</strong>, only 1,000 objects are returned.</p>
|
|
<p id="obs_04_0022__p169064213277"><strong id="obs_04_0022__b719162015216">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p677994211178">1000</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row12745920783"><td class="cellrowborder" valign="top" width="13.3%" headers="mcps1.3.4.3.2.5.1.1 "><p id="obs_04_0022__p147453201382">delimiter</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.24%" headers="mcps1.3.4.3.2.5.1.2 "><p id="obs_04_0022__p86310378819">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.9%" headers="mcps1.3.4.3.2.5.1.3 "><p id="obs_04_0022__p62635491386">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.56%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0022__p1395912112014"><strong id="obs_04_0022__b212349457583758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p6745320981">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__b1300763094">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__b1847284899">CommonPrefixes</strong>.</p>
|
|
<p id="obs_04_0022__p107451420186">For example, there are three objects (<strong id="obs_04_0022__b1077495765">abcd</strong>, <strong id="obs_04_0022__b255604116">abcde</strong>, and <strong id="obs_04_0022__b732826260">bbcde</strong>) in a bucket. If <strong id="obs_04_0022__b446697814">delimiter</strong> is set to <strong id="obs_04_0022__b208637460">d</strong> and <strong id="obs_04_0022__b1206039562">prefix</strong> is set to <strong id="obs_04_0022__b566411587">a</strong>, objects <strong id="obs_04_0022__b222939999">abcd</strong> and <strong id="obs_04_0022__b622011754">abcde</strong> are grouped into a <strong id="obs_04_0022__b1995271282">CommonPrefixes</strong> with <strong id="obs_04_0022__b1222255435">abcd</strong> as the prefix. If only <strong id="obs_04_0022__b674392130">delimiter</strong> is set to <strong id="obs_04_0022__b197906081">d</strong>, objects <strong id="obs_04_0022__b780450214">abcd</strong> and <strong id="obs_04_0022__b701140330">abcde</strong> are grouped into a <strong id="obs_04_0022__b1598475322">CommonPrefixes</strong> with <strong id="obs_04_0022__b1933161099">abcd</strong> as the prefix, and <strong id="obs_04_0022__b568017380">bbcde</strong> is grouped separately into another <strong id="obs_04_0022__b1513536586">CommonPrefixes</strong> with <strong id="obs_04_0022__b2068001824">bbcd</strong> as the prefix.</p>
|
|
<p id="obs_04_0022__p67453201181">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__b1826380343">[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__p1839571220206"><strong id="obs_04_0022__b167904932910">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p351300123612">None</p>
|
|
<p id="obs_04_0022__p12395191222018"><strong id="obs_04_0022__b87099802584032">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p1857718473613">The value can contain 1 to 1,024 characters.</p>
|
|
<p id="obs_04_0022__p163951412162011"><strong id="obs_04_0022__b134598886784125">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p31484278355">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row874662019814"><td class="cellrowborder" valign="top" width="13.3%" headers="mcps1.3.4.3.2.5.1.1 "><p id="obs_04_0022__p157461720382">key-marker</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.24%" headers="mcps1.3.4.3.2.5.1.2 "><p id="obs_04_0022__p06317371184">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.9%" headers="mcps1.3.4.3.2.5.1.3 "><p id="obs_04_0022__p826313491287">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.56%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0022__p8853201422016"><strong id="obs_04_0022__b31068198383758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p73891950103815">Object name to start with when listing object versions in a bucket. All object versions following the specified value are listed in lexicographical order by object name.</p>
|
|
<p id="obs_04_0022__p685319146208"><strong id="obs_04_0022__b9621105442919">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p156941420101618">This field is used only for listing versioned objects.</p>
|
|
<p id="obs_04_0022__p1785381413201"><strong id="obs_04_0022__b195975535884032">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p1556612161611">The value of <strong id="obs_04_0022__b128611582291">NextKeyMarker</strong> in the response body of the last request</p>
|
|
<p id="obs_04_0022__p17853114102016"><strong id="obs_04_0022__b117321313384125">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p107461920986">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row27463202820"><td class="cellrowborder" valign="top" width="13.3%" headers="mcps1.3.4.3.2.5.1.1 "><p id="obs_04_0022__p2074612011817">version-id-marker</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.24%" headers="mcps1.3.4.3.2.5.1.2 "><p id="obs_04_0022__p3631337685">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.9%" headers="mcps1.3.4.3.2.5.1.3 "><p id="obs_04_0022__p326324914816">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.56%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0022__en-us_topic_0262985931_p1182110183220"><strong id="obs_04_0022__b671154312210">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__en-us_topic_0262985931_en-us_topic_0142814655_p1514345719440">Version ID to start with when listing objects in a bucket. All objects following the specified value are listed in lexicographical order by object name and version ID. This parameter must be used together with <strong id="obs_04_0022__b736541075020">key_marker</strong>. A maximum of 1,000 objects can be returned at a time. <strong id="obs_04_0022__b11553124218303">key_marker</strong> specifies the object name, and <strong id="obs_04_0022__b65541242143015">version_id_marker</strong> specifies the version of the specified object.</p>
|
|
<p id="obs_04_0022__en-us_topic_0262985931_p118215053210"><strong id="obs_04_0022__b1481664417211">Restrictions</strong>:</p>
|
|
<ul id="obs_04_0022__en-us_topic_0262985931_ul7310173412190"><li id="obs_04_0022__en-us_topic_0262985931_li163116341198">This parameter is only used for listing objects with multiple versions.</li><li id="obs_04_0022__en-us_topic_0262985931_li9763824204711">If the value of <strong id="obs_04_0022__b117991051123017">version_id_marker</strong> is not a version ID that belongs to the object specified by <strong id="obs_04_0022__b14799105113014">key_marker</strong>, <strong id="obs_04_0022__b1679914519301">version_id_marker</strong> does not take effect.</li></ul>
|
|
<p id="obs_04_0022__en-us_topic_0262985931_p38210063214"><strong id="obs_04_0022__b9884164817218">Value range</strong>:</p>
|
|
<p id="obs_04_0022__en-us_topic_0262985931_p666815340174">Object version ID, that is, the value of <strong id="obs_04_0022__b96661049155317">nextVersionIdMarker</strong> in the response body of the last request</p>
|
|
<p id="obs_04_0022__en-us_topic_0262985931_p88211805328"><strong id="obs_04_0022__b1362948143219">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p1761773318390">None</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"><?xml version="1.0" encoding="UTF-8" standalone="yes"?>
|
|
<ListBucketResult xmlns="http://obs.otc.t-systems.com/doc/2016-01-01/">
|
|
<Name>bucket_name</Name>
|
|
<Prefix></Prefix>
|
|
<Marker></Marker>
|
|
<MaxKeys>1000</MaxKeys>
|
|
<IsTruncated>false</IsTruncated>
|
|
<Contents>
|
|
<Key>object_name</Key>
|
|
<LastModified>2022-11-11T11:11:11.111Z</LastModified>
|
|
<ETag>"37f80ab36f7c19abe8250e5e00123456"</ETag>
|
|
<Size>55555</Size>
|
|
<Owner>
|
|
<ID>e8df38eb4e4f4f148e06d8db50123456</ID>
|
|
</Owner>
|
|
<StorageClass>STANDARD</StorageClass>
|
|
</Contents>
|
|
</ListBucketResult></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__table15575145617302">Table 2</a>.</p>
|
|
|
|
<div class="tablenoborder"><a name="obs_04_0022__table15575145617302"></a><a name="table15575145617302"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0022__table15575145617302" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response elements</caption><thead align="left"><tr id="obs_04_0022__row1457565633011"><th align="left" class="cellrowborder" valign="top" width="20.41%" id="mcps1.3.9.3.2.4.1.1"><p id="obs_04_0022__p115761656153013"><strong id="obs_04_0022__b1512034513217">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15.06%" id="mcps1.3.9.3.2.4.1.2"><p id="obs_04_0022__p425411113116"><strong id="obs_04_0022__b14122461023">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="64.53%" id="mcps1.3.9.3.2.4.1.3"><p id="obs_04_0022__p135761556203018">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="obs_04_0022__row12576956193014"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p7576175618301">ListBucketResult</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p725491119318">XML</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p612414316205"><strong id="obs_04_0022__b32543601283758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p16576165613011">A list of objects in a bucket</p>
|
|
<p id="obs_04_0022__p6124184316209"><strong id="obs_04_0022__b1090431770">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p18832122111412">None</p>
|
|
<p id="obs_04_0022__p11124543112013"><strong id="obs_04_0022__b178872497084032">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p23621361734">None</p>
|
|
<p id="obs_04_0022__p312454322019"><strong id="obs_04_0022__b61576196984125">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p2796986315">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row2057675613012"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p35769566307">Contents</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p825471110317">XML</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p57551645182015"><strong id="obs_04_0022__b177629481583758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p1557610569309">Object metadata</p>
|
|
<p id="obs_04_0022__p85761056103012">Parent: ListBucketResult</p>
|
|
<p id="obs_04_0022__p522815141631"><strong id="obs_04_0022__b132284143311">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p1722814141319">None</p>
|
|
<p id="obs_04_0022__p1022820142319"><strong id="obs_04_0022__b152284147311">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p1822810141231">None</p>
|
|
<p id="obs_04_0022__p12228714832"><strong id="obs_04_0022__b122841419319">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p1522811147312">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row557655613019"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p957611568300">CommonPrefixes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p92541611113116">XML</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p1454474802015"><strong id="obs_04_0022__b169254819483758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p95768568301">Group information. If you specify a delimiter in the request, the response contains group information in <strong id="obs_04_0022__b2026213216315">CommonPrefixes</strong>.</p>
|
|
<p id="obs_04_0022__p145761756193014">Parent: ListBucketResult</p>
|
|
<p id="obs_04_0022__p1186913161312"><strong id="obs_04_0022__b15869171614314">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p16869131612310">None</p>
|
|
<p id="obs_04_0022__p15869141618318"><strong id="obs_04_0022__b886915165319">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p158691169314">None</p>
|
|
<p id="obs_04_0022__p786918164319"><strong id="obs_04_0022__b286914168311">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p128691161434">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row957695613304"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p20576195663011">Delimiter</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p12254711153118">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p165291637833"><strong id="obs_04_0022__b194643262583758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p145291337735">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__b997712353544">CommonPrefix</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__b16977123519542">CommonPrefix</strong>.</p>
|
|
<p id="obs_04_0022__p4529133711313">Assume that a bucket has objects <strong id="obs_04_0022__b3834168565">abcd</strong>, <strong id="obs_04_0022__b48348616567">abcde</strong>, and <strong id="obs_04_0022__b188344615615">bbcde</strong> in it. If <strong id="obs_04_0022__b208352065569">delimiter</strong> is set to <strong id="obs_04_0022__b1583520620566">d</strong> and <strong id="obs_04_0022__b1583510675617">prefix</strong> is set to <strong id="obs_04_0022__b483612611565">a</strong>, objects <strong id="obs_04_0022__b108365645611">abcd</strong> and <strong id="obs_04_0022__b2837136185613">abcde</strong> are grouped into a <strong id="obs_04_0022__b18837462566">commonPrefix</strong> with <strong id="obs_04_0022__b1583796115612">abcd</strong> as the prefix. If only <strong id="obs_04_0022__b13838156165618">delimiter</strong> is set to <strong id="obs_04_0022__b983836105620">d</strong>, objects <strong id="obs_04_0022__b12838466562">abcd</strong> and <strong id="obs_04_0022__b183910615611">abcde</strong> are grouped into a <strong id="obs_04_0022__b683912605615">commonPrefix</strong> with <strong id="obs_04_0022__b14840126155619">abcd</strong> as the prefix, and <strong id="obs_04_0022__b128401169569">bbcde</strong> is grouped separately into another <strong id="obs_04_0022__b38404665612">commonPrefix</strong> with <strong id="obs_04_0022__b118411969566">bbcd</strong> as the prefix.</p>
|
|
<p id="obs_04_0022__p3529137836">Parent: ListBucketResult</p>
|
|
<p id="obs_04_0022__p252963711311"><strong id="obs_04_0022__b175291337735">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p45291371938">None</p>
|
|
<p id="obs_04_0022__p152963718311"><strong id="obs_04_0022__b226540648">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p125291937937">The value can contain 1 to 1,024 characters.</p>
|
|
<p id="obs_04_0022__p952917377320"><strong id="obs_04_0022__b05291737534">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p135296371637">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row357785633015"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p557735618302">ETag</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p72541811163113">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p89121558172017"><strong id="obs_04_0022__b38363575083758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p95771056163017">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__b469524724">A</strong> when an object is uploaded, but this value has changed to <strong id="obs_04_0022__b101116552">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.</p>
|
|
<p id="obs_04_0022__p75771756173014">Parent: ListBucketResult.Contents</p>
|
|
<p id="obs_04_0022__p1591295842012"><strong id="obs_04_0022__b155811204310">Restriction</strong>:</p>
|
|
<p id="obs_04_0022__en-us_topic_0262986000_p823311034817">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__en-us_topic_0262986000_p03851145105715"><strong id="obs_04_0022__b1619593994">Value range</strong>:</p>
|
|
<p id="obs_04_0022__en-us_topic_0262986000_p51802744818">The value must contain 32 characters.</p>
|
|
<p id="obs_04_0022__p653010521163"><strong id="obs_04_0022__b207152411313">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p105301952369">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row20577155693012"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p165778564301">Type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p425471119319">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p5401181142116"><strong id="obs_04_0022__b91754978483758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p65776567303">Object type</p>
|
|
<p id="obs_04_0022__p14398154522710">Parent: ListBucketResult.Contents</p>
|
|
<p id="obs_04_0022__p19401101162119"><strong id="obs_04_0022__b102948281934">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p11541831101411">This parameter is returned when the object is not a <strong id="obs_04_0022__b1223917266915">Normal</strong> object.</p>
|
|
<p id="obs_04_0022__p1878018251043"><strong id="obs_04_0022__b47801525148">Value range</strong>:</p>
|
|
<ul id="obs_04_0022__ul108339275316"><li id="obs_04_0022__li168341721535">Normal: normal objects</li><li id="obs_04_0022__li118341828532">APPENDABLE: appendable objects</li></ul>
|
|
<p id="obs_04_0022__p18780192519410"><strong id="obs_04_0022__b9780102510420">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p117802255419">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row1657775613018"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p3577145683013">ID</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p1254161112314">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p1974735172113"><strong id="obs_04_0022__b122839010383758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p8577175603015">Domain ID of the object owner</p>
|
|
<p id="obs_04_0022__p135772564304">Parent: ListBucketResult.Contents.Owner</p>
|
|
<p id="obs_04_0022__p1674775192112"><strong id="obs_04_0022__b1626955674014">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p7989982211">None</p>
|
|
<p id="obs_04_0022__p11747165202112"><strong id="obs_04_0022__b123560149584032">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p10990992214"><a href="obs_04_0117.html">DomainId</a></p>
|
|
<p id="obs_04_0022__p107471452213"><strong id="obs_04_0022__b188872990884125">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p78531338162115">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row2577105693016"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p10577105612307">IsTruncated</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p1226036182612">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p516348112118"><strong id="obs_04_0022__b132035326983758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p1690174418512">Whether all results are returned in the response.</p>
|
|
<p id="obs_04_0022__p9577856183015">Parent: ListBucketResult</p>
|
|
<p id="obs_04_0022__p1516313815218"><strong id="obs_04_0022__b1834862539">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p103811412132220">None</p>
|
|
<p id="obs_04_0022__p816315822117"><strong id="obs_04_0022__b152497164884032">Value range</strong>:</p>
|
|
<ul id="obs_04_0022__ul181219360221"><li id="obs_04_0022__li5129361228"><strong id="obs_04_0022__b19660296020742">true</strong>: Not all results are returned.</li><li id="obs_04_0022__li111211368221"><strong id="obs_04_0022__b1021554414313">false</strong>: All results are returned.</li></ul>
|
|
<p id="obs_04_0022__p01632852110"><strong id="obs_04_0022__b126398929984125">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p139199523518">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row75781456103017"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p11578195614303">Key</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p1825514112314">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p19847193395017"><strong id="obs_04_0022__b47546215083758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p568755118152">Object name. An object is uniquely identified by an object name in a bucket. An object name is a complete path that does not contain the bucket name.</p>
|
|
<p id="obs_04_0022__p161571832192313">Parent: ListBucketResult.Contents</p>
|
|
<p id="obs_04_0022__p192389501818"><strong id="obs_04_0022__b45481711911">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p1441573799">None</p>
|
|
<p id="obs_04_0022__p198471833135015"><strong id="obs_04_0022__b1732153443">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p8926340131620">The value can contain 1 to 1,024 characters.</p>
|
|
<p id="obs_04_0022__p177021242861"><strong id="obs_04_0022__b189061151044">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p107023422618">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row85781956103019"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p19578956173015">LastModified</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p1225501118315">Date</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p17443121362118"><strong id="obs_04_0022__b23544091283758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p11578105615309">Time (UTC) when an object was last modified</p>
|
|
<p id="obs_04_0022__p1057885663013">Parent: ListBucketResult.Contents</p>
|
|
<p id="obs_04_0022__p144431913172115"><strong id="obs_04_0022__b1775014131815">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p6391542182417">The date is in the ISO8601 format.</p>
|
|
<p id="obs_04_0022__p182971759863">Example: <strong id="obs_04_0022__b20897611943">2018-01-01T00:00:00.000Z</strong></p>
|
|
<p id="obs_04_0022__p144431013152118"><strong id="obs_04_0022__b98639373984032">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p1456647714">None</p>
|
|
<p id="obs_04_0022__p193723477614"><strong id="obs_04_0022__b1411151312417">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p1737218473610">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row16578125614308"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p1457865615309">Marker</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p20255171115314">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p1785871021216"><strong id="obs_04_0022__b738495800">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p5858161017128">Name of the object to start with when listing objects in a bucket. All objects following this object are listed in lexicographical order by object name.</p>
|
|
<p id="obs_04_0022__p18581410181211">Assume that you have the following objects: <strong id="obs_04_0022__b5099567290742">test/a</strong>,<strong id="obs_04_0022__b14730946300742"> test/b</strong>, <strong id="obs_04_0022__b17732876590742">test/c</strong>, and <strong id="obs_04_0022__b9059229600742">test/d</strong>. If you specify <strong id="obs_04_0022__b3715369100742">test/b</strong> as the marker, <strong id="obs_04_0022__b17195994390742">test/c</strong> and <strong id="obs_04_0022__b20670108180742">test/d</strong> are returned.</p>
|
|
<p id="obs_04_0022__p976519176191">Parent: ListBucketResult</p>
|
|
<p id="obs_04_0022__p108581510151210"><strong id="obs_04_0022__b485831018123">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p58588102127">None</p>
|
|
<p id="obs_04_0022__p1085871051213"><strong id="obs_04_0022__b613850025">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p198581310131214">The value can contain 1 to 1,024 characters.</p>
|
|
<p id="obs_04_0022__p785817109121"><strong id="obs_04_0022__b685812101126">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p1685812105127">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row957875643013"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p65783569307">NextMarker</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p112559110316">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p11444618112110"><strong id="obs_04_0022__b143692464483758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p1257895612305">The last object in the returned list. This parameter is returned when not all the objects are listed. You can set the <strong id="obs_04_0022__b2000632873">Marker</strong> value to list the remaining objects in follow-up requests.</p>
|
|
<p id="obs_04_0022__p857845620302">Parent: ListBucketResult</p>
|
|
<p id="obs_04_0022__p13445131817219"><strong id="obs_04_0022__b1736634073">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p7634151417283">None</p>
|
|
<p id="obs_04_0022__p11956845154616"><strong id="obs_04_0022__b12775111110217">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p719744720464">An object name string</p>
|
|
<p id="obs_04_0022__p12646810166"><strong id="obs_04_0022__b11254713521">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p14647910368">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row9578155623014"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p35781256103018">MaxKeys</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p125541183116">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p054081314134"><strong id="obs_04_0022__b342575994">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p6540111361311">The maximum number of objects returned in the response in alphabetical order</p>
|
|
<p id="obs_04_0022__p8540151311319">Parent: ListBucketResult</p>
|
|
<p id="obs_04_0022__p185407138130"><strong id="obs_04_0022__b454010131132">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p85404130133">None</p>
|
|
<p id="obs_04_0022__p054051313135"><strong id="obs_04_0022__b1054071341314">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p254051319135">The value ranges from 1 to 1000. If a value larger than 1000 is specified, 1000 is used.</p>
|
|
<p id="obs_04_0022__p175400136131"><strong id="obs_04_0022__b65403132133">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p2540213121312">1000</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row1957815653015"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p1657895616305">Name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p2255111133112">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p175932043122711"><strong id="obs_04_0022__b2072909606">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p1059374342712">Bucket name</p>
|
|
<p id="obs_04_0022__p4593174322715">Parent: ListBucketResult</p>
|
|
<p id="obs_04_0022__p359354382712"><strong id="obs_04_0022__b175931643142719">Restrictions</strong>:</p>
|
|
<ul id="obs_04_0022__ul1559364311279"><li id="obs_04_0022__li359334322718">A bucket name must be unique across all accounts and regions.</li><li id="obs_04_0022__li15937433274">A bucket name:<ul id="obs_04_0022__ul1059315431279"><li id="obs_04_0022__li85936439273">Must be 3 to 63 characters long and start with a digit or letter. Lowercase letters, digits, hyphens (-), and periods (.) are allowed.</li><li id="obs_04_0022__li259310431276">Cannot be formatted as an IP address.</li><li id="obs_04_0022__li14593164312718">Cannot start or end with a hyphen (-) or period (.).</li><li id="obs_04_0022__li195931843152717">Cannot contain two consecutive periods (..), for example, <strong id="obs_04_0022__b2080061119101028">my..bucket</strong>.</li><li id="obs_04_0022__li10593164322714">Cannot contain a period (.) and a hyphen (-) adjacent to each other, for example, <strong id="obs_04_0022__b662977134101028">my-.bucket</strong> or <strong id="obs_04_0022__b1172147679101028">my.-bucket</strong>.</li></ul>
|
|
</li><li id="obs_04_0022__li1959317436273">If you repeatedly create buckets of the same name in the same region, no error will be reported and the bucket attributes comply with those set in the first creation request.</li></ul>
|
|
<p id="obs_04_0022__p20593204332714"><strong id="obs_04_0022__b115931433276">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p059304310272">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row957917564303"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p1657945617303">Owner</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p1825519115312">XML</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p668414263215"><strong id="obs_04_0022__b19111626083758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p657955613307">User information, including the domain ID and name of the object owner</p>
|
|
<p id="obs_04_0022__p1657995617306">Parent: ListBucketResult.Contents</p>
|
|
<p id="obs_04_0022__p5609175352812"><strong id="obs_04_0022__b66091453192815">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p1360995313289">None</p>
|
|
<p id="obs_04_0022__p7609175313289"><strong id="obs_04_0022__b136091853122815">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p186091653152812">None</p>
|
|
<p id="obs_04_0022__p1760975316285"><strong id="obs_04_0022__b5609105316286">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p10609115316282">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row557913566304"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p1757925643010">DisplayName</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p1425519113316">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p1461218290211"><strong id="obs_04_0022__b68714167383758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p13579105643017">Name of the object owner</p>
|
|
<p id="obs_04_0022__p568519542920">Parent: ListBucketResult.Contents.Owner</p>
|
|
<p id="obs_04_0022__p16272756172817"><strong id="obs_04_0022__b162721556152817">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p17272256112816">None</p>
|
|
<p id="obs_04_0022__p4272756142813"><strong id="obs_04_0022__b192729561286">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p1327215662815">None</p>
|
|
<p id="obs_04_0022__p0272956112817"><strong id="obs_04_0022__b1227210561281">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p7272856142810">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row05791563306"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p557910565304">Prefix</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p82551116311">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p115379992914"><strong id="obs_04_0022__b1885145010418">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p4537699298">Name prefix that the objects to be listed must contain.</p>
|
|
<p id="obs_04_0022__p145371399297">Assume that you have the following objects: <strong id="obs_04_0022__b15416495570742">logs/day1</strong>, <strong id="obs_04_0022__b5124067050742">logs/day2</strong>, <strong id="obs_04_0022__b21067492890742">logs/day3</strong>, and <strong id="obs_04_0022__b17821298240742">ExampleObject.jpg</strong>. If you specify <strong id="obs_04_0022__b7733609040742">logs/</strong> as the prefix, <strong id="obs_04_0022__b2114231500742">logs/day1</strong>, <strong id="obs_04_0022__b959283500742">logs/day2</strong>, and <strong id="obs_04_0022__b19174157280742">logs/day3</strong> will be returned. If you leave this parameter blank and there are also no other filters specified, all objects in the bucket will be returned.</p>
|
|
<p id="obs_04_0022__p553739202915">Parent: ListBucketResult</p>
|
|
<p id="obs_04_0022__p155376972920"><strong id="obs_04_0022__b85374912919">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p1253759132912">The prefix you specified must already exist in the bucket.</p>
|
|
<p id="obs_04_0022__p45371296295"><strong id="obs_04_0022__b153712917292">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p1537392292">The value can contain 1 to 1,024 characters.</p>
|
|
<p id="obs_04_0022__p25373919295"><strong id="obs_04_0022__b1253714922918">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p205379912293">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row13579156193013"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p105791556153019">Size</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p0255191113312">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p27836242295"><strong id="obs_04_0022__b182292185683758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p1783112432914">Object size in bytes</p>
|
|
<p id="obs_04_0022__p1378352416294">Parent: ListBucketResult.Contents</p>
|
|
<p id="obs_04_0022__p378342492915"><strong id="obs_04_0022__b13783162416296">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p11783524192918">None</p>
|
|
<p id="obs_04_0022__p1578322413291"><strong id="obs_04_0022__b878302412297">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p2783202417299">The value ranges from 0 TB to 48.8 TB, in bytes.</p>
|
|
<p id="obs_04_0022__p878392416292"><strong id="obs_04_0022__b137832244294">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p127831224132911">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row857935616309"><td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.9.3.2.4.1.1 "><p id="obs_04_0022__p95795566302">StorageClass</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.9.3.2.4.1.2 "><p id="obs_04_0022__p525501111313">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.53%" headers="mcps1.3.9.3.2.4.1.3 "><p id="obs_04_0022__p17501163832113"><strong id="obs_04_0022__b158052504883758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p557985613300">Storage class of an object.</p>
|
|
<p id="obs_04_0022__p058011563307">Parent: ListBucketResult.Contents</p>
|
|
<p id="obs_04_0022__p3501123812217"><strong id="obs_04_0022__b107371663517">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p1959313472293">None</p>
|
|
<p id="obs_04_0022__p1750115384219"><strong id="obs_04_0022__b169243464984032">Value range</strong>:</p>
|
|
<ul id="obs_04_0022__ul19969611105510"><li id="obs_04_0022__li17969811155513">STANDARD</li><li id="obs_04_0022__li18969191114553">WARM</li><li id="obs_04_0022__li796981115555">COLD</li></ul>
|
|
<p id="obs_04_0022__p14501153820214"><strong id="obs_04_0022__b65799640984125">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p2012134610295">None</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0022__table5997105283120" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Elements in the response message for listing versioned objects</caption><thead align="left"><tr id="obs_04_0022__row15997135217316"><th align="left" class="cellrowborder" valign="top" width="24.759999999999998%" id="mcps1.3.9.4.2.4.1.1"><p id="obs_04_0022__p179971252113110">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="11.65%" id="mcps1.3.9.4.2.4.1.2"><p id="obs_04_0022__p1872818318329"><strong id="obs_04_0022__b95172132">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="63.59%" id="mcps1.3.9.4.2.4.1.3"><p id="obs_04_0022__p2997452203115"><strong id="obs_04_0022__b182912103320">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="obs_04_0022__row9997125211318"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p3997175253113">ListVersionsResult</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p7556184253016">Container</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p91282110225"><strong id="obs_04_0022__b202748132983758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p8997155219315">Container for the list of objects (including versioned objects)</p>
|
|
<p id="obs_04_0022__p20128121182214"><strong id="obs_04_0022__b03661359337">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p1975118215318">None</p>
|
|
<p id="obs_04_0022__p5128191102218"><strong id="obs_04_0022__b58839503384032">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p147547413111">None</p>
|
|
<p id="obs_04_0022__p111283152215"><strong id="obs_04_0022__b51192670684125">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p1297919511312">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row1099711525317"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p499765213119">Name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p10739105411308">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p15326115514446"><strong id="obs_04_0022__b190301583523640">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p6615152416261">Bucket name</p>
|
|
<p id="obs_04_0022__p2998452203117">Parent: ListVersionsResult</p>
|
|
<p id="obs_04_0022__p2402122373112"><strong id="obs_04_0022__b11402162319315">Restrictions</strong>:</p>
|
|
<ul id="obs_04_0022__ul19402152320318"><li id="obs_04_0022__li1540292303112">A bucket name must be unique across all accounts and regions.</li><li id="obs_04_0022__li174025235314">A bucket name:<ul id="obs_04_0022__ul1402102317316"><li id="obs_04_0022__li1640262353114">Must be 3 to 63 characters long and start with a digit or letter. Lowercase letters, digits, hyphens (-), and periods (.) are allowed.</li><li id="obs_04_0022__li9402123173113">Cannot be formatted as an IP address.</li><li id="obs_04_0022__li114021823163112">Cannot start or end with a hyphen (-) or period (.).</li><li id="obs_04_0022__li15402192313317">Cannot contain two consecutive periods (..), for example, <strong id="obs_04_0022__b770097367101028">my..bucket</strong>.</li><li id="obs_04_0022__li10402623203116">Cannot contain a period (.) and a hyphen (-) adjacent to each other, for example, <strong id="obs_04_0022__b337598124101028">my-.bucket</strong> or <strong id="obs_04_0022__b396817560101028">my.-bucket</strong>.</li></ul>
|
|
</li><li id="obs_04_0022__li2040219235317">If you repeatedly create buckets of the same name in the same region, no error will be reported and the bucket attributes comply with those set in the first creation request.</li></ul>
|
|
<p id="obs_04_0022__p1799193213311"><strong id="obs_04_0022__b2799103253116">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p20557193583114">None</p>
|
|
<p id="obs_04_0022__p8402723113119"><strong id="obs_04_0022__b19402122320313">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p1240262317311">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row6998452103116"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p999819521314">Prefix</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p18844155613016">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p340517232325"><strong id="obs_04_0022__b95321721173314">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p8405142313328">Name prefix that the objects to be listed must contain.</p>
|
|
<p id="obs_04_0022__p1740532319329">Assume that you have the following objects: <strong id="obs_04_0022__b3850022153311">logs/day1</strong>, <strong id="obs_04_0022__b188501226336">logs/day2</strong>, <strong id="obs_04_0022__b1485162217331">logs/day3</strong>, and <strong id="obs_04_0022__b2851192263320">ExampleObject.jpg</strong>. If you specify <strong id="obs_04_0022__b454280879">logs/</strong> as the prefix, <strong id="obs_04_0022__b2147119672">logs/day1</strong>, <strong id="obs_04_0022__b1741726557">logs/day2</strong>, and <strong id="obs_04_0022__b1724048616">logs/day3</strong> will be returned. If you leave this parameter blank and there are also no other filters specified, all objects in the bucket will be returned.</p>
|
|
<p id="obs_04_0022__p44051923173210">Parent: ListVersionsResult</p>
|
|
<p id="obs_04_0022__p104052239321"><strong id="obs_04_0022__b240552316322">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p1240512312321">The prefix you specified must already exist in the bucket.</p>
|
|
<p id="obs_04_0022__p7405523163218"><strong id="obs_04_0022__b840552313327">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p4405132383211">The value can contain 1 to 1,024 characters.</p>
|
|
<p id="obs_04_0022__p240520234324"><strong id="obs_04_0022__b114051623163217">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p12405102319321">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row12998175216311"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p18998155214314">KeyMarker</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p106995883014">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p135519417327"><strong id="obs_04_0022__b433070375">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p3355174110324">Name of the object to start with when listing objects in a bucket. All objects following this object are listed in lexicographical order by object name.</p>
|
|
<p id="obs_04_0022__p435554117322">Assume that you have the following objects: <strong id="obs_04_0022__b1512524035">test/a</strong>,<strong id="obs_04_0022__b289175994"> test/b</strong>, <strong id="obs_04_0022__b1497444082">test/c</strong>, and <strong id="obs_04_0022__b627881101">test/d</strong>. If you specify <strong id="obs_04_0022__b13633215335">test/b</strong> as the marker, <strong id="obs_04_0022__b1936113217335">test/c</strong> and <strong id="obs_04_0022__b336123273314">test/d</strong> are returned.</p>
|
|
<p id="obs_04_0022__p1335594133211">Parent: ListVersionsResult</p>
|
|
<p id="obs_04_0022__p13355174114329"><strong id="obs_04_0022__b11355124153212">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p1235515418322">This parameter is used only for listing versioned objects.</p>
|
|
<p id="obs_04_0022__p1235574110326"><strong id="obs_04_0022__b11355141103215">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p835544123218">The value can contain 1 to 1,024 characters.</p>
|
|
<p id="obs_04_0022__p6355141143217"><strong id="obs_04_0022__b1235524133217">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p6355154113219">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row19998195243116"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p1199895263118">VersionIdMarker</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p1527695917303">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p141781857153216"><strong id="obs_04_0022__b437486910">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p8178657153220">Version ID to start with when listing versioned objects, which is consistent with that set in the request</p>
|
|
<p id="obs_04_0022__p1717945716325"><strong id="obs_04_0022__b1217905773219">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p51799576327">This parameter is used only for listing versioned objects.</p>
|
|
<p id="obs_04_0022__p11179165733212"><strong id="obs_04_0022__b121791957183211">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p14179145783218">The value must contain 32 characters.</p>
|
|
<p id="obs_04_0022__p121791357123211"><strong id="obs_04_0022__b17646139163314">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p717920577321">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row899805243118"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p14998205263119">NextKeyMarker</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p1139590183114">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p624371511333"><strong id="obs_04_0022__b1709754179">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p102432015123312">Start position when listing versioned objects in the next request. Key marker for the last returned object in the list. <strong id="obs_04_0022__b684279239">NextKeyMarker</strong> is returned when not all the objects are listed. You can set the <strong id="obs_04_0022__b590804445">KeyMarker</strong> value to list the remaining objects in follow-up requests.</p>
|
|
<p id="obs_04_0022__p192436152338">Parent: ListVersionsResult</p>
|
|
<p id="obs_04_0022__p10243111523315"><strong id="obs_04_0022__b6243141593312">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p135239194336">None</p>
|
|
<p id="obs_04_0022__p182431115203312"><strong id="obs_04_0022__b1838314443311">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p14243115103310">An object name string</p>
|
|
<p id="obs_04_0022__p1324331553313"><strong id="obs_04_0022__b169703245784125">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p124310154339">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row199855212311"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p4998852133117">NextVersionIdMarker</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p15660101183112">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p134963389333"><strong id="obs_04_0022__b2106408867">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p134967381331">Version ID to start with when listing versioned objects in the next request. It is used with the <strong id="obs_04_0022__b968307354101028">nextKeyMarker</strong> parameter. Version ID marker for the last returned object in the list. <strong id="obs_04_0022__b1559875890">NextVersionIdMarker</strong> is returned when not all the objects are listed. You can set the <strong id="obs_04_0022__b977709406">VersionIdMarker</strong> value to list the remaining objects in follow-up requests.</p>
|
|
<p id="obs_04_0022__p194969385333">Parent: ListVersionsResult</p>
|
|
<p id="obs_04_0022__p16496113817339"><strong id="obs_04_0022__b174961538143313">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p1349683810336">This parameter is used only for listing versioned objects.</p>
|
|
<p id="obs_04_0022__p1749653818334"><strong id="obs_04_0022__b0496838153312">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p249610385338">The value must contain 32 characters.</p>
|
|
<p id="obs_04_0022__p4496143843317"><strong id="obs_04_0022__b920335130">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p549617383332">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row179981527315"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p13998185214311">MaxKeys</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p109741227315">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__en-us_topic_0262985935_p2551910124613"><strong id="obs_04_0022__b1413513544338">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p6495812123">The maximum number of objects returned in the response in alphabetical order</p>
|
|
<p id="obs_04_0022__p799911527310">Parent: ListVersionsResult</p>
|
|
<p id="obs_04_0022__p3197554339"><strong id="obs_04_0022__b21919551337">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p419115533314">None</p>
|
|
<p id="obs_04_0022__p6191655133317"><strong id="obs_04_0022__b419175533318">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p141915512331">The value ranges from 1 to 1000. If a value larger than 1000 is specified, 1000 is used.</p>
|
|
<p id="obs_04_0022__p41955515331"><strong id="obs_04_0022__b619655133317">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p2191855203318">1000</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row799955223117"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p9999452143119">IsTruncated</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p1699140193511">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p109341426172218"><strong id="obs_04_0022__b134243596083758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p1499061418344">Whether all results are returned in the response.</p>
|
|
<p id="obs_04_0022__p8999152143111">Parent: ListVersionsResult</p>
|
|
<p id="obs_04_0022__p1593412261225"><strong id="obs_04_0022__b1660110123414">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p12658427153511">None</p>
|
|
<p id="obs_04_0022__p8934152617227"><strong id="obs_04_0022__b213675653584032">Value range</strong>:</p>
|
|
<ul id="obs_04_0022__ul1740320466148"><li id="obs_04_0022__li34031846161416"><strong id="obs_04_0022__b16793734349">true</strong>: Not all results are returned.</li><li id="obs_04_0022__li6403134617148"><strong id="obs_04_0022__b1032285133417">false</strong>: All results are returned.</li></ul>
|
|
<p id="obs_04_0022__p7934172682218"><strong id="obs_04_0022__b163451645684125">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p1147111220346">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row1099955273110"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p11999105283112">Version</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p16340521347">Container</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p12360132922216"><strong id="obs_04_0022__b170960790283758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p499914525311">Container that contains the version information</p>
|
|
<p id="obs_04_0022__p899912528315">Parent: ListVersionsResult</p>
|
|
<p id="obs_04_0022__p8360029122211"><strong id="obs_04_0022__b1688791123414">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p433119235146">None</p>
|
|
<p id="obs_04_0022__p143601729162215"><strong id="obs_04_0022__b91420033084032">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p248211349358">None</p>
|
|
<p id="obs_04_0022__p17583173815164"><strong id="obs_04_0022__b4558111610343">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p970773283518">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row19999145216314"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p19999195263116">DeleteMarker</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p7170204017349">Container</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p58050314222"><strong id="obs_04_0022__b192656876183758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p5999052113117">Container that contains objects with delete markers</p>
|
|
<p id="obs_04_0022__p1199917524312">Parent: ListVersionsResult</p>
|
|
<p id="obs_04_0022__p42851214141718"><strong id="obs_04_0022__b2863131963411">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p127631936173515">None</p>
|
|
<p id="obs_04_0022__p122851914141715"><strong id="obs_04_0022__b830350645">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p914833823511">None</p>
|
|
<p id="obs_04_0022__p12851514111712"><strong id="obs_04_0022__b2018535921">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p1891618398355">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row13999952123114"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p149996521313">Key</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p104713673114">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p7681047131710"><strong id="obs_04_0022__b1188888985">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p768144715177">Name of the versioned object. An object is uniquely identified by an object name in a bucket. An object name is a complete path that does not contain the bucket name.</p>
|
|
<p id="obs_04_0022__p068164701716">Parent: ListVersionsResult.Version | ListVersionsResult.DeleteMarker</p>
|
|
<p id="obs_04_0022__p1577016133283"><strong id="obs_04_0022__b1770101312284">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p12449550172213">None</p>
|
|
<p id="obs_04_0022__p1413194117423"><strong id="obs_04_0022__b1228935180">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p913194144217">The value can contain 1 to 1,024 characters.</p>
|
|
<p id="obs_04_0022__p1413941114218"><strong id="obs_04_0022__b213184111429">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p61313416425">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row169991852103110"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p799985253117">VersionId</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p183427723119">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p177853719225"><strong id="obs_04_0022__b73201958283758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p199994529312">Version ID of the object.</p>
|
|
<p id="obs_04_0022__p59991524316">Parent: ListVersionsResult.Version | ListVersionsResult.DeleteMarker</p>
|
|
<p id="obs_04_0022__p1095317566420"><strong id="obs_04_0022__b209535568427">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p1466441313430">None</p>
|
|
<p id="obs_04_0022__p1898221012439"><strong id="obs_04_0022__b49821610104316">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p1198211010431">The value must contain 32 characters.</p>
|
|
<p id="obs_04_0022__p7982510124315"><strong id="obs_04_0022__b397696231">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p10982151024316">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row1399911525315"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p799925293120">IsLatest</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p072812343219">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p10220201519396"><strong id="obs_04_0022__b14429155133416">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p1477011174562">Whether the object is of the latest version</p>
|
|
<p id="obs_04_0022__p84679171347">Parent: ListVersionsResult.Version | ListVersionsResult.DeleteMarker</p>
|
|
<p id="obs_04_0022__p1164010444436"><strong id="obs_04_0022__b164015442435">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p116401644134318">None</p>
|
|
<p id="obs_04_0022__p064064464318"><strong id="obs_04_0022__b86401744194318">Value range</strong>:</p>
|
|
<ul id="obs_04_0022__ul864074411438"><li id="obs_04_0022__li10640144415430">true: The version is the latest.</li><li id="obs_04_0022__li7640134410436">false: The version is not the latest.</li></ul>
|
|
<p id="obs_04_0022__p1364024484318"><strong id="obs_04_0022__b15640134414435">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p4640104454316">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row599920521311"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p101453163113">LastModified</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p47289363214">Date</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p15197100102114"><strong id="obs_04_0022__b2103212291">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p181971006219">Time (UTC) when an object was last modified</p>
|
|
<p id="obs_04_0022__p701535319">Parent: ListVersionsResult.Version | ListVersionsResult.DeleteMarker</p>
|
|
<p id="obs_04_0022__p919711042114"><strong id="obs_04_0022__b259018221819">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p18197904212">The date is in the ISO8601 format.</p>
|
|
<p id="obs_04_0022__p219719022119">Example: <strong id="obs_04_0022__b1323216417359">2018-01-01T00:00:00.000Z</strong></p>
|
|
<p id="obs_04_0022__p4432802445"><strong id="obs_04_0022__b611228137">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p2043218024417">None</p>
|
|
<p id="obs_04_0022__p94321607444"><strong id="obs_04_0022__b04324017449">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p1543230174417">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row5035323117"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p802053153119">ETag</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p663891015311">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p2529135019211"><strong id="obs_04_0022__b690485264">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p14529125012216">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__b495069117">A</strong> when an object is uploaded, but this value has changed to <strong id="obs_04_0022__b1786329003">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.</p>
|
|
<p id="obs_04_0022__p452911509219">Parent: ListVersionsResult.Version</p>
|
|
<p id="obs_04_0022__p65291450102110"><strong id="obs_04_0022__b75291550102117">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p10529195020212">None</p>
|
|
<p id="obs_04_0022__p11529750162119"><strong id="obs_04_0022__b27977521">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p2529450122111">The value must contain 32 characters.</p>
|
|
<p id="obs_04_0022__p752965010219"><strong id="obs_04_0022__b65020323329">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p1952985012113">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row70165318315"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p00165310316">Type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p153817120317">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p23791476222"><strong id="obs_04_0022__b101938088783758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p100253123116">Object type</p>
|
|
<p id="obs_04_0022__p80185353120">Parent: ListVersionsResult.Version</p>
|
|
<p id="obs_04_0022__p8379124732213"><strong id="obs_04_0022__b19395172093212">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p628012459231">This parameter is returned when the object is not a <strong id="obs_04_0022__b6283192112327">Normal</strong> object.</p>
|
|
<p id="obs_04_0022__p780019634519"><strong id="obs_04_0022__b168004617457">Value range</strong>:</p>
|
|
<ul id="obs_04_0022__ul4199195555817"><li id="obs_04_0022__li15199355175818">NORMAL: normal objects</li><li id="obs_04_0022__li41991355195819">APPENDABLE: appendable objects</li></ul>
|
|
<p id="obs_04_0022__p148002634511"><strong id="obs_04_0022__b158006614455">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p2800160453">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row1901538317"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p1101153143114">Size</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p10583121314313">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p163574507229"><strong id="obs_04_0022__b192832603783758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p80185353119">Object size in bytes</p>
|
|
<p id="obs_04_0022__p162813116335">Parent: ListVersionsResult.Version</p>
|
|
<p id="obs_04_0022__p148141718124515"><strong id="obs_04_0022__b181481819454">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p188145187451">None</p>
|
|
<p id="obs_04_0022__p281441844513"><strong id="obs_04_0022__b17814161864519">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p381411810454">The value ranges from 0 TB to 48.8 TB, in bytes.</p>
|
|
<p id="obs_04_0022__p10814111864514"><strong id="obs_04_0022__b1814918124512">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p3815518144515">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row20453123118"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p00253183110">Owner</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p4475252193217">Container</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p14761115322219"><strong id="obs_04_0022__b187071460783758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p70253203118">User information, including the domain ID and name of the object owner</p>
|
|
<p id="obs_04_0022__p105501502334">Parent: ListVersionsResult.Version | ListVersionsResult.DeleteMarker</p>
|
|
<p id="obs_04_0022__p563612411452"><strong id="obs_04_0022__b17636641194516">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p1663664114453">None</p>
|
|
<p id="obs_04_0022__p156369413454"><strong id="obs_04_0022__b106361541164510">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p2636041104515">None</p>
|
|
<p id="obs_04_0022__p263616412458"><strong id="obs_04_0022__b106368417453">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p176361441174514">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row60105311311"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p17085318310">ID</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p173905163314">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p14261145612214"><strong id="obs_04_0022__b209896896383758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p0015532314">Domain ID of the object owner</p>
|
|
<p id="obs_04_0022__p8035318314">Parent: ListVersionsResult.Version.Owner | ListVersionsResult.DeleteMarker.Owner</p>
|
|
<p id="obs_04_0022__p1109518142510"><strong id="obs_04_0022__b1974714241319">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p1725845174510">None</p>
|
|
<p id="obs_04_0022__p181092018132516"><strong id="obs_04_0022__b1934452813512">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p121091518102513"><a href="obs_04_0117.html">DomainId</a></p>
|
|
<p id="obs_04_0022__p1910931842514"><strong id="obs_04_0022__b126518303354">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p021013466458">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row120353173118"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p1501553103110">DisplayName</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p7725141719316">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p4338165912215"><strong id="obs_04_0022__b13156069583758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p17095313117">Name of the object owner</p>
|
|
<p id="obs_04_0022__p911853133110">Parent: ListVersionsResult.Version.Owner | ListVersionsResult.DeleteMarker.Owner</p>
|
|
<p id="obs_04_0022__p112711340182515"><strong id="obs_04_0022__b2130250776">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p12646448134511">None</p>
|
|
<p id="obs_04_0022__p1227111408251"><strong id="obs_04_0022__b1258903415352">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p13212105124510">None</p>
|
|
<p id="obs_04_0022__p327164018252"><strong id="obs_04_0022__b497773617351">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p1635225214514">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row1011953153120"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p1611253143117">StorageClass</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p19429161943119">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p7160152132311"><strong id="obs_04_0022__b2381844383758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p5165319318">Storage class of an object</p>
|
|
<p id="obs_04_0022__p161653163111">Parent: ListVersionsResult.Version</p>
|
|
<p id="obs_04_0022__p20160132182313"><strong id="obs_04_0022__b395124293511">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p13255174611">None</p>
|
|
<p id="obs_04_0022__p81602242314"><strong id="obs_04_0022__b109792366684032">Value range</strong>:</p>
|
|
<ul id="obs_04_0022__ul7264175232512"><li id="obs_04_0022__li14264252152516">STANDARD</li><li id="obs_04_0022__li1265115214253">WARM</li><li id="obs_04_0022__li18265195252517">COLD</li></ul>
|
|
<p id="obs_04_0022__p016011212318"><strong id="obs_04_0022__b131562133984125">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p945714634618">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row14175343110"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p2175373117">CommonPrefixes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p10459710193215">Container</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p11728204162316"><strong id="obs_04_0022__b74290694783758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p213530316">Group information. If you specify a delimiter in the request, the response contains group information in <strong id="obs_04_0022__b13557017194316">CommonPrefixes</strong>.</p>
|
|
<p id="obs_04_0022__p11115538319">Parent: ListVersionsResult</p>
|
|
<p id="obs_04_0022__p14661154812615"><strong id="obs_04_0022__b38716538352">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p1877842420464">None</p>
|
|
<p id="obs_04_0022__p9661448132615"><strong id="obs_04_0022__b689135413511">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p485052115467">None</p>
|
|
<p id="obs_04_0022__p5661204892610"><strong id="obs_04_0022__b945815783511">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p1734892011464">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0022__row41195373111"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.9.4.2.4.1.1 "><p id="obs_04_0022__p131185383120">Prefix</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.3.9.4.2.4.1.2 "><p id="obs_04_0022__p0636202219315">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.59%" headers="mcps1.3.9.4.2.4.1.3 "><p id="obs_04_0022__p882413682313"><strong id="obs_04_0022__b43364716183758">Explanation</strong>:</p>
|
|
<p id="obs_04_0022__p6125313110">Indicates a different prefix in the group information in <strong id="obs_04_0022__b1836529528">CommonPrefixes</strong>.</p>
|
|
<p id="obs_04_0022__p88993533218">Parent: ListVersionsResult.CommonPrefixes</p>
|
|
<p id="obs_04_0022__p364642174610"><strong id="obs_04_0022__b36564204610">Restrictions</strong>:</p>
|
|
<p id="obs_04_0022__p166564216468">The prefix you specified must already exist in the bucket.</p>
|
|
<p id="obs_04_0022__p1565114211469"><strong id="obs_04_0022__b1865154219467">Value range</strong>:</p>
|
|
<p id="obs_04_0022__p1265184220462">The value can contain 1 to 1,024 characters.</p>
|
|
<p id="obs_04_0022__p465104213465"><strong id="obs_04_0022__b19651442164615">Default value</strong>:</p>
|
|
<p id="obs_04_0022__p2065204217461">None</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"><?xml version="1.0" encoding="UTF-8" standalone="yes"?></span>
|
|
<span class="nt"><ListBucketResult</span><span class="w"> </span><span class="na">xmlns=</span><span class="s">"http://obs.example.com/doc/2015-06-30/"</span><span class="nt">></span>
|
|
<span class="w"> </span><span class="nt"><Name></span>examplebucket<span class="nt"></Name></span>
|
|
<span class="w"> </span><span class="nt"><Prefix/></span>
|
|
<span class="w"> </span><span class="nt"><Marker/></span>
|
|
<span class="w"> </span><span class="nt"><MaxKeys></span>1000<span class="nt"></MaxKeys></span>
|
|
<span class="w"> </span><span class="nt"><IsTruncated></span>false<span class="nt"></IsTruncated></span>
|
|
<span class="w"> </span><span class="nt"><Contents></span>
|
|
<span class="w"> </span><span class="nt"><Key></span>object001<span class="nt"></Key></span>
|
|
<span class="w"> </span><span class="nt"><LastModified></span>2015-07-01T00:32:16.482Z<span class="nt"></LastModified></span>
|
|
<span class="w"> </span><span class="nt"><ETag></span>"2fa3bcaaec668adc5da177e67a122d7c"<span class="nt"></ETag></span>
|
|
<span class="w"> </span><span class="nt"><Size></span>12041<span class="nt"></Size></span>
|
|
<span class="w"> </span><span class="nt"><Owner></span>
|
|
<span class="w"> </span><span class="nt"><ID></span>b4bf1b36d9ca43d984fbcb9491b6fce9<span class="nt"></ID></span>
|
|
<span class="w"> </span><span class="nt"><DisplayName></span>ObjectOwnerName<span class="nt"></DisplayName></span>
|
|
<span class="w"> </span><span class="nt"></Owner></span>
|
|
<span class="w"> </span><span class="nt"><StorageClass></span>STANDARD<span class="nt"></StorageClass></span>
|
|
<span class="w"> </span><span class="nt"></Contents></span>
|
|
<span class="nt"></ListBucketResult></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&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"><?xml version="1.0" encoding="UTF-8" standalone="yes"?></span>
|
|
<span class="nt"><ListBucketResult</span><span class="w"> </span><span class="na">xmlns=</span><span class="s">"http://obs.example.com/doc/2015-06-30/"</span><span class="nt">></span>
|
|
<span class="nt"><Name></span>examplebucket<span class="nt"></Name></span>
|
|
<span class="nt"><Prefix></span>obj<span class="nt"></Prefix></span>
|
|
<span class="nt"><Marker></span>obj001<span class="nt"></Marker></span>
|
|
<span class="nt"><MaxKeys></span>1000<span class="nt"></MaxKeys></span>
|
|
<span class="nt"><IsTruncated></span>false<span class="nt"></IsTruncated></span>
|
|
<span class="w"> </span><span class="nt"><Contents></span>
|
|
<span class="w"> </span><span class="nt"><Key></span>obj002<span class="nt"></Key></span>
|
|
<span class="w"> </span><span class="nt"><LastModified></span>2015-07-01T02:11:19.775Z<span class="nt"></LastModified></span>
|
|
<span class="w"> </span><span class="nt"><ETag></span>"a72e382246ac83e86bd203389849e71d"<span class="nt"></ETag></span>
|
|
<span class="w"> </span><span class="nt"><Size></span>9<span class="nt"></Size></span>
|
|
<span class="w"> </span><span class="nt"><Owner></span>
|
|
<span class="w"> </span><span class="nt"><ID></span>b4bf1b36d9ca43d984fbcb9491b6fce9<span class="nt"></ID></span>
|
|
<span class="w"> </span><span class="nt"><DisplayName></span>ObjectOwnerName<span class="nt"></DisplayName></span>
|
|
<span class="w"> </span><span class="nt"></Owner></span>
|
|
<span class="w"> </span><span class="nt"><StorageClass></span>STANDARD<span class="nt"></StorageClass></span>
|
|
<span class="w"> </span><span class="nt"></Contents></span>
|
|
<span class="nt"></ListBucketResult></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"><?xml version="1.0" encoding="UTF-8" standalone="yes"?></span>
|
|
<span class="nt"><ListVersionsResult</span><span class="w"> </span><span class="na">xmlns=</span><span class="s">"http://obs.example.com/doc/2015-06-30/"</span><span class="nt">></span>
|
|
<span class="w"> </span><span class="nt"><Name></span>bucket02<span class="nt"></Name></span>
|
|
<span class="w"> </span><span class="nt"><Prefix/></span>
|
|
<span class="w"> </span><span class="nt"><KeyMarker/></span>
|
|
<span class="w"> </span><span class="nt"><VersionIdMarker/></span>
|
|
<span class="w"> </span><span class="nt"><MaxKeys></span>1000<span class="nt"></MaxKeys></span>
|
|
<span class="w"> </span><span class="nt"><IsTruncated></span>false<span class="nt"></IsTruncated></span>
|
|
<span class="w"> </span><span class="nt"><Version></span>
|
|
<span class="w"> </span><span class="nt"><Key></span>object001<span class="nt"></Key></span>
|
|
<span class="w"> </span><span class="nt"><VersionId></span>00011000000000013F16000001643A22E476FFFF9046024ECA3655445346485a<span class="nt"></VersionId></span>
|
|
<span class="w"> </span><span class="nt"><IsLatest></span>true<span class="nt"></IsLatest></span>
|
|
<span class="w"> </span><span class="nt"><LastModified></span>2015-07-01T00:32:16.482Z<span class="nt"></LastModified></span>
|
|
<span class="w"> </span><span class="nt"><ETag></span>"2fa3bcaaec668adc5da177e67a122d7c"<span class="nt"></ETag></span>
|
|
<span class="w"> </span><span class="nt"><Size></span>12041<span class="nt"></Size></span>
|
|
<span class="w"> </span><span class="nt"><Owner></span>
|
|
<span class="w"> </span><span class="nt"><ID></span>b4bf1b36d9ca43d984fbcb9491b6fce9<span class="nt"></ID></span>
|
|
<span class="w"> </span><span class="nt"><DisplayName></span>ObjectOwnerName<span class="nt"></DisplayName></span>
|
|
<span class="w"> </span><span class="nt"></Owner></span>
|
|
<span class="w"> </span><span class="nt"><StorageClass></span>STANDARD<span class="nt"></StorageClass></span>
|
|
<span class="w"> </span><span class="nt"></Version></span>
|
|
<span class="nt"></ListVersionsResult></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>
|
|
|