doc-exports/docs/obs/api-ref/obs_04_0083.html

<a name="obs_04_0083"></a><a name="obs_04_0083"></a>

<h1 class="topictitle1">Downloading an Object</h1>
<div id="body7507202"><div class="section" id="obs_04_0083__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="MsoNormal" id="obs_04_0083__p51920639">This operation downloads an object from OBS. Before using this GET operation, check that you have the read permission for the target object. If the object owner has granted anonymous users the read permission for the object, anonymous users can access this object without using the authentication header field.</p>
</div>
<div class="section" id="obs_04_0083__section44822219"><h4 class="sectiontitle">Server-Side Encryption</h4><p class="MsoNormal" id="obs_04_0083__p4103663">If the object uploaded to the server is encrypted on the server using the encryption key provided by the client, downloading the object requires including the encryption key in the message.</p>
</div>
<div class="section" id="obs_04_0083__section746787"><h4 class="sectiontitle">Versioning</h4><p class="MsoNormal" id="obs_04_0083__p63961276">By default, the GET operation returns the current version of an object. If the current version of the object is a delete marker, OBS returns a code meaning that the object does not exist. To obtain an object of a specified version, the <strong id="obs_04_0083__b158935119499">versionId</strong> parameter can be used to specify the desired version.</p>
</div>
<div class="section" id="obs_04_0083__section6721083"><h4 class="sectiontitle">Cold Objects</h4><p class="MsoNormal" id="obs_04_0083__p13480849">If the object you want to download is in the Cold storage class, ensure that this object has been restored before you download it. The response varies depending on the object's restore state. If an object has been restored, the <strong id="obs_04_0083__b1207465602144715">x-obs-restore</strong> header (indicating the expiry date of the object) is returned when the object is successfully downloaded. If you send a request to download Cold objects that have not been restored or are being restored, a <strong id="obs_04_0083__b1231441133144728">403 Forbidden</strong> error will be returned.</p>
</div>
<div class="section" id="obs_04_0083__section60489748"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0083__screen35443285"><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>/ObjectName<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
Range:bytes=byte_range<span class="w"> </span>
<span class="nt">&lt;Optional</span><span class="w"> </span><span class="err">Additional</span><span class="w"> </span><span class="err">Header</span><span class="nt">&gt;</span>
</pre></div></td></tr></table></div>
</div>
<div class="note" id="obs_04_0083__note50554116"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="NotesText" id="obs_04_0083__p52333865">The field is optional. If it does not exist, you can obtain the whole content.</p>
</div></div>
</div>
<div class="section" id="obs_04_0083__section7536823"><h4 class="sectiontitle">Request Parameters</h4><p class="MsoNormal" id="obs_04_0083__p11184673">In a <strong id="obs_04_0083__b65072241">GET</strong> request, you can override values for a set of message headers using the request parameters. Message headers that you can override are <strong id="obs_04_0083__b36360186">Content-Type</strong>, <strong id="obs_04_0083__b58806219">Content-Language</strong>, <strong id="obs_04_0083__b59493923">Expires</strong>, <strong id="obs_04_0083__b65683259">Cache-Control</strong>, <strong id="obs_04_0083__b54278420">Content-Disposition</strong>, and <strong id="obs_04_0083__b18743735">Content-Encoding</strong>. If the target object has multiple versions, use the <strong id="obs_04_0083__b84235270673851">versionId</strong> parameter to specify the version to be downloaded. For details, see <a href="#obs_04_0083__table146505591737">Table 1</a>.</p>
<div class="note" id="obs_04_0083__note717714541474"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="obs_04_0083__p1717716544475">OBS does not process Accept-Encoding carried in a request or compress or decompress the uploaded data. The client determines whether to compress or decompress the data. Some HTTP clients may decompress data based on the Content-Encoding returned by the server. The client program needs to determine whether to decompress and how to decompress the data. To decompress the data, it can modify Content-Encoding (the object metadata stored in OBS) or rewrite Content-Encoding the object is downloaded. If an object download request specifies the rewrite header, the standard HTTP message header returned by OBS is subject to the rewrite content specified in the request.</p>
</div></div>

