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

473 lines
43 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0125560336"></a><a name="EN-US_TOPIC_0125560336"></a>
<h1 class="topictitle1">GET Object</h1>
<div id="body62990874"><p id="EN-US_TOPIC_0125560336__p61881498">You can use this operation to obtain the content and metadata of an object, as long as you have <strong id="EN-US_TOPIC_0125560336__b1782705412112">READ</strong> permission for the object.</p>
<p id="EN-US_TOPIC_0125560336__p24323915165739">This operation makes server-side encryption available.</p>
<div class="section" id="EN-US_TOPIC_0125560336__section20062571"><h4 class="sectiontitle">Versioning</h4><p id="EN-US_TOPIC_0125560336__p26745965">By default, the content of the object with the latest version ID is obtained. If the version ID of the object is a deletion mark, <strong id="EN-US_TOPIC_0125560336__b1671419124713">404</strong> is returned. You can specify <strong id="EN-US_TOPIC_0125560336__b39387099">versionId</strong> to obtain the content of an object of the desired version.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560336__section5921648520359"><h4 class="sectiontitle">Cold Objects</h4><p id="EN-US_TOPIC_0125560336__p3180596620359">For Cold objects, the response varies with the restoration status of the objects. If the objects have been restored, then the <strong id="EN-US_TOPIC_0125560336__b1781824220359">x-amz-restore</strong> header is returned indicating the expiry date of the objects when they are successfully downloaded. If you request to download Cold objects that are not restored or are being restored, a <strong id="EN-US_TOPIC_0125560336__b2614645220359">403 Forbidden</strong> error is returned.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560336__section39480712"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560336__screen42718656112238">GET /ObjectName HTTP/1.1
User-Agent: agent
Host: bucketname.obs.example.com
Accept: */*
Date: date
Authorization: authorization
Range:bytes=byte_range
&lt;Optional Additional Header&gt;</pre>
<div class="note" id="EN-US_TOPIC_0125560336__note35011040"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="EN-US_TOPIC_0125560336__p46663904">In this request, header <strong id="EN-US_TOPIC_0125560336__b17321959">Range</strong> is optional. If this header is not specified, all data of an object is returned.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0125560336__section19782092"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0125560336__p60901459">In a <strong id="EN-US_TOPIC_0125560336__b11242227">GET</strong> request, you can override values for a set of response headers using the request parameters listed in <a href="#EN-US_TOPIC_0125560336__table63181911">Table 1</a>. Response headers that you can override are <strong id="EN-US_TOPIC_0125560336__b38205169">Content-Type</strong>, <strong id="EN-US_TOPIC_0125560336__b8302201">Content-Language</strong>, <strong id="EN-US_TOPIC_0125560336__b7610951">Expires</strong>, <strong id="EN-US_TOPIC_0125560336__b1389699">Cache-Control</strong>, <strong id="EN-US_TOPIC_0125560336__b12507294">Content-Disposition</strong>, and <strong id="EN-US_TOPIC_0125560336__b45456785">Content-Encoding</strong>.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560336__table63181911"></a><a name="table63181911"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560336__table63181911" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0125560336__row6292375"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.6.3.2.4.1.1"><p id="EN-US_TOPIC_0125560336__p39920339">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.6.3.2.4.1.2"><p id="EN-US_TOPIC_0125560336__p12322052">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.6.3.2.4.1.3"><p id="EN-US_TOPIC_0125560336__p58562194">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560336__row45917284"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560336__p28312547">response-content-type</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560336__p11614966">Overrides the <strong id="EN-US_TOPIC_0125560336__b37425835">Content-Type</strong> header in the response.</p>
<p id="EN-US_TOPIC_0125560336__p1288198">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560336__p37235194">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row66681293"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560336__p32475667">response-content-language</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560336__p13283377">Overrides the <strong id="EN-US_TOPIC_0125560336__b52441537">Content-Language</strong> header in the response.</p>
<p id="EN-US_TOPIC_0125560336__p2211792">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560336__p44937496">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row1784282"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560336__p10309169">response-expires</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560336__p29736389">Overrides the <strong id="EN-US_TOPIC_0125560336__b66300913">Expires</strong> header in the response.</p>
<p id="EN-US_TOPIC_0125560336__p59837309">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560336__p14983874">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row637140"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560336__p51608407">response-cache-control</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560336__p19531418">Overrides the <strong id="EN-US_TOPIC_0125560336__b41565035">Cache-Control</strong> header in the response.</p>
<p id="EN-US_TOPIC_0125560336__p38540997">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560336__p34813057">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row44882061"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560336__p11568292">response-content-disposition</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560336__p64616480">Overrides the <strong id="EN-US_TOPIC_0125560336__b44677416">Content-Disposition</strong> header in the response.</p>
<p id="EN-US_TOPIC_0125560336__p66552425">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560336__p22037350">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row64118428"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560336__p26210179">response-content-encoding</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560336__p42649746">Overrides the <strong id="EN-US_TOPIC_0125560336__b48303401">Content-Encoding</strong> header in the response.</p>
<p id="EN-US_TOPIC_0125560336__p32077426">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560336__p48134731">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row30559396"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560336__p59391972">versionId</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560336__p46020400">Specifies the version ID of the object whose content is obtained.</p>
<p id="EN-US_TOPIC_0125560336__p11530423">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.6.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560336__p61549057">Optional</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560336__section43821104"><h4 class="sectiontitle">Request Headers</h4><p id="EN-US_TOPIC_0125560336__p40541937">This request uses common headers. For details about common request headers, see section <a href="en-us_topic_0125560462.html">Common Request Headers</a>. In addition, you can add optional headers to this request. <a href="#EN-US_TOPIC_0125560336__table54982876">Table 2</a> describes the optional headers.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560336__table54982876"></a><a name="table54982876"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560336__table54982876" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Optional request headers</caption><thead align="left"><tr id="EN-US_TOPIC_0125560336__row19581186"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.7.3.2.4.1.1"><p id="EN-US_TOPIC_0125560336__p42572248">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.7.3.2.4.1.2"><p id="EN-US_TOPIC_0125560336__p25800070">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.7.3.2.4.1.3"><p id="EN-US_TOPIC_0125560336__p9430965">Remarks</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560336__row25710733"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560336__p2194613">Range</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560336__p43545941">Obtains the specified range bytes of an object. The value is a range starting from 0 to maximum object length minus one. If the range is invalid, all object data is returned.</p>
<p id="EN-US_TOPIC_0125560336__p56369154">Type: String</p>
<p id="EN-US_TOPIC_0125560336__p37560342">Note:</p>
<p id="EN-US_TOPIC_0125560336__p2498762">The header format for a single range is <em id="EN-US_TOPIC_0125560336__i22488863">bytes=byte_range</em>, for example, <strong id="EN-US_TOPIC_0125560336__b126647117125">bytes=0-4</strong> or <strong id="EN-US_TOPIC_0125560336__b101236412409">bytes=512-1024</strong>. The header format for multiple ranges is, for example, <strong id="EN-US_TOPIC_0125560336__b393316216446">bytes=10-20</strong><strong id="EN-US_TOPIC_0125560336__b15849128124414">,30-40</strong>. If there are multiple ranges, the output is as follows:</p>
<p id="EN-US_TOPIC_0125560336__p57272696212419">--5926640d-5ca3-4e56-a9e9-5493dab2da66</p>
<p id="EN-US_TOPIC_0125560336__p45692217212419">Content-type: binary/octet-stream</p>
<p id="EN-US_TOPIC_0125560336__p8576776212419">Content-range: bytes 10-20/7279</p>
<p id="EN-US_TOPIC_0125560336__p23630265212419">xxxx</p>
<p id="EN-US_TOPIC_0125560336__p11345797212419">--5926640d-5ca3-4e56-a9e9-5493dab2da66</p>
<p id="EN-US_TOPIC_0125560336__p35003314212419">Content-type: binary/octet-stream</p>
<p id="EN-US_TOPIC_0125560336__p46594378212419">Content-range: bytes 30-40/7279</p>
<p id="EN-US_TOPIC_0125560336__p16048259212419">yyyy</p>
<div class="note" id="EN-US_TOPIC_0125560336__note149731316529"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0125560336__p1718914112571"><strong id="EN-US_TOPIC_0125560336__b141897115713">--5926640d-5ca3-4e56-a9e9-5493dab2da66--</strong> is a randomly generated character string and functions as a separator.</p>
<p id="EN-US_TOPIC_0125560336__p1749711135529"><strong id="EN-US_TOPIC_0125560336__b152971157125711">Content-type</strong> indicates the type of the range data.</p>
<p id="EN-US_TOPIC_0125560336__p144891575718"><strong id="EN-US_TOPIC_0125560336__b14730163175818">Content-range</strong> indicates the data range or the total object size.</p>
</div></div>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560336__p44153132">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row61833870"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560336__p42487544">If-Modified-Since</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560336__p18939022">Returns the object only if it has been modified since the time specified by this header, otherwise <strong id="EN-US_TOPIC_0125560336__b24247951212">304 Not Modified</strong> is returned.</p>
<p id="EN-US_TOPIC_0125560336__p57665850">Type: HTTP time string complying with the format specified in http://www.ietf.org/rfc/rfc2616.txt.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560336__p40422241">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row28255855"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560336__p7022941">If-Unmodified-Since</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560336__p31987323">Returns the object only if it has not been modified since the time specified by this header, otherwise <strong id="EN-US_TOPIC_0125560336__b1127351891211">412 Precondition Failed</strong> is returned.</p>
<p id="EN-US_TOPIC_0125560336__p40836337">Type: HTTP time string complying with the format specified in http://www.ietf.org/rfc/rfc2616.txt.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560336__p19409000">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row40463275"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560336__p56299846">If-Match</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560336__p63993653">Returns the object only if its ETag is the same as the one specified by this header, otherwise <strong id="EN-US_TOPIC_0125560336__b454719261122">412 Precondition Failed</strong> is returned.</p>
<p id="EN-US_TOPIC_0125560336__p16103393">Type: String</p>
<p id="EN-US_TOPIC_0125560336__p10712809">Note:</p>
<p id="EN-US_TOPIC_0125560336__p29306417">An example ETag value is <strong id="EN-US_TOPIC_0125560336__b62431162">0f64741bf7cb1089e988e4585d0d3434</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560336__p23759356">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row12507614"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560336__p6483852">If-None-Match</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560336__p55430014">Returns the object only if its ETag is different from the one specified by this header, otherwise <strong id="EN-US_TOPIC_0125560336__b5663163301213">304 Not Modified</strong> is returned.</p>
<p id="EN-US_TOPIC_0125560336__p60646173">Type: String</p>
<p id="EN-US_TOPIC_0125560336__p8944648">Note:</p>
<p id="EN-US_TOPIC_0125560336__p13392976">An example ETag value is <strong id="EN-US_TOPIC_0125560336__b53427925">0f64741bf7cb1089e988e4585d0d3434</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560336__p32694658">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row65701914165449"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560336__p20254821165449">Origin</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560336__p34982523165521">Indicates an origin specified by a pre-request. Generally, it is a domain name.</p>
<p id="EN-US_TOPIC_0125560336__p46407251165521">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560336__p16331104165449">Optional. If you want to obtain the CORs configuration, this item is mandatory.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row506837165454"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560336__p41053798165454">Access-Control-Request-Headers</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560336__p21484200165529">Indicates the HTTP headers of a request. The request can use multiple HTTP headers.</p>
<p id="EN-US_TOPIC_0125560336__p59140076165529">Type: String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560336__p46100226165454">Optional</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row2545979102559"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560336__p18680844165828">x-amz-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560336__p36753425165828">Indicates an encryption algorithm. The header is used in SSE-C mode.</p>
<p id="EN-US_TOPIC_0125560336__p62345375165828">Type: string</p>
<p id="EN-US_TOPIC_0125560336__p24237471165828">Example: x-amz-server-side-encryption-customer-algorithm:AES256</p>
<p id="EN-US_TOPIC_0125560336__p16810648165828">Constraints: This header must be used together with <strong id="EN-US_TOPIC_0125560336__b17078109165828">x-amz-server-side-encryption-customer-key</strong> and <strong id="EN-US_TOPIC_0125560336__b19485253165828">x-amz-server-side-encryption-customer-key-MD5</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560336__p34801679165828">Optional. This header is mandatory when SSE-C is used.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row1200923010266"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560336__p3273673165828">x-amz-server-side-encryption-customer-key</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560336__p63840985165828">Indicates a key used to decrypt objects. The header is used in SSE-C mode.</p>
<p id="EN-US_TOPIC_0125560336__p37697959165828">Type: string</p>
<p id="EN-US_TOPIC_0125560336__p3737314165828">Example: x-amz-server-side-encryption-customer-key:K7QkYpBkM5+hcs27fsNkUnNVaobncnLht/rCB2o/9Cw=</p>
<p id="EN-US_TOPIC_0125560336__p33635827165828">Constraints: This header is a base64-encoded 256-bit or 512-bit key and must be used together with <strong id="EN-US_TOPIC_0125560336__b34286987165828">x-amz-server-side-encryption-customer-algorithm</strong> and <strong id="EN-US_TOPIC_0125560336__b40147427165828">x-amz-server-side-encryption-customer-key-MD5</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560336__p30716127165828">Optional. This header is mandatory when SSE-C is used.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row21277310263"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560336__p44805464165828">x-amz-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560336__p5363987165828">Indicates the MD5 value of a key used to encrypt objects. The header is used in SSE-C mode. The MD5 value is used to check whether any error occurs during the transmission of the key.</p>
<p id="EN-US_TOPIC_0125560336__p48275888165828">Type: string</p>
<p id="EN-US_TOPIC_0125560336__p31829815165828">Example: x-amz-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</p>
<p id="EN-US_TOPIC_0125560336__p18032879165828">Constraints: This header is a base64-encoded 128-bit MD5 value and must be used together with <strong id="EN-US_TOPIC_0125560336__b28078186165828">x-amz-server-side-encryption-customer-algorithm</strong> and <strong id="EN-US_TOPIC_0125560336__b51377090165828">x-amz-server-side-encryption-customer-key</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560336__p794770165828">Optional. This header is mandatory when SSE-C is used.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row76475653817"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560336__p93771257143819">x-amz-security-token</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560336__p1377175714384">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_0125560336__p123771157103813">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.7.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560336__p1937711572389">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_0125560336__section58845621"><h4 class="sectiontitle">Request Elements</h4><p id="EN-US_TOPIC_0125560336__p10759157">This request involves no elements.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560336__section41115719"><h4 class="sectiontitle">Response Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560336__screen6049642411234">HTTP/1.1 status_code
Server: OBS
x-amz-request-id: request id
x-amz-id-2: id
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
Content-Type: type
Date: date
Content-Length: length
Etag: etag
Last-Modified: time
&lt;Object Content&gt;</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560336__section34497158"><h4 class="sectiontitle">Response Headers</h4><p id="EN-US_TOPIC_0125560336__p37174709">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_0125560336__p55491308">This response can also include optional headers. <a href="#EN-US_TOPIC_0125560336__table29723549">Table 3</a> describes these headers.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560336__table29723549"></a><a name="table29723549"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560336__table29723549" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Optional response headers</caption><thead align="left"><tr id="EN-US_TOPIC_0125560336__row58585662"><th align="left" class="cellrowborder" valign="top" width="32.74%" id="mcps1.3.10.4.2.3.1.1"><p id="EN-US_TOPIC_0125560336__p47818216">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="67.25999999999999%" id="mcps1.3.10.4.2.3.1.2"><p id="EN-US_TOPIC_0125560336__p48070315">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0125560336__row1381422"><td class="cellrowborder" valign="top" width="32.74%" headers="mcps1.3.10.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560336__p44786329">x-amz-expiration</p>
</td>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560336__p3814037">This header is included in the response if the object expiration is configured. This header includes <strong id="EN-US_TOPIC_0125560336__b229714281211">expiry-date</strong> and <strong id="EN-US_TOPIC_0125560336__b130195001217">rule-id</strong> key value pairs to provide object expiration information.</p>
<p id="EN-US_TOPIC_0125560336__p28969880">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row59402334"><td class="cellrowborder" valign="top" width="32.74%" headers="mcps1.3.10.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560336__p46859772">x-amz-website-redirect-location</p>
</td>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560336__p37545162">When a bucket is configured as a website, you can set this metadata for the object so that the website endpoint will evaluate the request for the object as a 301 redirect to another object in the same bucket or an external URL.</p>
<p id="EN-US_TOPIC_0125560336__p2362138">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row21259248"><td class="cellrowborder" valign="top" width="32.74%" headers="mcps1.3.10.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560336__p44277527">x-amz-delete-marker</p>
</td>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560336__p29709926">Indicates whether an object is marked as deleted. If an object is not marked as deleted, the header is not returned.</p>
<p id="EN-US_TOPIC_0125560336__p66062749">Type: Boolean</p>
<p id="EN-US_TOPIC_0125560336__p57693830">Valid values: true|false</p>
<p id="EN-US_TOPIC_0125560336__p49482428">Default: false</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row42688671"><td class="cellrowborder" valign="top" width="32.74%" headers="mcps1.3.10.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560336__p35230296">x-amz-version-id</p>
</td>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560336__p35081689">Indicates the version ID of an object. If an object has no version ID specified, this header is not returned.</p>
<p id="EN-US_TOPIC_0125560336__p47299748">Valid values: String</p>
<p id="EN-US_TOPIC_0125560336__p23044555">Default: None</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row18613230163532"><td class="cellrowborder" valign="top" width="32.74%" headers="mcps1.3.10.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560336__p18376122163614">Access-Control-Allow-Origin</p>
</td>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560336__p12070905163614">CORS is configured for buckets. If <strong id="EN-US_TOPIC_0125560336__b41529288163614">Origin</strong> in the request meets the CORS configuration requirements, <strong id="EN-US_TOPIC_0125560336__b38219273163614">Origin</strong> is included in the response.</p>
<p id="EN-US_TOPIC_0125560336__p8429143163614">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row38006271163539"><td class="cellrowborder" valign="top" width="32.74%" headers="mcps1.3.10.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560336__p37938875163614">Access-Control-Allow-Headers</p>
</td>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560336__p53149996163614">CORS is configured for buckets. If <strong id="EN-US_TOPIC_0125560336__b8587919163614">headers</strong> in the request meet the CORS configuration requirements, <strong id="EN-US_TOPIC_0125560336__b10182414163614">headers</strong> are included in the response.</p>
<p id="EN-US_TOPIC_0125560336__p24532864163614">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row22290404163545"><td class="cellrowborder" valign="top" width="32.74%" headers="mcps1.3.10.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560336__p33500739163614">Access-Control-Max-Age</p>
</td>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560336__p29205351163614">Indicates <strong id="EN-US_TOPIC_0125560336__b61521567163614">MaxAgeSeconds</strong> in the CORS configuration of a server when CORS is configured for buckets.</p>
<p id="EN-US_TOPIC_0125560336__p16823194163614">Type: Integer</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row58327138163550"><td class="cellrowborder" valign="top" width="32.74%" headers="mcps1.3.10.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560336__p50295874163614">Access-Control-Allow-Methods</p>
</td>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560336__p47433974163614">CORS is configured for buckets. If <strong id="EN-US_TOPIC_0125560336__b24252585163614">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_0125560336__p16946679163614">Type: String</p>
<p id="EN-US_TOPIC_0125560336__p18302383163614">Valid values: <strong id="EN-US_TOPIC_0125560336__b30503724163614">GET</strong>, <strong id="EN-US_TOPIC_0125560336__b6098061163614">PUT</strong>, <strong id="EN-US_TOPIC_0125560336__b54882557163614">HEAD</strong>, <strong id="EN-US_TOPIC_0125560336__b24180972163614">POST</strong>, and <strong id="EN-US_TOPIC_0125560336__b16302164163614">DELETE</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row18597873163557"><td class="cellrowborder" valign="top" width="32.74%" headers="mcps1.3.10.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560336__p6008652163614">Access-Control-Expose-Headers</p>
</td>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560336__p16938780163614">Indicates <strong id="EN-US_TOPIC_0125560336__b1948145618124">ExposeHeader</strong> in the CORS configuration of a server when CORS is configured for buckets.</p>
<p id="EN-US_TOPIC_0125560336__p29863949163614">Type: String</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row32966838102639"><td class="cellrowborder" valign="top" width="32.74%" headers="mcps1.3.10.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560336__p24935902165856">x-amz-server-side-encryption</p>
</td>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560336__p6542148165856">This header is included in a response if SSE-KMS is used.</p>
<p id="EN-US_TOPIC_0125560336__p58879336165856">Type: string</p>
<p id="EN-US_TOPIC_0125560336__p60151979165856">Example: x-amz-server-side-encryption:aws:kms</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row63160593102649"><td class="cellrowborder" valign="top" width="32.74%" headers="mcps1.3.10.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560336__p28704785165856">x-amz-server-side-encryption-aws-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560336__p43386224165856">Indicates the master key ID. This header is included in a response if SSE-KMS is used.</p>
<p id="EN-US_TOPIC_0125560336__p12218175034910">Example: x-amz-server-side-encryption-aws-kms-key-id:arn:aws:kms:sichuan:domainiddomainiddomainiddoma0001:key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row20211970102653"><td class="cellrowborder" valign="top" width="32.74%" headers="mcps1.3.10.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560336__p48325708165856">x-amz-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560336__p22068248165856">Indicates a decryption algorithm. This header is included in a response if SSE-C is used.</p>
<p id="EN-US_TOPIC_0125560336__p64396511165856">Type: string</p>
<p id="EN-US_TOPIC_0125560336__p42697689165856">Example: x-amz-server-side-encryption-customer-algorithm:AES256</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row7749226102645"><td class="cellrowborder" valign="top" width="32.74%" headers="mcps1.3.10.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560336__p55211956165856">x-amz-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560336__p42983464165856">Indicates the MD5 value of a key used to decrypt objects. This header is included in a response if SSE-C is used.</p>
<p id="EN-US_TOPIC_0125560336__p51306856165856">Type: string</p>
<p id="EN-US_TOPIC_0125560336__p59108523165856">Example: x-amz-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row4625798110051"><td class="cellrowborder" valign="top" width="32.74%" headers="mcps1.3.10.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560336__p88555201010">x-amz-storage-class</p>
</td>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560336__p462085421010">This header is returned when the storage class of an object is not Standard.</p>
<p id="EN-US_TOPIC_0125560336__p132236951010">Type: String</p>
<p id="EN-US_TOPIC_0125560336__p519043961010">Valid values: <strong id="EN-US_TOPIC_0125560336__b644863801010">STANDARD_IA</strong> and <strong id="EN-US_TOPIC_0125560336__b435065141010">GLACIER</strong></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0125560336__row66187865174528"><td class="cellrowborder" valign="top" width="32.74%" headers="mcps1.3.10.4.2.3.1.1 "><p id="EN-US_TOPIC_0125560336__p20200022174531">x-amz-restore</p>
</td>
<td class="cellrowborder" valign="top" width="67.25999999999999%" headers="mcps1.3.10.4.2.3.1.2 "><p id="EN-US_TOPIC_0125560336__p34523931174642">This header is returned when the storage class of an object is OBS Cold and the object has been restored.</p>
<p id="EN-US_TOPIC_0125560336__p34829944174712">Example:</p>
<p id="EN-US_TOPIC_0125560336__p30536175174721">x-amz-restore:ongoing-request="false", expiry-date="Wed, 07 Nov 2012 00:00:00 GMT"</p>
<ul id="EN-US_TOPIC_0125560336__ul37302768174938"><li id="EN-US_TOPIC_0125560336__li1057700920407"><strong id="EN-US_TOPIC_0125560336__b2808422520407">ongoing-request="false"</strong>indicates that the object has been restored.</li><li id="EN-US_TOPIC_0125560336__li5143143320407">In <strong id="EN-US_TOPIC_0125560336__b6022971520407">expiry-date="Wed, 07 Nov 2012 00:00:00 GMT"</strong>, <strong id="EN-US_TOPIC_0125560336__b519652920407">expiry-date</strong> indicates the expiry date of the restored object.</li></ul>
<p id="EN-US_TOPIC_0125560336__p33755437174531">Type: String</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0125560336__section42038968"><h4 class="sectiontitle">Response Elements</h4><p id="EN-US_TOPIC_0125560336__p22264835">This response involves no elements.</p>
</div>
<div class="section" id="EN-US_TOPIC_0125560336__section42806400"><h4 class="sectiontitle">Error Responses</h4><p id="EN-US_TOPIC_0125560336__p58621221">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_0125560336__section19552748"><h4 class="sectiontitle">Sample Request for Not Overriding Response Headers</h4><pre class="screen" id="EN-US_TOPIC_0125560336__screen31196010112335">GET /test HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/3.1
Host: bucketname.obs.example.com
Accept: */*
Date: Sat, 03 Dec 2011 08:28:02 +0000
Authorization: AWS BF6C09F302931425E9A7:tQ+A280jUgPCAdSTuUis35T9gWI=</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560336__section41757008"><h4 class="sectiontitle">Sample Response for Not Overriding Response Headers</h4><pre class="screen" id="EN-US_TOPIC_0125560336__screen11159664112353">HTTP/1.1 200 OK
Server: OBS
x-amz-request-id: 001B21A61C6C0000013403098535528C
x-amz-id-2: MDAxQjIxQTYxQzZDMDAwMDAxMzQwMzA5ODUzNTUyOENBQUFBQUFBQWJiYmJiYmJi
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
ETag: "507e3fff69b69bf57d303e807448560b"
Last-Modified: Sat, 03 Dec 2011 08:25:46 GMT
Accept-Ranges: bytes
Content-Length: 30
Content-Type: binary/octet-stream
Date: Sat, 03 Dec 2011 08:28:02 GMT </pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560336__section40268759"><h4 class="sectiontitle">Sample Request for Overriding Headers</h4><pre class="screen" id="EN-US_TOPIC_0125560336__screen63345089112411">GET /test?response-cache-control=No-cache&amp;response-content-disposition=attachment%3B%20filename%3Dtesting.txt&amp;response-content-encoding=x-gzip&amp;response-content-language=mi%2C%20en&amp;response-expires=Thu%2C%2001%20Dec%201994%2016:00:00%20GMT HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/3.1
Host: bucketname.obs.example.com
Accept: */*
Date: Sat, 03 Dec 2011 08:28:02 +0000
Authorization: AWS BF6C09F302931425E9A7: aaStE6nKnw8ihhiIdReoXYlMamW=</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560336__section26874512"><h4 class="sectiontitle">Sample Response for Overriding Headers</h4><pre class="screen" id="EN-US_TOPIC_0125560336__screen24109417112434">HTTP/1.1 200 OK
Server: OBS
x-amz-request-id: 001B21A61C6C0000013403098535528C
x-amz-id-2: MDAxQjIxQTYxQzZDMDAwMDAxMzQwMzA5ODUzNTUyOENBQUFBQUFBQWJiYmJiYmJi
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
ETag: "507e3fff69b69bf57d303e807448560b"
Last-Modified: Sat, 03 Dec 2011 08:25:46 GMT
Accept-Ranges: bytes
Content-Length: 30
Cache-Control: No-cache
Content-Language: mi, en
Expires: Thu, 01 Dec 1994 16:00:00 GMT
Content-Disposition: attachment; filename=testing.txt
Content-Encoding: x-gzip
Content-Type: binary/octet-stream
Date: Sat, 03 Dec 2011 08:28:02 GMT </pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560336__section40544022"><h4 class="sectiontitle">Sample Request for Getting an Object with Version ID Specified</h4><pre class="screen" id="EN-US_TOPIC_0125560336__screen23373174112444">GET /object?versionId=AAABQ47OMnbc0vycq3gAAAANVURTRkha HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/3.1
Host: bucketname.obs.example.com
Accept: */*
Date: Tue, 14 Jan 2014 06:11:49 +0000
Authorization: AWS C9590CEB8EC051BDEC9D:kpuA5lb+IoEOglV5824R4Yb18RE=</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560336__section29351881"><h4 class="sectiontitle">Sample Response for Getting an Object with Version ID Specified</h4><pre class="screen" id="EN-US_TOPIC_0125560336__screen633072112454">HTTP/1.1 200 OK
Server: OBS
x-amz-request-id: DCD2FC9CAB78000001438F609AD59896
x-amz-id-2: nz0bi6ru2wS4OvhkCS1OQ2FwyxjvYwuGv1EI5JVeDpuGwX6weBoX7MRxJwhuXJu9
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
Accept-Ranges: bytes
ETag: "ba1f2511fc30423bdbb183fe33f3dd0f"
Last-Modified: Tue, 14 Jan 2014 03:31:54 GMT
Content-Length: 4
x-amz-version-id: AAABQ47OMnbc0vycq3gAAAANVURTRkha
Content-Type: binary/octet-stream
Date: Tue, 14 Jan 2014 06:11:49 GMT
[4 bytes of object data]</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560336__section62840338"><h4 class="sectiontitle">Sample Request for Getting an Object Whose Latest Version ID Is a Deletion Mark</h4><pre class="screen" id="EN-US_TOPIC_0125560336__screen26628648112510">GET /object HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/3.1
Host: bucketname.obs.example.com
Accept: */*
Date: Tue, 14 Jan 2014 06:17:59 +0000
Authorization: AWS C9590CEB8EC051BDEC9D:MsZcBz1QOULDOhPP1gx1+4hbh4A=</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560336__section28692130"><h4 class="sectiontitle">Sample Response for Getting an Object Whose Latest Version ID Is a Deletion Mark</h4><pre class="screen" id="EN-US_TOPIC_0125560336__screen44140594112535">HTTP/1.1 404 Not Found
Server: OBS
x-amz-request-id: DCD2FC9CAB78000001438F6640529BA9
x-amz-id-2: /BdlSJIqa5Gkl3yEoEgmJKUUak0xjtgCTn9LhbsyJwqG5OVqrkfiateRxF8Gg4AU
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
Content-Type: application/xml
x-amz-version-id: AAABQ49lNT_c0vycq3gAAAAOVURTRkha
x-amz-delete-marker: true
Date: Tue, 14 Jan 2014 06:17:59 GMT
Content-Length: 297
&lt;?xml version="1.0" encoding="UTF-8" standalone="yes"?&gt;
&lt;Error&gt;
&lt;Code&gt;NoSuchKey&lt;/Code&gt;
&lt;Message&gt;The specified key does not exist.&lt;/Message&gt;
&lt;RequestId&gt;DCD2FC9CAB78000001438F6640529BA9&lt;/RequestId&gt;
&lt;HostId&gt;nkbX5Pw7vRd26kP6gRwQQ4AxiN446dN608LMf4/9h/NMdhrWsc17Vnlva6VS23dq&lt;/HostId&gt;
&lt;Key&gt;object&lt;/Key&gt;
&lt;/Error&gt;</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560336__section3311378921371"><h4 class="sectiontitle">Sample Request for Getting an Object and CORS Configuration when CORS is properly configured</h4><pre class="screen" id="EN-US_TOPIC_0125560336__screen2479463393952">GET /object HTTP/1.1
User-Agent: curl/7.19.0 (x86_64-suse-linux-gnu) libcurl/7.19.0 OpenSSL/0.9.8{ zlib/1.2.3 libidn/1.10
Host: bucketname.obs.example.com
Accept: */*
Date: Tue, 28 Apr 2015 13:36:06 +0000
Authorization: AWS D13E0C94E722DD69423C:9PzAsaQnzJfMb2pcUNzaYpxgtSE=
Origin:www.example.com
Access-Control-Request-Headers:acc_header_1</pre>
</div>
<div class="section" id="EN-US_TOPIC_0125560336__section36796706143443"><h4 class="sectiontitle">Sample Response for Getting an Object and CORS Configuration when CORS is properly configured</h4><pre class="screen" id="EN-US_TOPIC_0125560336__screen451090549407">HTTP/1.1 200 OK
x-amz-request-id: 0B2B8A2B224F067CB15E4203ABF583F4
x-amz-id-2: PI5ZL3VEM6LnENYPchIQLKDfMlHanhkCz+CgmqCmyN0AniJZMGKBij9bj7fm4sve
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
Access-Control-Allow-Origin: www.example.com
Access-Control-Allow-Methods: POST,GET,HEAD,PUT
Access-Control-Allow-Headers: acc_header_01
Access-Control-Max-Age: 100
Access-Control-Expose-Headers: exp_header_01
Accept-Ranges: bytes
ETag: "6bcb16084a88ae550811429c0c1e8bc7"
Last-Modified: Tue, 28 Apr 2015 13:38:05 GMT
Content-Length: 264
Content-Type: binary/octet-stream
Date: Tue, 28 Apr 2015 13:38:17 GMTa</pre>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0125560489.html">Operations on Objects</a></div>
</div>
</div>
View Git Blame Copy Permalink