vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/obs/s3api/en-us_topic_0125560273.html
Jawei, Li 1a4c1a720a OBS s3api 2.0.38.SP5 
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: Jawei, Li <lijiawei5@huawei.com>
Co-committed-by: Jawei, Li <lijiawei5@huawei.com>
2022-11-16 14:51:13 +00:00

496 lines
37 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0125560273"></a><a name="EN-US_TOPIC_0125560273"></a>
<h1 class="topictitle1">GET Bucket Object versions</h1>
<div id="body14833109"><p id="EN-US_TOPIC_0125560273__p61239994">After being granted the <strong id="EN-US_TOPIC_0125560273__b66389117">READ</strong> permission for a bucket, you can use this operation to obtain the list of objects in this bucket.</p>
<p id="EN-US_TOPIC_0125560273__p6903631162711">If you specify only the bucket name in the request (<strong id="EN-US_TOPIC_0125560273__b12903113116273">GET /BucketName</strong>), OBS returns descriptions of all objects (a maximum of 1000 objects) in the bucket.</p>
<p id="EN-US_TOPIC_0125560273__p14289035">If you specify one or more parameters among <strong id="EN-US_TOPIC_0125560273__b8809358">prefix</strong>, <strong id="EN-US_TOPIC_0125560273__b12175361">marker</strong>, <strong id="EN-US_TOPIC_0125560273__b42469392">max-keys</strong>, <strong id="EN-US_TOPIC_0125560273__b46680210">delimiter</strong>, and <strong id="EN-US_TOPIC_0125560273__b17468714">version-id-marker</strong>, OBS returns a list of objects in alphabetic order as specified. <a href="#EN-US_TOPIC_0125560273__table5679749">Table 1</a> describes the request parameters.</p>
<div class="section" id="EN-US_TOPIC_0125560273__section339142"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560273__screen53958893111837">GET /?versions HTTP/1.1
User-Agent: agent
Host: bucketname.obs.example.com
Accept: */*
Date: date
Authorization: authorization</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560273__section3052281"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0125560273__p63862124">You can specify parameters in this request to list desired objects (including objects with different version IDs) in a bucket. <a href="#EN-US_TOPIC_0125560273__table5679749">Table 1</a> describes the parameters.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560273__table5679749"></a><a name="table5679749"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560273__table5679749" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0125560273__row25167955"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.5.3.2.4.1.1"><p id="EN-US_TOPIC_0125560273__p25338464">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.5.3.2.4.1.2"><p id="EN-US_TOPIC_0125560273__p39149685">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.5.3.2.4.1.3"><p id="EN-US_TOPIC_0125560273__p17007931">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560273__row35465177"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560273__p54107128">prefix</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560273__p20601280">Limits the response to object keys that begin with the specified prefix.</p>
<p id="EN-US_TOPIC_0125560273__p51193794">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560273__p53056665">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row7747944"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560273__p23603737">key-marker</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560273__p32854546">Indicates the object key to start with when listing objects in a bucket. All objects are listed in the dictionary order.</p>
<p id="EN-US_TOPIC_0125560273__p27255466">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560273__p60209123">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row5011199"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560273__p3253954">max-keys</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560273__p62243693">Sets the maximum number of object keys returned in the response body. All objects are listed in the dictionary order. The value ranges from 1 to 1000. If the value is not in this range, 1000 is returned by default.</p>
<p id="EN-US_TOPIC_0125560273__p23322329">Type: Integer</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560273__p10060533">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row23435933"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560273__p19262450">delimiter</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560273__p16754640">Indicates a character used to group object keys. All object keys that contain the same string between the prefix and the first occurrence of the delimiter after the prefix are grouped under a single result element <strong id="EN-US_TOPIC_0125560273__b16574033">CommonPrefixes</strong>.</p>
<p id="EN-US_TOPIC_0125560273__p14948574">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560273__p2874948">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row25874536"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560273__p15462662">version-id-marker</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560273__p44516113">Indicates the version ID to start with when listing objects in a bucket. All objects are listed in the dictionary order. This parameter is used together with <strong id="EN-US_TOPIC_0125560273__b65100698">key-marker</strong>.</p>
<p id="EN-US_TOPIC_0125560273__p49035376">If the value of <strong id="EN-US_TOPIC_0125560273__b38665203">version-id-marker</strong> is not a version ID specified by <strong id="EN-US_TOPIC_0125560273__b12442508">key-marker</strong>, <strong id="EN-US_TOPIC_0125560273__b44873708">version-id-marker</strong> is invalid.</p>
<p id="EN-US_TOPIC_0125560273__p1210188">Type: String</p>
<p id="EN-US_TOPIC_0125560273__p10891693">Valid Value: object version ID|None</p>
<p id="EN-US_TOPIC_0125560273__p30916376">Constraint: This parameter cannot be an empty string.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560273__p21198553">Optional</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560273__section27470533"><h4 class="sectiontitle">Request Headers</h4><p id="EN-US_TOPIC_0125560273__p18707124">This request uses common headers. For details about common request headers, see section <a href="en-us_topic_0125560462.html">Common Request Headers</a>.</p>
<p id="EN-US_TOPIC_0125560273__p14394472">If you want to obtain CORS configuration information, you must use the headers in <a href="#EN-US_TOPIC_0125560273__table51117746">Table 2</a>.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560273__table51117746"></a><a name="table51117746"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560273__table51117746" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request headers of CORS configuration</caption><thead align="left"><tr id="EN-US_TOPIC_0125560273__row37659904"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.6.4.2.4.1.1"><p id="EN-US_TOPIC_0125560273__p30553390">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.6.4.2.4.1.2"><p id="EN-US_TOPIC_0125560273__p58905565">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.6.4.2.4.1.3"><p id="EN-US_TOPIC_0125560273__p6621493">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560273__row66578909"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560273__p24182525">Origin</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560273__p12627518">Indicates an origin specified by a pre-request. Generally, it is a domain name.</p>
<p id="EN-US_TOPIC_0125560273__p46538802">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560273__p11546631">Mandatory</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row36810817"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560273__p28886228">Access-Control-Request-Headers</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560273__p58083111">Indicates the HTTP headers of a request. The request can use multiple HTTP headers.</p>
<p id="EN-US_TOPIC_0125560273__p52985952">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560273__p64003702">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row92185571811"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.4.2.4.1.1 "><p id="EN-US_TOPIC_0125560273__p101601356131815">x-amz-security-token</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.4.2.4.1.2 "><p id="EN-US_TOPIC_0125560273__p6160185661810">Header field used to identify the request of a federated user. When the federal authentication function is enabled, users sending such requests are identified as federated users.</p>
<p id="EN-US_TOPIC_0125560273__p816065610189">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.4.2.4.1.3 "><p id="EN-US_TOPIC_0125560273__p1160195691819">Optional. This parameter must be carried in the request sent by federated users.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560273__section45908212"><h4 class="sectiontitle">Request Elements</h4><p id="EN-US_TOPIC_0125560273__p18038962">This request involves no elements.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560273__section21762404"><h4 class="sectiontitle">Response Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560273__screen10378144175810">HTTP/1.1 status_code
Server: OBS
x-amz-request-id: request id
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
x-amz-id-2: id
Content-Type: type
Date: date
Content-Length: length
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;ListVersionsResult xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;Name&gt;bucket&lt;/Name&gt;
&lt;Prefix/&gt;
&lt;KeyMarker/&gt;
&lt;VersionIdMarker/&gt;
&lt;NextKeyMarker&gt;nextKeyMarker&lt;/NextKeyMarker&gt;
&lt;NextVersionIdMarker&gt;nextVersionIdMarker&lt;/NextVersionIdMarker&gt;
&lt;MaxKeys&gt;maxKeys&lt;/MaxKeys&gt;
&lt;IsTruncated&gt;boolean&lt;/IsTruncated&gt;
&lt;Version&gt;
&lt;Key&gt;object&lt;/Key&gt;
&lt;VersionId&gt;versionId&lt;/VersionId&gt;
&lt;IsLatest&gt;boolean&lt;/IsLatest&gt;
&lt;LastModified&gt;date&lt;/LastModified&gt;
&lt;ETag&gt;String&lt;/ETag&gt;
&lt;Size&gt;size&lt;/Size&gt;
&lt;Owner&gt;
&lt;ID&gt;ownerID&lt;/ID&gt;
&lt;DisplayName&gt;name&lt;/DisplayName&gt;
&lt;/Owner&gt;
&lt;StorageClass&gt;storageClass&lt;/StorageClass&gt;
&lt;/Version&gt;
&lt;DeleteMarker&gt;
&lt;Key&gt;object&lt;/Key&gt;
&lt;VersionId&gt;versionId&lt;/VersionId&gt;
&lt;IsLatest&gt;boolean&lt;/IsLatest&gt;
&lt;LastModified&gt;date&lt;/LastModified&gt;
&lt;Owner&gt;
&lt;ID&gt;ownerID&lt;/ID&gt;
&lt;DisplayName&gt;name&lt;/DisplayName&gt;
&lt;/Owner&gt;
&lt;/DeleteMarker&gt;
&lt;/ListVersionsResult&gt;</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560273__section61643912"><h4 class="sectiontitle">Response Headers</h4><p id="EN-US_TOPIC_0125560273__p56472471">This response uses common headers. For details about common response headers, see section <a href="en-us_topic_0125560484.html">Common Response Headers</a>.</p>
<p id="EN-US_TOPIC_0125560273__p30697773">In addition to common headers, when CORS is configured for buckets, you can use the response headers in <a href="#EN-US_TOPIC_0125560273__table28132937">Table 3</a>.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560273__table28132937"></a><a name="table28132937"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560273__table28132937" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Appended response headers</caption><thead align="left"><tr id="EN-US_TOPIC_0125560273__row27788973"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.9.4.2.3.1.1"><p id="EN-US_TOPIC_0125560273__p36314342">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.9.4.2.3.1.2"><p id="EN-US_TOPIC_0125560273__p55780624">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560273__row21936723"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p32044118">Access-Control-Allow-Origin</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p45436737">If <strong id="EN-US_TOPIC_0125560273__b6277453">Origin</strong> in the request meets the CORS configuration requirements, <strong id="EN-US_TOPIC_0125560273__b56497085">Origin</strong> is included in the response.</p>
<p id="EN-US_TOPIC_0125560273__p38711721">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row12861169"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p35121798">Access-Control-Allow-Headers</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p26293412">If <strong id="EN-US_TOPIC_0125560273__b35314117">headers</strong> in the request meet the CORS configuration requirements, <strong id="EN-US_TOPIC_0125560273__b49391602">headers</strong> are included in the response.</p>
<p id="EN-US_TOPIC_0125560273__p41871234">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row41296792"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p56705855">Access-Control-Max-Age</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p29771534">Indicates <strong id="EN-US_TOPIC_0125560273__b66617221">MaxAgeSeconds</strong> in the CORS configuration of a server.</p>
<p id="EN-US_TOPIC_0125560273__p62684078">Type: Integer</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row27285796"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p62665856">Access-Control-Allow-Methods</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p42769536">If <strong id="EN-US_TOPIC_0125560273__b49381505">Access-Control-Request-Method</strong> in the request meets the CORS configuration requirements, methods in the rule are included in the response.</p>
<p id="EN-US_TOPIC_0125560273__p41780364">Type: String</p>
<p id="EN-US_TOPIC_0125560273__p40478963">Valid values: <strong id="EN-US_TOPIC_0125560273__b28766349">GET</strong>, <strong id="EN-US_TOPIC_0125560273__b57570557">PUT</strong>, <strong id="EN-US_TOPIC_0125560273__b48372971">HEAD</strong>, <strong id="EN-US_TOPIC_0125560273__b32703560">POST</strong>, and <strong id="EN-US_TOPIC_0125560273__b25896589">DELETE</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row31742716"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p21023167">Access-Control-Expose-Headers</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p25155004">Indicates <strong id="EN-US_TOPIC_0125560273__b6654113519582">ExposeHeader</strong> in the CORS configuration of a server.</p>
<p id="EN-US_TOPIC_0125560273__p24289433">Type: String</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="EN-US_TOPIC_0125560273__p17278307"></p>
</div>
<div class="section" id="EN-US_TOPIC_0125560273__section17924300"><h4 class="sectiontitle">Response Elements</h4><p id="EN-US_TOPIC_0125560273__p57365620">This response contains elements to specify the objects (including objects with multiple version IDs) in a bucket. <a href="#EN-US_TOPIC_0125560273__table51869847">Table 4</a> describes the elements.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560273__table51869847"></a><a name="table51869847"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560273__table51869847" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response elements</caption><thead align="left"><tr id="EN-US_TOPIC_0125560273__row60306259"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.10.3.2.3.1.1"><p id="EN-US_TOPIC_0125560273__p52968826">Element</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.10.3.2.3.1.2"><p id="EN-US_TOPIC_0125560273__p62616542">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560273__row38775142"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p53778811">ListVersionsResult</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p61116420">Indicates the container for the list of objects (including objects with multiple version IDs).</p>
<p id="EN-US_TOPIC_0125560273__p13176872">Type: Container</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row51482986"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p9372308">Name</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p20959466">Indicates the bucket name.</p>
<p id="EN-US_TOPIC_0125560273__p54417474">Type: String</p>
<p id="EN-US_TOPIC_0125560273__p19995222">Ancestor: ListVersionsResult</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row45739270"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p13893419">Prefix</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p51625177">Indicates the prefix of an object key. Only objects whose keys have this prefix are listed.</p>
<p id="EN-US_TOPIC_0125560273__p61973410">Type: String</p>
<p id="EN-US_TOPIC_0125560273__p20889783">Ancestor: ListVersionsResult</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row53790319"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p62048601">KeyMarker</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p59880775">Indicates the object key to start with when listing objects.</p>
<p id="EN-US_TOPIC_0125560273__p2056067">Type: String</p>
<p id="EN-US_TOPIC_0125560273__p18504610">Ancestor: ListVersionsResult</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row32323763"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p979164">VersionIdMarker</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p12203429">Indicates the object version ID to start with when listing objects.</p>
<p id="EN-US_TOPIC_0125560273__p42721997">Type: String</p>
<p id="EN-US_TOPIC_0125560273__p48953654">Ancestor: ListVersionsResult</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row37929705"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p52407290">NextKeyMarker</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p17132136">Indicates the key marker for the last returned object in the list. <strong id="EN-US_TOPIC_0125560273__b19971501">NextKeyMarker</strong> is returned when not all the objects are listed. You can set the <strong id="EN-US_TOPIC_0125560273__b45525786">KeyMarker</strong> value to list the remaining objects in follow-up requests.</p>
<p id="EN-US_TOPIC_0125560273__p7078897">Type: String</p>
<p id="EN-US_TOPIC_0125560273__p63710073">Ancestor: ListVersionsResult</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row36519748"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p5309649">NextVersionIdMarker</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p27428414">Indicates the version ID marker for the last returned object in the list. <strong id="EN-US_TOPIC_0125560273__b45529136">NextVersionIdMarker</strong> is returned when not all the objects are listed. You can set the <strong id="EN-US_TOPIC_0125560273__b7109043">VersionIdMarker</strong> value to list the remaining objects in follow-up requests.</p>
<p id="EN-US_TOPIC_0125560273__p63981393">Type: String</p>
<p id="EN-US_TOPIC_0125560273__p38961625">Ancestor: ListVersionsResult</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row15110310"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p15975575">MaxKeys</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p18953230">Indicates the maximum objects returned.</p>
<p id="EN-US_TOPIC_0125560273__p36361342">Type: String</p>
<p id="EN-US_TOPIC_0125560273__p58816624">Ancestor: ListVersionsResult</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row59587574"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p61864166">IsTruncated</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p44941559">Determines whether the returned list of objects is truncated. <strong id="EN-US_TOPIC_0125560273__b1820851">true</strong> indicates that the result is incomplete while <strong id="EN-US_TOPIC_0125560273__b16387664">false</strong> indicates that the result is complete.</p>
<p id="EN-US_TOPIC_0125560273__p13271256">Type: Boolean</p>
<p id="EN-US_TOPIC_0125560273__p52332442">Ancestor: ListVersionsResult</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row1229937"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p32516071">Version</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p16556065">Indicates the container for version information.</p>
<p id="EN-US_TOPIC_0125560273__p14786859">Type: Container</p>
<p id="EN-US_TOPIC_0125560273__p65972871">Ancestor: ListVersionsResult</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row56884935"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p44277019">DeleteMarker</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p29668816">Indicates the container for objects with deletion marks.</p>
<p id="EN-US_TOPIC_0125560273__p65692758">Type: Container</p>
<p id="EN-US_TOPIC_0125560273__p54363918">Ancestor: ListVersionsResult</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row19513215"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p37066588">key</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p49603670">Name of an object</p>
<p id="EN-US_TOPIC_0125560273__p43779849">Type: String</p>
<p id="EN-US_TOPIC_0125560273__p58474324">Ancestor: ListVersionsResult.Version | ListVersionsResult.DeleteMarker</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row56506872"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p13653944">VersionId</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p32227697">Indicates the object version ID.</p>
<p id="EN-US_TOPIC_0125560273__p21613818">Type: String</p>
<p id="EN-US_TOPIC_0125560273__p60306634">Ancestor: ListVersionsResult.Version | ListVersionsResult.DeleteMarker</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row5888794"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p7230278">IsLatest</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p48781671">Specifies whether the object is or is not of the latest version. If the element is <strong id="EN-US_TOPIC_0125560273__b36381863">true</strong>, the object is of the latest version.</p>
<p id="EN-US_TOPIC_0125560273__p59001317">Type: Boolean</p>
<p id="EN-US_TOPIC_0125560273__p61249810">Ancestor: ListVersionsResult.Version | ListVersionsResult.DeleteMarker</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row14377383"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p23717398">LastModified</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p42061081">Indicates the date and time when the last modification was made to an object.</p>
<p id="EN-US_TOPIC_0125560273__p43005414">Type: Date</p>
<p id="EN-US_TOPIC_0125560273__p51504409">Ancestor: ListVersionsResult.Version | ListVersionsResult.DeleteMarker</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row60886499"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p32859368">ETag</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p44363166">MD5 value of an object</p>
<p id="EN-US_TOPIC_0125560273__p63724179">Type: String</p>
<p id="EN-US_TOPIC_0125560273__p36646700">Ancestor: ListVersionsResult.Version</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row61384852"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p6117147">Size</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p25726861">Number of bytes of an object</p>
<p id="EN-US_TOPIC_0125560273__p30215163">Type: String</p>
<p id="EN-US_TOPIC_0125560273__p3501012">Ancestor: ListVersionsResult.Version</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row31509115"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p2101532">Owner</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p36006405">User information, including the DomainId and name</p>
<p id="EN-US_TOPIC_0125560273__p55622197">Type: Container</p>
<p id="EN-US_TOPIC_0125560273__p30837727">Ancestor: ListVersionsResult.Version | ListVersionsResult.DeleteMarker</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row9104094"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p66343012">ID</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p5074862">DomainId of an object owner</p>
<p id="EN-US_TOPIC_0125560273__p45673760">Type: String</p>
<p id="EN-US_TOPIC_0125560273__p8410660">Ancestor: ListVersionsResult.Version.Owner | ListVersionsResult.DeleteMarker.Owner</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row8587084"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p24465200">DisplayName</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p35524213">Name of an object owner</p>
<p id="EN-US_TOPIC_0125560273__p51282467">Type: String</p>
<p id="EN-US_TOPIC_0125560273__p58889027">Ancestor: ListVersionsResult.Version.Owner | ListVersionsResult.Version.Owner</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row60239196"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p47536713">StorageClass</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p25268563">Storage type of an object</p>
<p id="EN-US_TOPIC_0125560273__p26090478">Type: Enumeration</p>
<p id="EN-US_TOPIC_0125560273__p33487713">Ancestor: ListVersionsResult.Version</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row32953965"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p52025533">CommonPrefixes</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p53318662">Grouping information. If you specify a delimiter in the request, the response contains grouping information in <strong id="EN-US_TOPIC_0125560273__b10105911">CommonPrefixes</strong>.</p>
<p id="EN-US_TOPIC_0125560273__p23844335">Type: Container</p>
<p id="EN-US_TOPIC_0125560273__p13272423">Ancestor: ListVersionsResult</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560273__row52342944"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.1 "><p id="EN-US_TOPIC_0125560273__p11920066">Prefix</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.10.3.2.3.1.2 "><p id="EN-US_TOPIC_0125560273__p26001276">Indicates a different prefix in the grouping information in <strong id="EN-US_TOPIC_0125560273__b32684898">CommonPrefixes</strong>.</p>
<p id="EN-US_TOPIC_0125560273__p25728631">Type: String</p>
<p id="EN-US_TOPIC_0125560273__p30231092">Ancestor: ListVersionsResult.CommonPrefixes</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560273__section27100977"><h4 class="sectiontitle">Error Responses</h4><p id="EN-US_TOPIC_0125560273__p26759246">No special error responses are returned. For details about error responses, see <a href="en-us_topic_0125560440.html#EN-US_TOPIC_0125560440__table30733758">Table 1</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560273__section57447370"><h4 class="sectiontitle">Sample Request</h4><pre class="screen" id="EN-US_TOPIC_0125560273__screen6239709611203">GET /?versions HTTP/1.1
User-Agent: curl/7.19.0
Host: bucketname.obs.example.com
Accept: */*
Date: Thu, 16 Jan 2014 03:31:26 +0000
Authorization: AWS C9590CEB8EC051BDEC9D:KfF0yCAt+LAE/AE0YTxQS7IzQ8U=</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560273__section47264284"><h4 class="sectiontitle">Sample Response</h4><pre class="screen" id="EN-US_TOPIC_0125560273__screen18610018112031">HTTP/1.1 200 OK
Server: OBS
x-amz-request-id: DCD2FC9CAB7800000143991A7DEECBF4
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
x-amz-id-2: 00QkPL575tIUmU8kth0zA16DlRzzdDiVDHK4OaGeujayXCfdD7phC21ZZYmVqx3W
Content-Type: application/xml
Date: Thu, 16 Jan 2014 03:31:26 GMT
Content-Length: 1275
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;ListVersionsResult xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;Name&gt;bucket&lt;/Name&gt;
&lt;Prefix/&gt;
&lt;KeyMarker/&gt;
&lt;VersionIdMarker/&gt;
&lt;MaxKeys&gt;1000&lt;/MaxKeys&gt;
&lt;IsTruncated&gt;false&lt;/IsTruncated&gt;
&lt;DeleteMarker&gt;
&lt;Key&gt;key0&lt;/Key&gt;
&lt;VersionId&gt;AAABQ5kabBnc0vycq3gAAABCVURTRkha&lt;/VersionId&gt;
&lt;IsLatest&gt;true&lt;/IsLatest&gt;
&lt;LastModified&gt;2014-01-16T03:31:22.265Z&lt;/LastModified&gt;
&lt;Owner&gt;
&lt;ID&gt;DCD2FC9CAB78000001438EC051BD0002&lt;/ID&gt;
&lt;DisplayName&gt;user&lt;/DisplayName&gt;
&lt;/Owner&gt;
&lt;/DeleteMarker&gt;
&lt;Version&gt;
&lt;Key&gt;key0&lt;/Key&gt;
&lt;VersionId&gt;AAABQ5kZxWTc0vycq3gAAABBVURTRkha&lt;/VersionId&gt;
&lt;IsLatest&gt;false&lt;/IsLatest&gt;
&lt;LastModified&gt;2014-01-16T03:30:39.575Z&lt;/LastModified&gt;
&lt;ETag&gt;"6b0e1cad9fd2eff22004e28aa8073420"&lt;/ETag&gt;
&lt;Size&gt;80&lt;/Size&gt;
&lt;Owner&gt;
&lt;ID&gt;DCD2FC9CAB78000001438EC051BD0002&lt;/ID&gt;
&lt;DisplayName&gt;user&lt;/DisplayName&gt;
&lt;/Owner&gt;
&lt;StorageClass&gt;STANDARD&lt;/StorageClass&gt;
&lt;/Version&gt;
&lt;Version&gt;
&lt;Key&gt;suspend&lt;/Key&gt;
&lt;VersionId&gt;null&lt;/VersionId&gt;
&lt;IsLatest&gt;true&lt;/IsLatest&gt;
&lt;LastModified&gt;2014-01-16T03:25:58.443Z&lt;/LastModified&gt;
&lt;ETag&gt;"a65d3be0857de44e470e0c069e4b04e3"&lt;/ETag&gt;
&lt;Size&gt;80&lt;/Size&gt;
&lt;Owner&gt;
&lt;ID&gt;DCD2FC9CAB78000001438EC051BD0002&lt;/ID&gt;
&lt;DisplayName&gt;user&lt;/DisplayName&gt;
&lt;/Owner&gt;
&lt;StorageClass&gt;STANDARD&lt;/StorageClass&gt;
&lt;/Version&gt;
&lt;/ListVersionsResult&gt;</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560273__section3201777"><h4 class="sectiontitle">Sample Request (Example of getting bucket object versions by using key-marker and version-id-marker)</h4><pre class="screen" id="EN-US_TOPIC_0125560273__screen50787853112045">GET /?versions&amp;key-marker=key0&amp;version-id-marker=AAABQ5kabBnc0vycq3gAAABCVURTRkha HTTP/1.1
User-Agent: curl/7.19.0
Host: bucketname.obs.example.com
Accept: */*
Date: Thu, 16 Jan 2014 04:48:20 +0000
Authorization: AWS C9590CEB8EC051BDEC9D:iw+nTJEMO5KLMoE66sqzkRF3ik0=</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560273__section28815999"><h4 class="sectiontitle">Sample Response (Example of getting bucket object versions by using key-marker and version-id-marker)</h4><pre class="screen" id="EN-US_TOPIC_0125560273__screen11123356112056">HTTP/1.1 200 OK
Server: OBS
x-amz-request-id: DCD2FC9CAB78000001439960E2F3F18A
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
x-amz-id-2: P1j6zAy1GOP9KoRUWgJt3mJGKNLlAU4dn7BfL16VXpeWCX/25cZpshp5mTbu1kyw
Content-Type: application/xml
Date: Thu, 16 Jan 2014 04:48:20 GMT
Content-Length: 1051
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;ListVersionsResult xmlns="http://obs.example.com/doc/2015-06-30/"&gt;
&lt;Name&gt;bucket&lt;/Name&gt;
&lt;Prefix/&gt;
&lt;KeyMarker&gt;key0&lt;/KeyMarker&gt;
&lt;VersionIdMarker&gt;AAABQ5kabBnc0vycq3gAAABCVURTRkha&lt;/VersionIdMarker&gt;
&lt;MaxKeys&gt;1000&lt;/MaxKeys&gt;
&lt;IsTruncated&gt;false&lt;/IsTruncated&gt;
&lt;Version&gt;
&lt;Key&gt;key0&lt;/Key&gt;
&lt;VersionId&gt;AAABQ5kZxWTc0vycq3gAAABBVURTRkha&lt;/VersionId&gt;
&lt;IsLatest&gt;false&lt;/IsLatest&gt;
&lt;LastModified&gt;2014-01-16T03:30:39.575Z&lt;/LastModified&gt;
&lt;ETag&gt;"6b0e1cad9fd2eff22004e28aa8073420"&lt;/ETag&gt;
&lt;Size&gt;80&lt;/Size&gt;
&lt;Owner&gt;
&lt;ID&gt;DCD2FC9CAB78000001438EC051BD0002&lt;/ID&gt;
&lt;DisplayName&gt;user&lt;/DisplayName&gt;
&lt;/Owner&gt;
&lt;StorageClass&gt;STANDARD&lt;/StorageClass&gt;
&lt;/Version&gt;
&lt;Version&gt;
&lt;Key&gt;suspend&lt;/Key&gt;
&lt;VersionId&gt;null&lt;/VersionId&gt;
&lt;IsLatest&gt;true&lt;/IsLatest&gt;
&lt;LastModified&gt;2014-01-16T03:25:58.443Z&lt;/LastModified&gt;
&lt;ETag&gt;"a65d3be0857de44e470e0c069e4b04e3"&lt;/ETag&gt;
&lt;Size&gt;80&lt;/Size&gt;
&lt;Owner&gt;
&lt;ID&gt;DCD2FC9CAB78000001438EC051BD0002&lt;/ID&gt;
&lt;DisplayName&gt;user&lt;/DisplayName&gt;
&lt;/Owner&gt;
&lt;StorageClass&gt;STANDARD&lt;/StorageClass&gt;
&lt;/Version&gt;
&lt;/ListVersionsResult&gt;</pre>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0125560493.html">Operations on Buckets</a></div>
</div>
</div>
View Git Blame Copy Permalink