<div class="tablenoborder"><a name="obs_04_0083__table146505591737"></a><a name="table146505591737"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0083__table146505591737" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="obs_04_0083__row465012591332"><th align="left" class="cellrowborder" valign="top" width="25.72742725727427%" id="mcps1.3.6.4.2.5.1.1"><p id="obs_04_0083__p1265075918315"><strong id="obs_04_0083__b1351114181146">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.598040195980403%" id="mcps1.3.6.4.2.5.1.2"><p id="obs_04_0083__p14298173818412"><strong id="obs_04_0083__b796110214338">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="8.41915808419158%" id="mcps1.3.6.4.2.5.1.3"><p id="obs_04_0083__p929216251343"><strong id="obs_04_0083__b31651346104010">Mandatory (Yes/No)</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="46.255374462553746%" id="mcps1.3.6.4.2.5.1.4"><p id="obs_04_0083__p3650145919319"><strong id="obs_04_0083__b16672226123310">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0083__row1165020591437"><td class="cellrowborder" valign="top" width="25.72742725727427%" headers="mcps1.3.6.4.2.5.1.1 "><p id="obs_04_0083__p865011591839">response-content-type</p>
</td>
<td class="cellrowborder" valign="top" width="19.598040195980403%" headers="mcps1.3.6.4.2.5.1.2 "><p id="obs_04_0083__p265018597315">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.41915808419158%" headers="mcps1.3.6.4.2.5.1.3 "><p id="obs_04_0083__p162923254413">No</p>
</td>
<td class="cellrowborder" valign="top" width="46.255374462553746%" headers="mcps1.3.6.4.2.5.1.4 "><p id="obs_04_0083__p7134184955020"><strong id="obs_04_0083__b82616916783823">Explanation</strong>:</p>
<p id="obs_04_0083__p10626192673918"><strong id="obs_04_0083__b425622953319">Content-Type</strong> is rewritten in the response.</p>
<p id="obs_04_0083__p6599200115718"><strong id="obs_04_0083__b1859915015570">Restrictions</strong>:</p>
<p id="obs_04_0083__p1159916017578">None</p>
<p id="obs_04_0083__p3599709575"><strong id="obs_04_0083__b559914035710">Value range</strong>:</p>
<p id="obs_04_0083__p145996025718">See the Content-Type values defined in HTTP.</p>
<p id="obs_04_0083__p4134149115014"><strong id="obs_04_0083__b28399662684150">Default value</strong>:</p>
<p id="obs_04_0083__p19877131311420">None</p>
</td>
</tr>
<tr id="obs_04_0083__row86501059336"><td class="cellrowborder" valign="top" width="25.72742725727427%" headers="mcps1.3.6.4.2.5.1.1 "><p id="obs_04_0083__p465011599317">response-content-language</p>
</td>
<td class="cellrowborder" valign="top" width="19.598040195980403%" headers="mcps1.3.6.4.2.5.1.2 "><p id="obs_04_0083__p914212384391">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.41915808419158%" headers="mcps1.3.6.4.2.5.1.3 "><p id="obs_04_0083__p112924256412">No</p>
</td>
<td class="cellrowborder" valign="top" width="46.255374462553746%" headers="mcps1.3.6.4.2.5.1.4 "><p id="obs_04_0083__p11535105965510"><strong id="obs_04_0083__b84167741883823">Explanation</strong>:</p>
<p id="obs_04_0083__p551351416419"><strong id="obs_04_0083__b09791234123317">Content-Language</strong> is rewritten in the response.</p>
<p id="obs_04_0083__p1593162218579"><strong id="obs_04_0083__b3593622105716">Restrictions</strong>:</p>
<p id="obs_04_0083__p359362210578">None</p>
<p id="obs_04_0083__p859382217579"><strong id="obs_04_0083__b20593172275717">Value range</strong>:</p>
<p id="obs_04_0083__p19593522165712">See the Content-Language values defined in HTTP.</p>
<p id="obs_04_0083__p1853605925510"><strong id="obs_04_0083__b175623042484150">Default value</strong>:</p>
<p id="obs_04_0083__p1858211487116">None</p>
</td>
</tr>
<tr id="obs_04_0083__row4650185919316"><td class="cellrowborder" valign="top" width="25.72742725727427%" headers="mcps1.3.6.4.2.5.1.1 "><p id="obs_04_0083__p965012591334">response-expires</p>
</td>
<td class="cellrowborder" valign="top" width="19.598040195980403%" headers="mcps1.3.6.4.2.5.1.2 "><p id="obs_04_0083__p5572163933914">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.41915808419158%" headers="mcps1.3.6.4.2.5.1.3 "><p id="obs_04_0083__p1029218251846">No</p>
</td>
<td class="cellrowborder" valign="top" width="46.255374462553746%" headers="mcps1.3.6.4.2.5.1.4 "><p id="obs_04_0083__p8101329562"><strong id="obs_04_0083__b35492111983823">Explanation</strong>:</p>
<p id="obs_04_0083__p116501591831"><strong id="obs_04_0083__b946944083310">Expires</strong> is rewritten in the response.</p>
<p id="obs_04_0083__p0571937155719"><strong id="obs_04_0083__b1657123712572">Restrictions</strong>:</p>
<p id="obs_04_0083__p1957163711575">None</p>
<p id="obs_04_0083__p185710372571"><strong id="obs_04_0083__b135711379572">Value range</strong>:</p>
<p id="obs_04_0083__p55743716571">See the Expires values defined in HTTP.</p>
<p id="obs_04_0083__p111028225619"><strong id="obs_04_0083__b20399772084150">Default value</strong>:</p>
<p id="obs_04_0083__p961071601416">None</p>
</td>
</tr>
<tr id="obs_04_0083__row12650359638"><td class="cellrowborder" valign="top" width="25.72742725727427%" headers="mcps1.3.6.4.2.5.1.1 "><p id="obs_04_0083__p765195919316">response-cache-control</p>
</td>
<td class="cellrowborder" valign="top" width="19.598040195980403%" headers="mcps1.3.6.4.2.5.1.2 "><p id="obs_04_0083__p144386403392">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.41915808419158%" headers="mcps1.3.6.4.2.5.1.3 "><p id="obs_04_0083__p729211251415">No</p>
</td>
<td class="cellrowborder" valign="top" width="46.255374462553746%" headers="mcps1.3.6.4.2.5.1.4 "><p id="obs_04_0083__p9967124155610"><strong id="obs_04_0083__b61979191983823">Explanation</strong>:</p>
<p id="obs_04_0083__p1126595564016"><strong id="obs_04_0083__b1838834583312">Cache-Control</strong> is rewritten in the response.</p>
<p id="obs_04_0083__p2144135145716"><strong id="obs_04_0083__b21441051195715">Restrictions</strong>:</p>
<p id="obs_04_0083__p19144851145720">None</p>
<p id="obs_04_0083__p41441051195716"><strong id="obs_04_0083__b1144155125714">Value range</strong>:</p>
<p id="obs_04_0083__p1014455195719">See the Cache-control values defined in HTTP.</p>
<p id="obs_04_0083__p996712445617"><strong id="obs_04_0083__b170183589884150">Default value</strong>:</p>
<p id="obs_04_0083__p51949210142">None</p>
</td>
</tr>
<tr id="obs_04_0083__row1165115592319"><td class="cellrowborder" valign="top" width="25.72742725727427%" headers="mcps1.3.6.4.2.5.1.1 "><p id="obs_04_0083__p465112591234">response-content-disposition</p>
</td>
<td class="cellrowborder" valign="top" width="19.598040195980403%" headers="mcps1.3.6.4.2.5.1.2 "><p id="obs_04_0083__p17669134173919">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.41915808419158%" headers="mcps1.3.6.4.2.5.1.3 "><p id="obs_04_0083__p42921251543">No</p>
</td>
<td class="cellrowborder" valign="top" width="46.255374462553746%" headers="mcps1.3.6.4.2.5.1.4 "><p id="obs_04_0083__p1142114755612"><strong id="obs_04_0083__b44214852583823">Explanation</strong>:</p>
<p id="obs_04_0083__p76511559739"><strong id="obs_04_0083__b9886165153313">Content-Disposition</strong> is rewritten in the response.</p>
<p id="obs_04_0083__p2651105917319">Example:</p>
<p id="obs_04_0083__p1065105914317">response-content-disposition=attachment; filename*=utf-8''name1</p>
<p id="obs_04_0083__p10651159133">In this example, the downloaded object is renamed <strong id="obs_04_0083__b21902749835348">name1</strong>. If the new name contains any full-width characters, such characters must be URL-encoded.</p>
<p id="obs_04_0083__p172676845819"><strong id="obs_04_0083__b1826748165811">Restrictions</strong>:</p>
<p id="obs_04_0083__p82679811581">None</p>
<p id="obs_04_0083__p62671825811"><strong id="obs_04_0083__b182671486589">Value range</strong>:</p>
<p id="obs_04_0083__p15267489589">None</p>
<p id="obs_04_0083__p94217716560"><strong id="obs_04_0083__b83224681184150">Default value</strong>:</p>
<p id="obs_04_0083__p1358424121516">None</p>
</td>
</tr>
<tr id="obs_04_0083__row1365195917314"><td class="cellrowborder" valign="top" width="25.72742725727427%" headers="mcps1.3.6.4.2.5.1.1 "><p id="obs_04_0083__p665155914318">response-content-encoding</p>
</td>
<td class="cellrowborder" valign="top" width="19.598040195980403%" headers="mcps1.3.6.4.2.5.1.2 "><p id="obs_04_0083__p164243123911">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.41915808419158%" headers="mcps1.3.6.4.2.5.1.3 "><p id="obs_04_0083__p1429315252042">No</p>
</td>
<td class="cellrowborder" valign="top" width="46.255374462553746%" headers="mcps1.3.6.4.2.5.1.4 "><p id="obs_04_0083__p533971118563"><strong id="obs_04_0083__b194476004983823">Explanation</strong>:</p>
<p id="obs_04_0083__p66971231164014"><strong id="obs_04_0083__b189387212341">Content-Encoding</strong> is rewritten in the response.</p>
<p id="obs_04_0083__p207554421308"><strong id="obs_04_0083__b775519426017">Restrictions</strong>:</p>
<p id="obs_04_0083__p675514426012">None</p>
<p id="obs_04_0083__p197552421503"><strong id="obs_04_0083__b167559427015">Value range</strong>:</p>
<p id="obs_04_0083__p9755164213015">See the Content-Encoding values defined in HTTP.</p>
<p id="obs_04_0083__p67559421106"><strong id="obs_04_0083__b577911852">Default value</strong>:</p>
<p id="obs_04_0083__p1875518425019">None</p>
</td>
</tr>
<tr id="obs_04_0083__row1965118592315"><td class="cellrowborder" valign="top" width="25.72742725727427%" headers="mcps1.3.6.4.2.5.1.1 "><p id="obs_04_0083__p5651459637">versionId</p>
</td>
<td class="cellrowborder" valign="top" width="19.598040195980403%" headers="mcps1.3.6.4.2.5.1.2 "><p id="obs_04_0083__p157814416398">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.41915808419158%" headers="mcps1.3.6.4.2.5.1.3 "><p id="obs_04_0083__p729313253410">No</p>
</td>
<td class="cellrowborder" valign="top" width="46.255374462553746%" headers="mcps1.3.6.4.2.5.1.4 "><p id="obs_04_0083__p1930471485619"><strong id="obs_04_0083__b86500749183823">Explanation</strong>:</p>
<p id="obs_04_0083__p163694197404">Indicates the version ID of the object to be obtained.</p>
<p id="obs_04_0083__p16304514175614"><strong id="obs_04_0083__b1083720673410">Restrictions</strong>:</p>
<p id="obs_04_0083__p2055895114">None</p>
<p id="obs_04_0083__p530411415567"><strong id="obs_04_0083__b81600509784057">Value range</strong>:</p>
<p id="obs_04_0083__p107711946175">The value must contain 32 characters.</p>
<p id="obs_04_0083__p730421445618"><strong id="obs_04_0083__b196363026784150">Default value</strong>:</p>
<p id="obs_04_0083__p1235514717178">None. If this parameter is not configured, the latest version of the object is obtained.</p>
</td>
</tr>
<tr id="obs_04_0083__row17651259232"><td class="cellrowborder" valign="top" width="25.72742725727427%" headers="mcps1.3.6.4.2.5.1.1 "><p id="obs_04_0083__p465115910320">attname</p>
</td>
<td class="cellrowborder" valign="top" width="19.598040195980403%" headers="mcps1.3.6.4.2.5.1.2 "><p id="obs_04_0083__p205115023913">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.41915808419158%" headers="mcps1.3.6.4.2.5.1.3 "><p id="obs_04_0083__p122931425146">No</p>
</td>
<td class="cellrowborder" valign="top" width="46.255374462553746%" headers="mcps1.3.6.4.2.5.1.4 "><p id="obs_04_0083__p1512561945618"><strong id="obs_04_0083__b106814013783823">Explanation</strong>:</p>
<p id="obs_04_0083__p7651135914310"><strong id="obs_04_0083__b182042717347">Content-Disposition</strong> is rewritten in the response.</p>
<p id="obs_04_0083__p156521159930">Example:</p>
<p id="obs_04_0083__p3652205913315">attname=name1</p>
<p id="obs_04_0083__p14652115917315">This example renames the downloaded object as <strong id="obs_04_0083__b229673053416">name1</strong>.</p>
<p id="obs_04_0083__p1760914228213"><strong id="obs_04_0083__b060915221722">Restrictions</strong>:</p>
<p id="obs_04_0083__p1660910229213">None</p>
<p id="obs_04_0083__p1861017221222"><strong id="obs_04_0083__b1261017221028">Value range</strong>:</p>
<p id="obs_04_0083__p36108221212">None</p>
<p id="obs_04_0083__p5610172214217"><strong id="obs_04_0083__b2002892801">Default value</strong>:</p>
<p id="obs_04_0083__p1361062219211">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0083__section722550"><h4 class="sectiontitle">Request Headers</h4><p class="MsoNormal" id="obs_04_0083__p11066235">This request uses common headers. In addition, you can add additional headers to this request. <a href="#obs_04_0083__table135831221650">Table 2</a> describes the additional headers.</p>

<div class="tablenoborder"><a name="obs_04_0083__table135831221650"></a><a name="table135831221650"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0083__table135831221650" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request headers</caption><thead align="left"><tr id="obs_04_0083__row1958372215518"><th align="left" class="cellrowborder" valign="top" width="16.61%" id="mcps1.3.7.3.2.5.1.1"><p id="obs_04_0083__p958314223511">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13.76%" id="mcps1.3.7.3.2.5.1.2"><p id="obs_04_0083__p8360143459"><strong id="obs_04_0083__b123781513169">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13.120000000000001%" id="mcps1.3.7.3.2.5.1.3"><p id="obs_04_0083__p2921339151"><strong id="obs_04_0083__b9275165212473">Mandatory (Yes/No)</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="56.510000000000005%" id="mcps1.3.7.3.2.5.1.4"><p id="obs_04_0083__p20583172219513"><strong id="obs_04_0083__b15406140183418">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0083__row18583192219512"><td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.3.7.3.2.5.1.1 "><p id="obs_04_0083__p14583922254">Range</p>
</td>
<td class="cellrowborder" valign="top" width="13.76%" headers="mcps1.3.7.3.2.5.1.2 "><p id="obs_04_0083__p198350301412">String</p>
</td>
<td class="cellrowborder" valign="top" width="13.120000000000001%" headers="mcps1.3.7.3.2.5.1.3 "><p id="obs_04_0083__p658118278613">No</p>
</td>
<td class="cellrowborder" valign="top" width="56.510000000000005%" headers="mcps1.3.7.3.2.5.1.4 "><p id="obs_04_0083__p4852529145611"><strong id="obs_04_0083__b165433004883823">Explanation</strong>:</p>
<p id="obs_04_0083__p17583022555">Obtains the object content within the scope defined by <strong id="obs_04_0083__b1045310480">Range</strong>. If the parameter value is invalid, the entire object is obtained.</p>
<p id="obs_04_0083__p108533291561"><strong id="obs_04_0083__b25401244193420">Restrictions</strong>:</p>
<ul id="obs_04_0083__ul428114517276"><li id="obs_04_0083__li112811445142710"><strong id="obs_04_0083__b2073008076">Range</strong> value starts from 0, and the maximum value equals the object length minus 1. The start value of <strong id="obs_04_0083__b1254902910">Range</strong> is mandatory. If only the start value is specified, the system obtains the object content from the start value to default maximum value.<p id="obs_04_0083__p143831948202717">bytes=byte_range</p>
<p id="obs_04_0083__p15383154818279">Example 1: <strong id="obs_04_0083__b1838539586">bytes=0-4</strong></p>
<p id="obs_04_0083__p1538354815273">Example 2: <strong id="obs_04_0083__b1511818001">bytes=1024</strong></p>
<p id="obs_04_0083__p1738334822720">Example 3: <strong id="obs_04_0083__b1900807157">bytes=10-20, 30-40</strong> (multiple ranges)</p>
</li><li id="obs_04_0083__li328154572717">After the <strong id="obs_04_0083__b647559623">Range</strong> header field is carried, the value of ETag in the response message is the ETag of the object instead of the ETag of the object in the <strong id="obs_04_0083__b1353371457">Range</strong> field.</li></ul>
<p id="obs_04_0083__p10416205210319"><strong id="obs_04_0083__b441619522030">Value range</strong>:</p>
<p id="obs_04_0083__p10416452538"><strong id="obs_04_0083__b1411928456">Range</strong> value starts from 0, and the maximum value equals the object length minus 1.</p>
<p id="obs_04_0083__p1141617521337"><strong id="obs_04_0083__b1404613402">Default value</strong>:</p>
<p id="obs_04_0083__p1041620523316">None</p>
</td>
</tr>
<tr id="obs_04_0083__row175832022959"><td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.3.7.3.2.5.1.1 "><p id="obs_04_0083__p458310222510">If-Modified-Since</p>
</td>
<td class="cellrowborder" valign="top" width="13.76%" headers="mcps1.3.7.3.2.5.1.2 "><p id="obs_04_0083__p1136019431656">HTTP time string complying with the format specified at <strong id="obs_04_0083__b151819209235348">http://www.ietf.org/rfc/rfc2616.txt</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="13.120000000000001%" headers="mcps1.3.7.3.2.5.1.3 "><p id="obs_04_0083__p858120275619">No</p>
</td>
<td class="cellrowborder" valign="top" width="56.510000000000005%" headers="mcps1.3.7.3.2.5.1.4 "><p id="obs_04_0083__p1069218378569"><strong id="obs_04_0083__b134491235683823">Explanation</strong>:</p>
<p id="obs_04_0083__p175920287519">Returns the object only if it has been modified since the time specified by this header. Otherwise, <strong id="obs_04_0083__b854384366">304 Not Modified</strong> is returned.</p>
<p id="obs_04_0083__p1958720550"><strong id="obs_04_0083__b495820201357">Restrictions</strong>:</p>
<p id="obs_04_0083__p16958520953">The time specified by this parameter cannot be later than the current server time (GMT time), or this parameter does not take effect.</p>
<p id="obs_04_0083__p7958162013513"><strong id="obs_04_0083__b2958220751">Value range</strong>:</p>
<p id="obs_04_0083__p79583201518">HTTP time string complying with the format specified at <strong id="obs_04_0083__b4651233144912">http://www.ietf.org/rfc/rfc2616.txt</strong>.</p>
<ol id="obs_04_0083__ol128921737255"><li id="obs_04_0083__li289211374513">EEE, dd MMM yyyy HH:mm:ss z</li><li id="obs_04_0083__li1289217371956">EEEE, dd-MMM-yy HH:mm:ss z</li><li id="obs_04_0083__li19892123715512">EEE MMM dd HH:mm:ss yyyy</li></ol>
<p id="obs_04_0083__p149585200519">Examples:</p>
<ol id="obs_04_0083__ol875015489515"><li id="obs_04_0083__li107503481157">if-modified-since: Sun, 06 Nov 1994 08:49:37 GMT</li><li id="obs_04_0083__li1175019481855">if-modified-since: Sunday, 06-Nov-94 08:49:37 GMT</li><li id="obs_04_0083__li1775014815514">if-modified-since: Sun Nov  6 08:49:37 1994</li></ol>
<p id="obs_04_0083__p109584201552"><strong id="obs_04_0083__b271873971">Default value</strong>:</p>
<p id="obs_04_0083__p189584201458">None</p>
</td>
</tr>
<tr id="obs_04_0083__row105831722158"><td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.3.7.3.2.5.1.1 "><p id="obs_04_0083__p958317221155">If-Unmodified-Since</p>
</td>
<td class="cellrowborder" valign="top" width="13.76%" headers="mcps1.3.7.3.2.5.1.2 "><p id="obs_04_0083__p12381286508">HTTP time string complying with the format specified at <strong id="obs_04_0083__b859074213310">http://www.ietf.org/rfc/rfc2616.txt</strong>. </p>
</td>
<td class="cellrowborder" valign="top" width="13.120000000000001%" headers="mcps1.3.7.3.2.5.1.3 "><p id="obs_04_0083__p858152717617">No</p>
</td>
<td class="cellrowborder" valign="top" width="56.510000000000005%" headers="mcps1.3.7.3.2.5.1.4 "><p id="obs_04_0083__p162671043145617"><strong id="obs_04_0083__b56534662083823">Explanation</strong>:</p>
<p id="obs_04_0083__p958417221655">If the object has not been modified since the time specified by this header, it is returned. Otherwise, 412 (precondition failed) is returned.</p>
<p id="obs_04_0083__p15533235610"><strong id="obs_04_0083__b65312231462">Restrictions</strong>:</p>
<p id="obs_04_0083__p35319231663">The time specified by this parameter cannot be later than the current server time (GMT time), or this parameter does not take effect.</p>
<p id="obs_04_0083__p10539236618"><strong id="obs_04_0083__b2530239614">Value range</strong>:</p>
<p id="obs_04_0083__p1153323968">HTTP time string complying with the format specified at <strong id="obs_04_0083__b74331034135319">http://www.ietf.org/rfc/rfc2616.txt</strong>.</p>
<ol id="obs_04_0083__ol5879134019614"><li id="obs_04_0083__li28795409619">EEE, dd MMM yyyy HH:mm:ss z</li><li id="obs_04_0083__li14879640560">EEEE, dd-MMM-yy HH:mm:ss z</li><li id="obs_04_0083__li687912401369">EEE MMM dd HH:mm:ss yyyy</li></ol>
<p id="obs_04_0083__p65372312616">Examples:</p>
<ol id="obs_04_0083__ol86511381161"><li id="obs_04_0083__li365173810618">if-unmodified-since: Sun, 06 Nov 1994 08:49:37 GMT</li><li id="obs_04_0083__li1065193815610">if-unmodified-since: Sunday, 06-Nov-94 08:49:37 GMT</li><li id="obs_04_0083__li166563815612">if-unmodified-since: Sun Nov  6 08:49:37 1994</li></ol>
<p id="obs_04_0083__p253132312612"><strong id="obs_04_0083__b274267964">Default value</strong>:</p>
<p id="obs_04_0083__p0534231065">None</p>
</td>
</tr>
<tr id="obs_04_0083__row558432214510"><td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.3.7.3.2.5.1.1 "><p id="obs_04_0083__p258418221759">If-Match</p>
</td>
<td class="cellrowborder" valign="top" width="13.76%" headers="mcps1.3.7.3.2.5.1.2 "><p id="obs_04_0083__p02211235124114">String</p>
</td>
<td class="cellrowborder" valign="top" width="13.120000000000001%" headers="mcps1.3.7.3.2.5.1.3 "><p id="obs_04_0083__p165811927764">No</p>
</td>
<td class="cellrowborder" valign="top" width="56.510000000000005%" headers="mcps1.3.7.3.2.5.1.4 "><p id="obs_04_0083__p1932134585617"><strong id="obs_04_0083__b208797169783823">Explanation</strong>:</p>
<p id="obs_04_0083__p85843224514">Returns the object only if its ETag is the same as the one specified by this header. Otherwise, <strong id="obs_04_0083__b241186878">412 Precondition Failed</strong> is returned.</p>
<p id="obs_04_0083__p25845225514">ETag example: <strong id="obs_04_0083__b49819846835348">0f64741bf7cb1089e988e4585d0d3434</strong></p>
<p id="obs_04_0083__p10850701671"><strong id="obs_04_0083__b118501201278">Restrictions</strong>:</p>
<p id="obs_04_0083__p2850901474">None</p>
<p id="obs_04_0083__p198501401577"><strong id="obs_04_0083__b3850409715">Value range</strong>:</p>
<p id="obs_04_0083__p178501905719">Object ETag</p>
<p id="obs_04_0083__p178502011717"><strong id="obs_04_0083__b830576410">Default value</strong>:</p>
<p id="obs_04_0083__p68501603719">None</p>
</td>
</tr>
<tr id="obs_04_0083__row45840221556"><td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.3.7.3.2.5.1.1 "><p id="obs_04_0083__p10584112214517">If-None-Match</p>
</td>
<td class="cellrowborder" valign="top" width="13.76%" headers="mcps1.3.7.3.2.5.1.2 "><p id="obs_04_0083__p184211640124115">String</p>
</td>
<td class="cellrowborder" valign="top" width="13.120000000000001%" headers="mcps1.3.7.3.2.5.1.3 "><p id="obs_04_0083__p1658119271612">No</p>
</td>
<td class="cellrowborder" valign="top" width="56.510000000000005%" headers="mcps1.3.7.3.2.5.1.4 "><p id="obs_04_0083__p206591548135618"><strong id="obs_04_0083__b42602241583823">Explanation</strong>:</p>
<p id="obs_04_0083__p1058412226511">Returns the object only if its ETag is different from the one specified by this header. Otherwise, <strong id="obs_04_0083__b2062680567">304 Not Modified</strong> is returned.</p>
<p id="obs_04_0083__p1458417224511">ETag example: <strong id="obs_04_0083__b9402489351">0f64741bf7cb1089e988e4585d0d3434</strong></p>
<p id="obs_04_0083__p2085217181272"><strong id="obs_04_0083__b14852191818713">Restrictions</strong>:</p>
<p id="obs_04_0083__p14852101818710">None</p>
<p id="obs_04_0083__p18852181815711"><strong id="obs_04_0083__b08523181479">Value range</strong>:</p>
<p id="obs_04_0083__p1985221816712">Object ETag</p>
<p id="obs_04_0083__p188529181375"><strong id="obs_04_0083__b1543085747">Default value</strong>:</p>
<p id="obs_04_0083__p685219183718">None</p>
</td>
</tr>
<tr id="obs_04_0083__row125841622155"><td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.3.7.3.2.5.1.1 "><p id="obs_04_0083__p4584222755">x-obs-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="13.76%" headers="mcps1.3.7.3.2.5.1.2 "><p id="obs_04_0083__p14236247174116">String</p>
</td>
<td class="cellrowborder" valign="top" width="13.120000000000001%" headers="mcps1.3.7.3.2.5.1.3 "><p id="obs_04_0083__p1558132710616">No. This header is required when SSE-C is used.</p>
</td>
<td class="cellrowborder" valign="top" width="56.510000000000005%" headers="mcps1.3.7.3.2.5.1.4 "><p id="obs_04_0083__p14976155013567"><strong id="obs_04_0083__b165079444483823">Explanation</strong>:</p>
<p id="obs_04_0083__p458410223516">Indicates the encryption algorithm used when SSE-C is used.</p>
<p id="obs_04_0083__p558472218518">Example: <strong id="obs_04_0083__b1043481192">x-obs-server-side-encryption-customer-algorithm:AES256</strong></p>
<p id="obs_04_0083__p20976145005615"><strong id="obs_04_0083__b99768503565">Restrictions</strong>:</p>
<p id="obs_04_0083__p182684515494">This header must be used together with <strong id="obs_04_0083__b125170179350">x-obs-server-side-encryption-customer-key</strong> and <strong id="obs_04_0083__b05172017153515">x-obs-server-side-encryption-customer-key-MD5</strong>.</p>
<p id="obs_04_0083__p12539143012710"><strong id="obs_04_0083__b12539153014712">Value range</strong>:</p>
<p id="obs_04_0083__p17539530870">AES256</p>
<p id="obs_04_0083__p5539630772"><strong id="obs_04_0083__b426879292">Default value</strong>:</p>
<p id="obs_04_0083__p85394301779">None</p>
</td>
</tr>
<tr id="obs_04_0083__row158412227515"><td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.3.7.3.2.5.1.1 "><p id="obs_04_0083__p175846221653">x-obs-server-side-encryption-customer-key</p>
</td>
<td class="cellrowborder" valign="top" width="13.76%" headers="mcps1.3.7.3.2.5.1.2 "><p id="obs_04_0083__p15720125114412">String</p>
</td>
<td class="cellrowborder" valign="top" width="13.120000000000001%" headers="mcps1.3.7.3.2.5.1.3 "><p id="obs_04_0083__p13581132711617">No. This header is required when SSE-C is used.</p>
</td>
<td class="cellrowborder" valign="top" width="56.510000000000005%" headers="mcps1.3.7.3.2.5.1.4 "><p id="obs_04_0083__p13973753175616"><strong id="obs_04_0083__b66199381483823">Explanation</strong>:</p>
<p id="obs_04_0083__p7584122216512">Indicates the encryption key used when SSE-C is used. This key is used to decrypt objects.</p>
<p id="obs_04_0083__p10584122957">Example: <strong id="obs_04_0083__b906944342">x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=</strong></p>
<p id="obs_04_0083__p19732535562"><strong id="obs_04_0083__b19734534563">Restrictions</strong>:</p>
<p id="obs_04_0083__p3322103114493">This header is a Base64-encoded 256-bit key and must be used together with <strong id="obs_04_0083__b1451152623516">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0083__b125282653517">x-obs-server-side-encryption-customer-key-MD5</strong>.</p>
<p id="obs_04_0083__p1822614116"><strong id="obs_04_0083__b58221414512">Value range</strong>:</p>
<p id="obs_04_0083__p034611531718">None</p>
<p id="obs_04_0083__p20822111419116"><strong id="obs_04_0083__b1852446270">Default value</strong>:</p>
<p id="obs_04_0083__p1182211419113">None</p>
</td>
</tr>
<tr id="obs_04_0083__row1258410221759"><td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.3.7.3.2.5.1.1 "><p id="obs_04_0083__p95848221352">x-obs-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="13.76%" headers="mcps1.3.7.3.2.5.1.2 "><p id="obs_04_0083__p14360843650">String</p>
</td>
<td class="cellrowborder" valign="top" width="13.120000000000001%" headers="mcps1.3.7.3.2.5.1.3 "><p id="obs_04_0083__p15581132713619">No. This header is required when SSE-C is used.</p>
</td>
<td class="cellrowborder" valign="top" width="56.510000000000005%" headers="mcps1.3.7.3.2.5.1.4 "><p id="obs_04_0083__p262955675614"><strong id="obs_04_0083__b50357551683823">Explanation</strong>:</p>
<p id="obs_04_0083__p458418221654">Indicates the MD5 value of the encryption key when SSE-C is used. The MD5 value is used to check whether any error occurs during the transmission of the key. </p>
<p id="obs_04_0083__p758410224513">Example: <strong id="obs_04_0083__b1944332725">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0083__p19629356175619"><strong id="obs_04_0083__b1462905615610">Restrictions</strong>:</p>
<p id="obs_04_0083__p750161494918">This header is a Base64-encoded 128-bit MD5 value and must be used together with <strong id="obs_04_0083__b129556772635348">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0083__b203001087035348">x-obs-server-side-encryption-customer-key</strong>.</p>
<p id="obs_04_0083__p1282316171612"><strong id="obs_04_0083__b3823017912">Value range</strong>:</p>
<p id="obs_04_0083__p1579316176815">Base64-encoded MD5 value of the key ID.</p>
<p id="obs_04_0083__p8823181710119"><strong id="obs_04_0083__b2069501961">Default value</strong>:</p>
<p id="obs_04_0083__p1282311717110">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0083__section6502952"><h4 class="sectiontitle">Request Elements</h4><p class="MsoNormal" id="obs_04_0083__p53081621">This request involves no elements.</p>
</div>
<div class="section" id="obs_04_0083__section58526576"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0083__screen36163751"><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></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>status_code<span class="w"> </span>
Content-Type:<span class="w"> </span>type<span class="w"> </span>
Date:<span class="w"> </span>date<span class="w"> </span>
Content-Length:<span class="w"> </span>length<span class="w"> </span>
Etag:<span class="w"> </span>etag<span class="w"> </span>
Last-Modified:<span class="w"> </span>time<span class="w"> </span>

<span class="nt">&lt;Object</span><span class="w"> </span><span class="err">Content</span><span class="nt">&gt;</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0083__section56977142"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0083__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>
<p class="MsoNormal" id="obs_04_0083__p40541517">In addition to the common response headers, the headers listed in <a href="#obs_04_0083__table9973124855219">Table 3</a> may be used.</p>

<div class="tablenoborder"><a name="obs_04_0083__table9973124855219"></a><a name="table9973124855219"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0083__table9973124855219" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0083__row6974144815529"><th align="left" class="cellrowborder" valign="top" width="29.080000000000002%" id="mcps1.3.10.4.2.4.1.1"><p id="obs_04_0083__p697454875210">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20.77%" id="mcps1.3.10.4.2.4.1.2"><p id="obs_04_0083__p10734183902110"><strong id="obs_04_0083__b197731847142118">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50.14999999999999%" id="mcps1.3.10.4.2.4.1.3"><p id="obs_04_0083__p159741848105219">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0083__row179741248135213"><td class="cellrowborder" valign="top" width="29.080000000000002%" headers="mcps1.3.10.4.2.4.1.1 "><p id="obs_04_0083__p7974144817521">x-obs-expiration</p>
</td>
<td class="cellrowborder" valign="top" width="20.77%" headers="mcps1.3.10.4.2.4.1.2 "><p id="obs_04_0083__p167345399214">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.14999999999999%" headers="mcps1.3.10.4.2.4.1.3 "><p id="obs_04_0083__p143941386220"><strong id="obs_04_0083__b1250709818">Explanation</strong>:</p>
<p id="obs_04_0083__p1423110114403">Expiration time of an object.</p>
<p id="obs_04_0083__p163948814223"><strong id="obs_04_0083__b15394086226">Restrictions</strong>:</p>
<p id="obs_04_0083__p14974104817529">When an object has its lifecycle rule, the object expiration time is subject to its lifecycle rule. This header field is use <strong id="obs_04_0083__b1318898993">expiry-date</strong> to describe the object expiration date. If the lifecycle rule is configured only for the entire bucket not individual objects, the object expiration time is subject to the bucket lifecycle rule. This header field uses the <strong id="obs_04_0083__b658096818">expiry-date</strong> and <strong id="obs_04_0083__b434001297">rule-id</strong> to describe the detailed expiration information of objects. If no lifecycle rule is configured, this header field is not contained in the response.</p>
<p id="obs_04_0083__p179072037141014"><strong id="obs_04_0083__b11907193715104">Value range</strong>:</p>
<p id="obs_04_0083__p1690710376102">The time format is EEE, dd MMM yyyy HH:mm:ss z.</p>
<p id="obs_04_0083__p4907137101015">Example: <strong id="obs_04_0083__b42681716175910">expiry-date=Sun, 06 Nov 1994 08:49:37 GMT</strong></p>
<p id="obs_04_0083__p490773712104"><strong id="obs_04_0083__b1290580522">Default value</strong>:</p>
<p id="obs_04_0083__p3907133718100">None</p>
</td>
</tr>
<tr id="obs_04_0083__row597412489525"><td class="cellrowborder" valign="top" width="29.080000000000002%" headers="mcps1.3.10.4.2.4.1.1 "><p id="obs_04_0083__p17974248145216">x-obs-website-redirect-location</p>
</td>
<td class="cellrowborder" valign="top" width="20.77%" headers="mcps1.3.10.4.2.4.1.2 "><p id="obs_04_0083__p3734639202110">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.14999999999999%" headers="mcps1.3.10.4.2.4.1.3 "><p id="obs_04_0083__p094317409501"><strong id="obs_04_0083__b13742759133519">Explanation</strong>:</p>
<p id="obs_04_0083__p52720700">Indicates where an object request is redirected. If the bucket that contains the object is configured with Website settings, this parameter can be set in the object metadata so that the request for the object can be redirected to another object in the same bucket or an external URL after the website returns a 301 redirect response.</p>
<p id="obs_04_0083__p21367535">To another object in the same bucket:</p>
<p id="obs_04_0083__p58090092">x-obs-website-redirect-location:/anotherPage.html</p>
<p id="obs_04_0083__p53048785">To an external URL:</p>
<p id="obs_04_0083__p7677024">x-obs-website-redirect-location:http://www.example.com/</p>
<p id="obs_04_0083__p1495145813353">OBS obtains the specified value from the header and stores it in the object metadata <strong id="obs_04_0083__b1286173712815">WebsiteRedirectLocation</strong>.</p>
<p id="obs_04_0083__p13943114015018"><strong id="obs_04_0083__b18944840165010">Restrictions</strong>:</p>
<ul id="obs_04_0083__ul785643713715"><li id="obs_04_0083__li1985614370378">The value must start with a slash (/), <strong id="obs_04_0083__b847318473618">http://</strong>, or <strong id="obs_04_0083__b84733423615">https://</strong> and cannot exceed 2 KB.</li><li id="obs_04_0083__li16856103743717">OBS supports redirection for objects in the root directory of a bucket, not for those in folders.</li></ul>
<p id="obs_04_0083__p17944184095017"><strong id="obs_04_0083__b1290473646">Default value</strong>:</p>
<p id="obs_04_0083__p18644175513271">None</p>
</td>
</tr>
<tr id="obs_04_0083__row097494819522"><td class="cellrowborder" valign="top" width="29.080000000000002%" headers="mcps1.3.10.4.2.4.1.1 "><p id="obs_04_0083__p5974648155210">x-obs-delete-marker</p>
</td>
<td class="cellrowborder" valign="top" width="20.77%" headers="mcps1.3.10.4.2.4.1.2 "><p id="obs_04_0083__p8734939192114">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="50.14999999999999%" headers="mcps1.3.10.4.2.4.1.3 "><p id="obs_04_0083__p20221141922219"><strong id="obs_04_0083__b2028128549">Explanation</strong>:</p>
<p id="obs_04_0083__p697414885215">Whether the deleted object is a delete marker. If the object is not marked as deleted, the response does not contain this header.</p>
<p id="obs_04_0083__p102216197228"><strong id="obs_04_0083__b06631126369">Value range</strong>:</p>
<ul id="obs_04_0083__ul2372183346"><li id="obs_04_0083__li9377188346"><strong id="obs_04_0083__b96823638735348">true</strong>: The deleted object is a delete marker.</li><li id="obs_04_0083__li17378188343"><strong id="obs_04_0083__b16563131463611">false</strong>: The deleted object is not a delete marker.</li></ul>
<p id="obs_04_0083__p10222111912219"><strong id="obs_04_0083__b632521517367">Default value</strong>:</p>
<p id="obs_04_0083__p1697484875219">false</p>
</td>
</tr>
<tr id="obs_04_0083__row397414814525"><td class="cellrowborder" valign="top" width="29.080000000000002%" headers="mcps1.3.10.4.2.4.1.1 "><p id="obs_04_0083__p209741648145211">x-obs-version-id</p>
</td>
<td class="cellrowborder" valign="top" width="20.77%" headers="mcps1.3.10.4.2.4.1.2 "><p id="obs_04_0083__p33511231141319">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.14999999999999%" headers="mcps1.3.10.4.2.4.1.3 "><p id="obs_04_0083__p1954142022211"><strong id="obs_04_0083__b2095139072">Explanation</strong>:</p>
<p id="obs_04_0083__p79741148185219">Object version ID.</p>
<p id="obs_04_0083__p895411209225"><strong id="obs_04_0083__b395432072216">Restrictions</strong>:</p>
<p id="obs_04_0083__p3404193544019">If the object has no version number specified, the response does not contain this header.</p>
<p id="obs_04_0083__p29541820172220"><strong id="obs_04_0083__b39546207227">Value range</strong>:</p>
<p id="obs_04_0083__en-us_topic_0262986000_en-us_topic_0262985983_p6836138122914">The value must contain 32 characters.</p>
<p id="obs_04_0083__p10954112072215"><strong id="obs_04_0083__b1297575127">Default value</strong>:</p>
<p id="obs_04_0083__p942171685912">None</p>
</td>
</tr>
<tr id="obs_04_0083__row497454875216"><td class="cellrowborder" valign="top" width="29.080000000000002%" headers="mcps1.3.10.4.2.4.1.1 "><p id="obs_04_0083__p1697417487529">x-obs-server-side-encryption</p>
</td>
<td class="cellrowborder" valign="top" width="20.77%" headers="mcps1.3.10.4.2.4.1.2 "><p id="obs_04_0083__p0734103912219">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.14999999999999%" headers="mcps1.3.10.4.2.4.1.3 "><p id="obs_04_0083__p35173203140"><strong id="obs_04_0083__b1559126393">Explanation</strong>:</p>
<p id="obs_04_0083__p0517172010141">The encryption method used by the server.</p>
<p id="obs_04_0083__p1351710208149">Example: <strong id="obs_04_0083__b392042770">x-obs-server-side-encryption:kms</strong></p>
<p id="obs_04_0083__p1651732051411"><strong id="obs_04_0083__b135171320161412">Restrictions</strong>:</p>
<p id="obs_04_0083__p851702010142">This header is included in a response if SSE-KMS is used. </p>
<p id="obs_04_0083__p351720207147"><strong id="obs_04_0083__b16517182071413">Value range</strong>:</p>
<ul id="obs_04_0083__ul2845126181418"><li id="obs_04_0083__li13845626201413">kms</li><li id="obs_04_0083__li1484513266146">AES256</li></ul>
<p id="obs_04_0083__p151762015148"><strong id="obs_04_0083__b48943035">Default value</strong>:</p>
<p id="obs_04_0083__p551719202149">None</p>
</td>
</tr>
<tr id="obs_04_0083__row189749483527"><td class="cellrowborder" valign="top" width="29.080000000000002%" headers="mcps1.3.10.4.2.4.1.1 "><p id="obs_04_0083__p1897464812526">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="20.77%" headers="mcps1.3.10.4.2.4.1.2 "><p id="obs_04_0083__p27341439112120">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.14999999999999%" headers="mcps1.3.10.4.2.4.1.3 "><p id="obs_04_0083__p1358411303188"><strong id="obs_04_0083__b1616023863713">Explanation</strong>:</p>
<p id="obs_04_0083__p4584030101813">ID of a specified key used for SSE-KMS encryption.</p>
<p id="obs_04_0083__p25841230161820"><strong id="obs_04_0083__b1668932053">Restrictions</strong>:</p>
<p id="obs_04_0083__p258493020187">This header can only be used when you specify <strong id="obs_04_0083__b13493382063654">kms</strong> for the <strong id="obs_04_0083__b4248025553654">x-obs-server-side-encryption</strong> header.</p>
<p id="obs_04_0083__p1158413303182"><strong id="obs_04_0083__b489923840">Default value</strong>:</p>
<p id="obs_04_0083__p4584123061815">If you specify <strong id="obs_04_0083__b429420003654">kms</strong> for encryption but do not specify a key ID, the default master key will be used. If there is not a default master key, OBS will create one and use it.</p>
</td>
</tr>
<tr id="obs_04_0083__row10975164816524"><td class="cellrowborder" valign="top" width="29.080000000000002%" headers="mcps1.3.10.4.2.4.1.1 "><p id="obs_04_0083__p109755482529">x-obs-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="20.77%" headers="mcps1.3.10.4.2.4.1.2 "><p id="obs_04_0083__p1873413915212">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.14999999999999%" headers="mcps1.3.10.4.2.4.1.3 "><p id="obs_04_0083__p192121928202217"><strong id="obs_04_0083__b1512861246">Explanation</strong>:</p>
<p id="obs_04_0083__p1497524815520">Indicates a decryption algorithm. This header is included in a response if SSE-C is used. </p>
<p id="obs_04_0083__p1497516489520">Example: <strong id="obs_04_0083__b1241864053611">x-obs-server-side-encryption-customer-algorithm:AES256</strong></p>
<p id="obs_04_0083__p2214837191510"><strong id="obs_04_0083__b1335324143615">Restrictions</strong>:</p>
<p id="obs_04_0083__p16214133711513">None</p>
<p id="obs_04_0083__p1821413373150"><strong id="obs_04_0083__b11214937191510">Value range</strong>:</p>
<p id="obs_04_0083__p152141837181510">AES256</p>
<p id="obs_04_0083__p15214183731513"><strong id="obs_04_0083__b977558504">Default value</strong>:</p>
<p id="obs_04_0083__p4214637111517">None</p>
</td>
</tr>
<tr id="obs_04_0083__row1997534825217"><td class="cellrowborder" valign="top" width="29.080000000000002%" headers="mcps1.3.10.4.2.4.1.1 "><p id="obs_04_0083__p997524845217">x-obs-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="20.77%" headers="mcps1.3.10.4.2.4.1.2 "><p id="obs_04_0083__p13735173911219">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.14999999999999%" headers="mcps1.3.10.4.2.4.1.3 "><p id="obs_04_0083__p1721383092213"><strong id="obs_04_0083__b1046966154">Explanation</strong>:</p>
<p id="obs_04_0083__p14975124855212">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="obs_04_0083__p159754486527">Example: <strong id="obs_04_0083__b1849428572">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0083__p1391175661517"><strong id="obs_04_0083__b339155611157">Value range</strong>:</p>
<p id="obs_04_0083__p1039155681517">Base64-encoded MD5 value of the key ID.</p>
<p id="obs_04_0083__p143911456101512"><strong id="obs_04_0083__b1830626568">Default value</strong>:</p>
<p id="obs_04_0083__p039155641511">None</p>
</td>
</tr>
<tr id="obs_04_0083__row3975184810526"><td class="cellrowborder" valign="top" width="29.080000000000002%" headers="mcps1.3.10.4.2.4.1.1 "><p id="obs_04_0083__p397584817525">x-obs-object-type</p>
</td>
<td class="cellrowborder" valign="top" width="20.77%" headers="mcps1.3.10.4.2.4.1.2 "><p id="obs_04_0083__p9735193920217">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.14999999999999%" headers="mcps1.3.10.4.2.4.1.3 "><p id="obs_04_0083__p7240183212217"><strong id="obs_04_0083__b10171651143613">Explanation</strong>:</p>
<p id="obs_04_0083__p65776567303">Object type</p>
<p id="obs_04_0083__p16946113791613"><strong id="obs_04_0083__b1594643791612">Restrictions</strong>:</p>
<p id="obs_04_0083__p1994673720168">This header is returned when the object is not a Normal object.</p>
<p id="obs_04_0083__p11946123713165"><strong id="obs_04_0083__b1394613374167">Value range</strong>:</p>
<p id="obs_04_0083__p9946637111615">Appendable</p>
<p id="obs_04_0083__p794643741620"><strong id="obs_04_0083__b1836914074">Default value</strong>:</p>
<p id="obs_04_0083__p8946193718162">None</p>
</td>
</tr>
<tr id="obs_04_0083__row7975048195219"><td class="cellrowborder" valign="top" width="29.080000000000002%" headers="mcps1.3.10.4.2.4.1.1 "><p id="obs_04_0083__p397544816528">x-obs-next-append-position</p>
</td>
<td class="cellrowborder" valign="top" width="20.77%" headers="mcps1.3.10.4.2.4.1.2 "><p id="obs_04_0083__p1173563912119">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50.14999999999999%" headers="mcps1.3.10.4.2.4.1.3 "><p id="obs_04_0083__p2660833122217"><strong id="obs_04_0083__b20658754143620">Explanation</strong>:</p>
<p id="obs_04_0083__p10975104805213">Indicates the position that should be provided in the next request.</p>
<p id="obs_04_0083__p106600337223"><strong id="obs_04_0083__b14104145610365">Restrictions</strong>:</p>
<p id="obs_04_0083__p5964195993813">This header field is returned when the object is an appendable object.</p>
<p id="obs_04_0083__p1866123312217"><strong id="obs_04_0083__b5457135753615">Value range</strong>:</p>
<p id="obs_04_0083__p2031842101711">None</p>
<p id="obs_04_0083__p5661113314223"><strong id="obs_04_0083__b57140582364">Default value</strong>:</p>
<p id="obs_04_0083__p1726015131719">None</p>
</td>
</tr>
<tr id="obs_04_0083__row197511487527"><td class="cellrowborder" valign="top" width="29.080000000000002%" headers="mcps1.3.10.4.2.4.1.1 "><p id="obs_04_0083__p39755486526">x-obs-tagging-count</p>
</td>
<td class="cellrowborder" valign="top" width="20.77%" headers="mcps1.3.10.4.2.4.1.2 "><p id="obs_04_0083__p37351739192112">String</p>
</td>
<td class="cellrowborder" valign="top" width="50.14999999999999%" headers="mcps1.3.10.4.2.4.1.3 "><p id="obs_04_0083__p173321351227"><strong id="obs_04_0083__b2140038140">Explanation</strong>:</p>
<p id="obs_04_0083__p1497518487528">Number of tags associated with an object.</p>
<p id="obs_04_0083__p1997524816520">Example: <strong id="obs_04_0083__b147481324378">x-obs-tagging-count:1</strong></p>
<p id="obs_04_0083__p14332153514229"><strong id="obs_04_0083__b1459923163714">Restrictions</strong>:</p>
<p id="obs_04_0083__p13220327104417">This parameter is returned only when the user has the permission to read tags.</p>
<p id="obs_04_0083__p5332113592211"><strong id="obs_04_0083__b124539519371">Value range</strong>:</p>
<p id="obs_04_0083__p990662561712">None</p>
<p id="obs_04_0083__p63325350228"><strong id="obs_04_0083__b66661267378">Default value</strong>:</p>
<p id="obs_04_0083__p19750138220">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0083__section43032235"><h4 class="sectiontitle">Response Elements</h4><p class="MsoNormal" id="obs_04_0083__p34627725">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0083__section51745800"><h4 class="sectiontitle">Error Responses</h4><p class="MsoNormal" id="obs_04_0083__p53382370">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_0083__section76691712142111"><h4 class="sectiontitle">Sample Request: Downloading an Object</h4><div class="codecoloring" codetype="Xml" id="obs_04_0083__screen41281918122116"><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>/object01<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>04:24:33<span class="w"> </span>GMT
Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEBQQCEC:NxtSMS0jaVxlLnxlO9awaMTn47s=
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0083__section4264105742711"><h4 class="sectiontitle">Sample Response: Downloading an Object</h4><div class="codecoloring" codetype="Xml" id="obs_04_0083__screen195881342124611"><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></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>8DF400000163D3F2A89604C49ABEE55E
Accept-Ranges:<span class="w"> </span>bytes
ETag:<span class="w"> </span>&quot;3b46eaf02d3b6b1206078bb86a7b7013&quot;
Last-Modified:<span class="w"> </span>WED,<span class="w"> </span>01<span class="w"> </span>Jul<span class="w"> </span>2015<span class="w"> </span>01:20:29<span class="w"> </span>GMT
Content-Type:<span class="w"> </span>binary/octet-stream
x-obs-id-2:<span class="w"> </span>32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSQwxJ2I1VvxD/Xgwuw2G2RQax30gdXU
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>04:24:33<span class="w"> </span>GMT
Content-Length:<span class="w"> </span>4572

[4572<span class="w"> </span>Bytes<span class="w"> </span>object<span class="w"> </span>content]
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0083__section2791548195820"><h4 class="sectiontitle">Sample Request: Downloading a Specified Range of an Object</h4><p id="obs_04_0083__p1779384885820"><strong id="obs_04_0083__b67614141910">Download the specified range of an object (download a range of an object)</strong>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0083__screen77962489589"><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></pre></div></td><td class="code"><div><pre><span></span>GET<span class="w"> </span>/object01<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>Mon,<span class="w"> </span>14<span class="w"> </span>Sep<span class="w"> </span>2020<span class="w"> </span>09:59:04<span class="w"> </span>GMT
Range:bytes=20-30
Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEBQQCEC:mNPLWQMDWg30PTkAWiqJaLl3ALg=
</pre></div></td></tr></table></div>
</div>
</div>
<p id="obs_04_0083__p1773355920488"><strong id="obs_04_0083__b1153015479467">Download the specified range of an object (download multiple ranges of an object)</strong>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0083__screen676382118501"><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></pre></div></td><td class="code"><div><pre><span></span>GET<span class="w"> </span>/object01<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>Mon,<span class="w"> </span>14<span class="w"> </span>Sep<span class="w"> </span>2020<span class="w"> </span>10:02:43<span class="w"> </span>GMT
Range:bytes=20-30,40-50
Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEBQQCEC:ZwM7Vk2d7sD9o8zRsRKehgKQDkk=
</pre></div></td></tr></table></div>
</div>
<div class="section" id="obs_04_0083__section1181044815816"><h4 class="sectiontitle">Sample Response: Downloading a Specified Range of an Object</h4><p id="obs_04_0083__p6985104145215"><strong id="obs_04_0083__b355915144719">Download the specified range of an object (download a range of an object)</strong>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0083__screen2081224813588"><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></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>206<span class="w"> </span>Partial<span class="w"> </span>Content
Server:<span class="w"> </span>OBS
x-obs-request-id:<span class="w"> </span>000001748C0DBC35802E360C9E869F31
Accept-Ranges:<span class="w"> </span>bytes
ETag:<span class="w"> </span>&quot;2200446c2082f27ed2a569601ca4e360&quot;
Last-Modified:<span class="w"> </span>Mon,<span class="w"> </span>14<span class="w"> </span>Sep<span class="w"> </span>2020<span class="w"> </span>01:16:20<span class="w"> </span>GMT
Content-Range:<span class="w"> </span>bytes<span class="w"> </span>20-30/4583
Content-Type:<span class="w"> </span>binary/octet-stream
x-obs-id-2:<span class="w"> </span>32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSn2JHu4okx9NBRNZAvBGawa3lt3g31g
Date:<span class="w"> </span>Mon,<span class="w"> </span>14<span class="w"> </span>Sep<span class="w"> </span>2020<span class="w"> </span>09:59:04<span class="w"> </span>GMT
Content-Length:<span class="w"> </span>11

[<span class="w"> </span>11<span class="w"> </span>Bytes<span class="w"> </span>object<span class="w"> </span>content]
</pre></div></td></tr></table></div>
</div>
</div>
<p id="obs_04_0083__p56419206522"><strong id="obs_04_0083__b1977012911475">Download the specified range of an object (download multiple ranges of an object)</strong>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0083__screen3878947165212"><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></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>206<span class="w"> </span>Partial<span class="w"> </span>Content
Server:<span class="w"> </span>OBS
x-obs-request-id:<span class="w"> </span>8DF400000163D3F2A89604C49ABEE55E
Accept-Ranges:<span class="w"> </span>bytes
ETag:<span class="w"> </span>&quot;2200446c2082f27ed2a569601ca4e360&quot;
Last-Modified:<span class="w"> </span>Mon,<span class="w"> </span>14<span class="w"> </span>Sep<span class="w"> </span>2020<span class="w"> </span>01:16:20<span class="w"> </span>GMT
Content-Type:<span class="w"> </span>multipart/byteranges;boundary=35bcf444-e65f-4c76-9430-7e4a68dd3d26
x-obs-id-2:<span class="w"> </span>32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSIBWFOVW8eeWujkqSnoIANC2mNR1cdF
Date:<span class="w"> </span>Mon,<span class="w"> </span>14<span class="w"> </span>Sep<span class="w"> </span>2020<span class="w"> </span>10:02:43<span class="w"> </span>GMT
Content-Length:<span class="w"> </span>288

--35bcf444-e65f-4c76-9430-7e4a68dd3d26
Content-type:<span class="w"> </span>binary/octet-stream
Content-range:<span class="w"> </span>bytes<span class="w"> </span>20-30/4583
[<span class="w"> </span>11<span class="w"> </span>Bytes<span class="w"> </span>object<span class="w"> </span>content]
--35bcf444-e65f-4c76-9430-7e4a68dd3d26
Content-type:<span class="w"> </span>binary/octet-stream
Content-range:<span class="w"> </span>bytes<span class="w"> </span>40-50/4583
[<span class="w"> </span>11<span class="w"> </span>Bytes<span class="w"> </span>object<span class="w"> </span>content]
--35bcf444-e65f-4c76-9430-7e4a68dd3d26
</pre></div></td></tr></table></div>
</div>
<div class="section" id="obs_04_0083__section1081716488230"><h4 class="sectiontitle">Sample Request: Checking the ETag Value of an Object</h4><p id="obs_04_0083__p55313703612"><strong id="obs_04_0083__b4957920171011">Download an object if its ETag value is matched</strong>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0083__screen1988837122916"><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></pre></div></td><td class="code"><div><pre><span></span>GET<span class="w"> </span>/object01<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>04:24:33<span class="w"> </span>GMT
If-Match:<span class="w"> </span>682e760adb130c60c120da3e333a8b09
Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEBQQCEC:NxtSMS0jaVxlLnxlO9awaMTn47s=
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0083__section154154183317"><h4 class="sectiontitle">Sample Response: Checking the ETag Value of an Object (ETag Mismatch)</h4><p id="obs_04_0083__p31791351372">If the object's ETag value is not <strong id="obs_04_0083__b61482710149">682e760adb130c60c120da3e333a8b09</strong>, the system displays a download failure message.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0083__screen1654618411336"><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></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>412<span class="w"> </span>Precondition<span class="w"> </span>Failed
Server:<span class="w"> </span>OBS
x-obs-request-id:<span class="w"> </span>8DF400000163D3F2A89604C49ABEE55E
Content-Type:<span class="w"> </span>application/xml
x-obs-id-2:<span class="w"> </span>32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSQwxJ2I1VvxD/Xgwuw2G2RQax30gdXU
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>04:20:51<span class="w"> </span>GMT

<span class="cp">&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; standalone=&quot;yes&quot;?&gt;</span>
<span class="nt">&lt;Error&gt;</span>
<span class="w">  </span><span class="nt">&lt;Code&gt;</span>PreconditionFailed<span class="nt">&lt;/Code&gt;</span>
<span class="w">  </span><span class="nt">&lt;Message&gt;</span>At<span class="w"> </span>least<span class="w"> </span>one<span class="w"> </span>of<span class="w"> </span>the<span class="w"> </span>pre-conditions<span class="w"> </span>you<span class="w"> </span>specified<span class="w"> </span>did<span class="w"> </span>not<span class="w"> </span>hold<span class="nt">&lt;/Message&gt;</span><span class="w"> </span>
<span class="w">  </span><span class="nt">&lt;RequestId&gt;</span>8DF400000163D3F2A89604C49ABEE55E<span class="nt">&lt;/RequestId&gt;</span><span class="w">      </span>
<span class="w">  </span><span class="nt">&lt;HostId&gt;</span>ha0ZGaSKVm+uLOrCXXtx4Qn1aLzvoeblctVXRAqA7pty10mzUUW/yOzFue04lBqu<span class="nt">&lt;/HostId&gt;</span>
<span class="w">  </span><span class="nt">&lt;Condition&gt;</span>If-Match<span class="nt">&lt;/Condition&gt;</span>
<span class="nt">&lt;/Error&gt;</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0083__section65816410333"><h4 class="sectiontitle">Sample Response: Checking the ETag Value of an Object (ETag Matched)</h4><p id="obs_04_0083__p88331650133713">If the object's ETag value is <strong id="obs_04_0083__b34660378151">682e760adb130c60c120da3e333a8b09</strong>, the download is successful.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0083__screen5585144133317"><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></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>5DEB00000164A21E1FC826C58F6BA001
Accept-Ranges:<span class="w"> </span>bytes
ETag:<span class="w"> </span>&quot;682e760adb130c60c120da3e333a8b09&quot;
Last-Modified:<span class="w"> </span>Mon,<span class="w"> </span>16<span class="w"> </span>Jul<span class="w"> </span>2015<span class="w"> </span>08:03:34<span class="w"> </span>GMT
Content-Type:<span class="w"> </span>application/octet-stream
x-obs-id-2:<span class="w"> </span>32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSbkdml1sLSvKnoHaRcOwRI+6+ustDwk
Date:<span class="w"> </span>Mon,<span class="w"> </span>16<span class="w"> </span>Jul<span class="w"> </span>2015<span class="w"> </span>08:04:00<span class="w"> </span>GMT
Content-Length:<span class="w"> </span>8

[<span class="w"> </span>8<span class="w"> </span>Bytes<span class="w"> </span>object<span class="w"> </span>content]
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0083__section125202491859"><h4 class="sectiontitle">Sample Request: Downloading an Object Using a Signed URL</h4><pre class="screen" id="obs_04_0083__screen1152015491756">GET /object02?AccessKeyId=H4IPJX0TQTHTHEBQQCEC&amp;Expires=1532688887&amp;Signature=EQmDuOhaLUrzrzRNZxwS72CXeXM%3D HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.<em id="obs_04_0083__i0521349457">region</em>.example.com
Accept: */*
Date: Fri, 27 Jul 2018 10:52:31 GMT</pre>
</div>
<div class="section" id="obs_04_0083__section75215493514"><h4 class="sectiontitle">Sample Response: Downloading an Object Using a Signed URL</h4><div class="codecoloring" codetype="Xml" id="obs_04_0083__screen452113491751"><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></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>804F00000164DB5E5B7FB908D3BA8E00
ETag:<span class="w"> </span>&quot;682e760adb130c60c120da3e333a8b09&quot;
Last-Modified:<span class="w"> </span>Mon,<span class="w"> </span>16<span class="w"> </span>Jul<span class="w"> </span>2015<span class="w"> </span>08:03:34<span class="w"> </span>GMT
Content-Type:<span class="w"> </span>application/octet-stream
x-obs-id-2:<span class="w"> </span>32AAAUJAIAABAAAQAAEAABAAAQAAEAABCTlpxILjhVK/heKOWIP8Wn2IWmQoerfw
Date:<span class="w"> </span>Fri,<span class="w"> </span>27<span class="w"> </span>Jul<span class="w"> </span>2018<span class="w"> </span>10:52:31<span class="w"> </span>GMT
Content-Length:<span class="w"> </span>8

[<span class="w"> </span>8<span class="w"> </span>Bytes<span class="w"> </span>object<span class="w"> </span>content]
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0083__section20424171119127"><h4 class="sectiontitle">Sample Request: Downloading an Object and Renaming It (with <strong id="obs_04_0083__b1579324910474">response-content-disposition</strong> Used)</h4><p id="obs_04_0083__p342531191212"><strong id="obs_04_0083__b3103197185911">Use the </strong><strong id="obs_04_0083__b3743114716585">response-content-disposition</strong><strong id="obs_04_0083__b3103477592"> parameter to download and rename an object.</strong></p>
<div class="codecoloring" codetype="Xml" id="obs_04_0083__screen14251711131216"><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>/object01?response-content-disposition=attachment;<span class="w"> </span>filename*=utf-8''name1<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>04:24:33<span class="w"> </span>GMT
Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEBQQCEC:NxtSMS0jaVxlLnxlO9awaMTn47s=
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0083__section8426311201213"><h4 class="sectiontitle">Sample Response: Downloading an Object and Renaming It (with <strong id="obs_04_0083__b43750610485">response-content-disposition</strong> Used)</h4><div class="codecoloring" codetype="Xml" id="obs_04_0083__screen4426211191219"><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></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>804F00000164DB5E5B7FB908D3BA8E00
ETag:<span class="w"> </span>&quot;682e760adb130c60c120da3e333a8b09&quot;
Last-Modified:<span class="w"> </span>Mon,<span class="w"> </span>16<span class="w"> </span>Jul<span class="w"> </span>2015<span class="w"> </span>08:03:34<span class="w"> </span>GMT
Content-Type:<span class="w"> </span>application/octet-stream
x-obs-id-2:<span class="w"> </span>32AAAUJAIAABAAAQAAEAABAAAQAAEAABCTlpxILjhVK/heKOWIP8Wn2IWmQoerfw
Date:<span class="w"> </span>Fri,<span class="w"> </span>27<span class="w"> </span>Jul<span class="w"> </span>2018<span class="w"> </span>10:52:31<span class="w"> </span>GMT
Content-Length:<span class="w"> </span>8
Content-Disposition:<span class="w"> </span>attachment;<span class="w"> </span>filename*=utf-8''name1

[<span class="w"> </span>8<span class="w"> </span>Bytes<span class="w"> </span>object<span class="w"> </span>content]
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0083__section9185459173518"><h4 class="sectiontitle">Sample Request: Downloading an Object and Renaming It (with <strong id="obs_04_0083__b1494281464818">attname</strong> Used)</h4><p id="obs_04_0083__p20345175314246"><strong id="obs_04_0083__b121557207595">Use the </strong><strong id="obs_04_0083__b315518202596">attname</strong><strong id="obs_04_0083__b14155020105918"> parameter to download and rename an object.</strong></p>
<div class="codecoloring" codetype="Xml" id="obs_04_0083__screen1617215465618"><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>/object01?attname=name1<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>04:24:33<span class="w"> </span>GMT
Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEBQQCEC:NxtSMS0jaVxlLnxlO9awaMTn47s=
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0083__section1378817131164"><h4 class="sectiontitle">Sample Response: Downloading an Object and Renaming It (with <strong id="obs_04_0083__b1022314280486">attname</strong> Used)</h4><div class="codecoloring" codetype="Xml" id="obs_04_0083__screen162309310718"><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></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>804F00000164DB5E5B7FB908D3BA8E00
ETag:<span class="w"> </span>&quot;682e760adb130c60c120da3e333a8b09&quot;
Last-Modified:<span class="w"> </span>Mon,<span class="w"> </span>16<span class="w"> </span>Jul<span class="w"> </span>2015<span class="w"> </span>08:03:34<span class="w"> </span>GMT
Content-Type:<span class="w"> </span>application/octet-stream
x-obs-id-2:<span class="w"> </span>32AAAUJAIAABAAAQAAEAABAAAQAAEAABCTlpxILjhVK/heKOWIP8Wn2IWmQoerfw
Date:<span class="w"> </span>Fri,<span class="w"> </span>27<span class="w"> </span>Jul<span class="w"> </span>2018<span class="w"> </span>10:52:31<span class="w"> </span>GMT
Content-Length:<span class="w"> </span>8
Content-Disposition:<span class="w"> </span>attachment;<span class="w"> </span>filename*=utf-8''name1

[<span class="w"> </span>8<span class="w"> </span>Bytes<span class="w"> </span>object<span class="w"> </span>content]
</pre></div></td></tr></table></div>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0079.html">Operations on Objects</a></div>
</div>
</div>