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

669 lines
56 KiB
HTML
Raw Blame History

<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 are not 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__table33454552">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__table33454552"></a><a name="table33454552"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0083__table33454552" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="obs_04_0083__row36779913"><th align="left" class="cellrowborder" valign="top" width="36.730000000000004%" id="mcps1.3.6.4.2.4.1.1"><p id="obs_04_0083__p26382981">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="44.9%" id="mcps1.3.6.4.2.4.1.2"><p id="obs_04_0083__p40058376">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.37%" id="mcps1.3.6.4.2.4.1.3"><p id="obs_04_0083__p10200812">Mandatory</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0083__row54417034"><td class="cellrowborder" valign="top" width="36.730000000000004%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0083__p45703652">response-content-type</p>
</td>
<td class="cellrowborder" valign="top" width="44.9%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0083__p11008322">Rewrites the <strong id="obs_04_0083__b842352706181629">Content-Type</strong> header in the response.</p>
<p id="obs_04_0083__p31966038">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="18.37%" headers="mcps1.3.6.4.2.4.1.3 "><p id="obs_04_0083__p39112310">No</p>
</td>
</tr>
<tr id="obs_04_0083__row16466476"><td class="cellrowborder" valign="top" width="36.730000000000004%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0083__p58716168">response-content-language</p>
</td>
<td class="cellrowborder" valign="top" width="44.9%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0083__p58389128">Rewrites the <strong id="obs_04_0083__b1950513353266">Content-Language</strong> header in the response.</p>
<p id="obs_04_0083__p55740105">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="18.37%" headers="mcps1.3.6.4.2.4.1.3 "><p id="obs_04_0083__p18654651">No</p>
</td>
</tr>
<tr id="obs_04_0083__row33674133"><td class="cellrowborder" valign="top" width="36.730000000000004%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0083__p43250291">response-expires</p>
</td>
<td class="cellrowborder" valign="top" width="44.9%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0083__p13612693">Rewrites the <strong id="obs_04_0083__b842352706181637">Expires</strong> header in the response.</p>
<p id="obs_04_0083__p55405380">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="18.37%" headers="mcps1.3.6.4.2.4.1.3 "><p id="obs_04_0083__p58650759">No</p>
</td>
</tr>
<tr id="obs_04_0083__row58094791"><td class="cellrowborder" valign="top" width="36.730000000000004%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0083__p8057639">response-cache-control</p>
</td>
<td class="cellrowborder" valign="top" width="44.9%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0083__p48689003">Rewrites the <strong id="obs_04_0083__b842352706181551">Cache-Control</strong> header in the response.</p>
<p id="obs_04_0083__p35547846">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="18.37%" headers="mcps1.3.6.4.2.4.1.3 "><p id="obs_04_0083__p60803292">No</p>
</td>
</tr>
<tr id="obs_04_0083__row10358721"><td class="cellrowborder" valign="top" width="36.730000000000004%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0083__p33750050">response-content-disposition</p>
<p id="obs_04_0083__p428612331247"></p>
</td>
<td class="cellrowborder" valign="top" width="44.9%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0083__p49399561">Rewrites the <strong id="obs_04_0083__b84235270618160">Content-Disposition</strong> header in the response.</p>
<p id="obs_04_0083__p41942865">Type: string</p>
<p id="obs_04_0083__p1894313531109">Example:</p>
<p id="obs_04_0083__p788412596017"><span style="color:#222222;">response-content-disposition=attachment; filename*=utf-8''name1</span></p>
<p id="obs_04_0083__p862820514415">In this example, the downloaded object is renamed <strong id="obs_04_0083__b17861113254510">name1</strong>. If the new name contains full-width characters, it must be URL-encoded.</p>
</td>
<td class="cellrowborder" valign="top" width="18.37%" headers="mcps1.3.6.4.2.4.1.3 "><p id="obs_04_0083__p41928889">No</p>
</td>
</tr>
<tr id="obs_04_0083__row41815682"><td class="cellrowborder" valign="top" width="36.730000000000004%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0083__p31627110">response-content-encoding</p>
</td>
<td class="cellrowborder" valign="top" width="44.9%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0083__p11659118">Rewrites the <strong id="obs_04_0083__b1226518394265">Content-Encoding </strong>header in the response.</p>
<p id="obs_04_0083__p37823203">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="18.37%" headers="mcps1.3.6.4.2.4.1.3 "><p id="obs_04_0083__p43780637">No</p>
</td>
</tr>
<tr id="obs_04_0083__row58481420"><td class="cellrowborder" valign="top" width="36.730000000000004%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0083__p39374578">versionId</p>
</td>
<td class="cellrowborder" valign="top" width="44.9%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0083__p35224220">Indicates the version ID of the object whose content is obtained.</p>
<p id="obs_04_0083__p48582526">Type: string</p>
</td>
<td class="cellrowborder" valign="top" width="18.37%" headers="mcps1.3.6.4.2.4.1.3 "><p id="obs_04_0083__p42870538">No</p>
</td>
</tr>
<tr id="obs_04_0083__row3210135204916"><td class="cellrowborder" valign="top" width="36.730000000000004%" headers="mcps1.3.6.4.2.4.1.1 "><p id="obs_04_0083__p021018529498">attname</p>
</td>
<td class="cellrowborder" valign="top" width="44.9%" headers="mcps1.3.6.4.2.4.1.2 "><p id="obs_04_0083__p1612114765018">Rewrites the <strong id="obs_04_0083__b2081417106">Content-Disposition</strong> header in the response.</p>
<p id="obs_04_0083__p1612197195017">Type: string</p>
<p id="obs_04_0083__p20472268503">Example:</p>
<p id="obs_04_0083__p11253017500">attname=name1</p>
<p id="obs_04_0083__p43423915594">Rename the downloaded object as <strong id="obs_04_0083__b56819219586">name1</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="18.37%" headers="mcps1.3.6.4.2.4.1.3 "><p id="obs_04_0083__p12210175234910">No</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__table14222149">Table 2</a> describes the additional headers.</p>
<div class="tablenoborder"><a name="obs_04_0083__table14222149"></a><a name="table14222149"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0083__table14222149" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request headers</caption><thead align="left"><tr id="obs_04_0083__row30170882"><th align="left" class="cellrowborder" valign="top" width="26%" id="mcps1.3.7.3.2.4.1.1"><p id="obs_04_0083__p27922416">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.7.3.2.4.1.2"><p id="obs_04_0083__p21455929">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="24%" id="mcps1.3.7.3.2.4.1.3"><p id="obs_04_0083__p5006964">Mandatory</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0083__row26198534"><td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0083__p41706491">Range</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0083__p76567250428">Obtains the object content within the scope defined by <strong id="obs_04_0083__b1359451819476">Range</strong>. If the parameter value is invalid, the entire object is obtained.</p>
<p id="obs_04_0083__p192207964210"><strong id="obs_04_0083__b56061442210">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__b124051350540">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>
<p id="obs_04_0083__p1361061444618">After the <strong id="obs_04_0083__b12387104119558">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__b4377125855512">Range</strong> field.</p>
<p id="obs_04_0083__p3717038">Type: string</p>
<p id="obs_04_0083__p33453343">bytes=byte_range</p>
<p id="obs_04_0083__p2416350134318">Example 1: <strong id="obs_04_0083__b1798094511104">bytes=0-4</strong></p>
<p id="obs_04_0083__p1411211104410">Example 2: <strong id="obs_04_0083__b153541841161010">bytes=1024</strong></p>
<p id="obs_04_0083__p32644639">Example 3: <strong id="obs_04_0083__b15303232151012">bytes=10-20, 30-40</strong> (multiple ranges)</p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0083__p26970134">No</p>
</td>
</tr>
<tr id="obs_04_0083__row41404614"><td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0083__p65439422">If-Modified-Since</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0083__p66101806">Returns the object only if it has been modified since the time specified by this header. Otherwise, <strong id="obs_04_0083__b34441781">304 Not Modified</strong> is returned.</p>
<p id="obs_04_0083__p58045347">Type: HTTP time character string complying with the format specified at <strong id="obs_04_0083__b1523593115564">http://www.ietf.org/rfc/rfc2616.txt</strong></p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0083__p4052667">No</p>
</td>
</tr>
<tr id="obs_04_0083__row36474008"><td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0083__p1604706">If-Unmodified-Since</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0083__p62872389">Returns the object only if it has not been modified since the time specified by this header. Otherwise, <strong id="obs_04_0083__b35808325">412 Precondition Failed</strong> is returned.</p>
<p id="obs_04_0083__p28980591">Type: HTTP time character string complying with the format specified at <strong id="obs_04_0083__b1188121516576">http://www.ietf.org/rfc/rfc2616.txt</strong></p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0083__p65726505">No</p>
</td>
</tr>
<tr id="obs_04_0083__row54667635"><td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0083__p66002319">If-Match</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0083__p44587619">Returns the object only if its ETag is the same as the one specified by this header. Otherwise, <strong id="obs_04_0083__b64501877">412 Precondition Failed</strong> is returned.</p>
<p id="obs_04_0083__p65744258">Type: string</p>
<p id="obs_04_0083__p54827416">ETag example: <strong id="obs_04_0083__b174366342919">0f64741bf7cb1089e988e4585d0d3434</strong></p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0083__p11835734">No</p>
</td>
</tr>
<tr id="obs_04_0083__row39412743"><td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0083__p38315620">If-None-Match</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0083__p16557534">Returns the object only if its ETag is different from the one specified by this header. Otherwise, <strong id="obs_04_0083__b27601825">304 Not Modified</strong> is returned.</p>
<p id="obs_04_0083__p14800081">Type: string</p>
<p id="obs_04_0083__p66091868">ETag example: <strong id="obs_04_0083__b14564434589">0f64741bf7cb1089e988e4585d0d3434</strong></p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0083__p51841095">No</p>
</td>
</tr>
<tr id="obs_04_0083__row63916672"><td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0083__p9867961">x-obs-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0083__p61107346">Indicates the encryption algorithm when SSE-C is used.</p>
<p id="obs_04_0083__p13095202">Type: string</p>
<p id="obs_04_0083__p50747955">Example: <strong id="obs_04_0083__b19884915814">x-obs-server-side-encryption-customer-algorithm:AES256</strong></p>
<p id="obs_04_0083__p54078414">Constraint: This header must be used together with <strong id="obs_04_0083__b4396112217114">x-obs-server-side-encryption-customer-key</strong> and <strong id="obs_04_0083__b6402192218118">x-obs-server-side-encryption-customer-key-MD5</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0083__p18275439">No. This header is required when SSE-C is used.</p>
</td>
</tr>
<tr id="obs_04_0083__row30261231"><td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0083__p35240666">x-obs-server-side-encryption-customer-key</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0083__p35921710">Indicates the key for decrypting objects when SSE-C is used.</p>
<p id="obs_04_0083__p54859934">Type: string</p>
<p id="obs_04_0083__p23977361">Example: <strong id="obs_04_0083__b15385853195815">x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=</strong></p>
<p id="obs_04_0083__p14469665">Constraint: This header is a Base64-encoded 256-bit key and must be used together with <strong id="obs_04_0083__b77117144583">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0083__b147118149585">x-obs-server-side-encryption-customer-key-MD5</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0083__p31192225">No. This header is required when SSE-C is used.</p>
</td>
</tr>
<tr id="obs_04_0083__row12294571"><td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.7.3.2.4.1.1 "><p id="obs_04_0083__p56336176">x-obs-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.3.2.4.1.2 "><p id="obs_04_0083__p66936422">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__p65556891">Type: string</p>
<p id="obs_04_0083__p53141108">Example: <strong id="obs_04_0083__b831615813582">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0083__p8507932">Constraint: This header is a Base64-encoded 128-bit MD5 value and must be used together with <strong id="obs_04_0083__b203881913604">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0083__b739516131404">x-obs-server-side-encryption-customer-key</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="24%" headers="mcps1.3.7.3.2.4.1.3 "><p id="obs_04_0083__p18053923">No. This header is required when SSE-C is used.</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__table40465940">Table 3</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0083__table40465940"></a><a name="table40465940"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0083__table40465940" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0083__row62215211"><th align="left" class="cellrowborder" valign="top" width="40.400000000000006%" id="mcps1.3.10.4.2.3.1.1"><p id="obs_04_0083__p6267364">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="59.599999999999994%" id="mcps1.3.10.4.2.3.1.2"><p id="obs_04_0083__p37894481">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0083__row49554139"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.10.4.2.3.1.1 "><p id="obs_04_0083__p54462313">x-obs-expiration</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0083__p49371236">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__b145781963013">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__b143591257173312">expiry-date</strong> and <strong id="obs_04_0083__b44591502346">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__p41687941">Type: string</p>
</td>
</tr>
<tr id="obs_04_0083__row39647155"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.10.4.2.3.1.1 "><p id="obs_04_0083__p57302975">x-obs-website-redirect-location</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0083__p11029359">Indicates the redirected-to location. If the bucket is configured with website information, this parameter can be set for the object metadata 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="obs_04_0083__p32155368">Type: string</p>
</td>
</tr>
<tr id="obs_04_0083__row20962859"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.10.4.2.3.1.1 "><p id="obs_04_0083__p20270044">x-obs-delete-marker</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0083__p31260906">Indicates whether an 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__p12912703">Type: boolean</p>
<p id="obs_04_0083__p49105468">Value options: <strong id="obs_04_0083__b20420112232417">true</strong>, <strong id="obs_04_0083__b842012202416">false</strong></p>
<p id="obs_04_0083__p39296035">The default value is <strong id="obs_04_0083__b84235270618335">false</strong>.</p>
</td>
</tr>
<tr id="obs_04_0083__row18119995"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.10.4.2.3.1.1 "><p id="obs_04_0083__p58433486">x-obs-version-id</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0083__p35491934">Object version ID. If the object has no version number specified, the response does not contain this header.</p>
<p id="obs_04_0083__p50991952">Valid value: string</p>
<p id="obs_04_0083__p56274386">Default value: none</p>
</td>
</tr>
<tr id="obs_04_0083__row36707429"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.10.4.2.3.1.1 "><p id="obs_04_0083__p20511787">x-obs-server-side-encryption</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0083__p50842057">This header is included in a response if SSE-KMS is used. </p>
<p id="obs_04_0083__p54925337">Type: string</p>
<p id="obs_04_0083__p24565992">Example: <strong id="obs_04_0083__b86091219593">x-obs-server-side-encryption:kms</strong></p>
</td>
</tr>
<tr id="obs_04_0083__row19767344"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.10.4.2.3.1.1 "><p id="obs_04_0083__p57650994">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0083__p39218953">Indicates the master key ID. This header is included in a response when SSE-KMS is used.</p>
<p id="obs_04_0083__p135275133514">Type: string</p>
<p id="obs_04_0083__p672833104612">Format: <em id="obs_04_0083__i107663221269">regionID</em><strong id="obs_04_0083__b3766192214619">:</strong><em id="obs_04_0083__i1376614221864">domainID</em><strong id="obs_04_0083__b19767322269">:key/</strong><em id="obs_04_0083__i1767202220619">key_id</em></p>
<p id="obs_04_0083__p1435213517358"><em id="obs_04_0083__i13695247526">regionID</em> indicates the ID of the region where the key belongs. <em id="obs_04_0083__i196961471522">domainID</em> indicates the ID of the tenant where the key belongs. <em id="obs_04_0083__i16961347226">key_id</em> indicates the key ID used in this encryption.</p>
<p id="obs_04_0083__p18270748155218">Example: <strong id="obs_04_0083__b176701234115916">x-obs-server-side-encryption-kms-key-id:</strong><strong id="obs_04_0083__b1567143455919"><em id="obs_04_0083__i1867111349593">region</em></strong><strong id="obs_04_0083__b46721234195916">:domainiddomainiddomainiddoma0001:key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0</strong></p>
</td>
</tr>
<tr id="obs_04_0083__row22618653"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.10.4.2.3.1.1 "><p id="obs_04_0083__p20171605">x-obs-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0083__p23287322">Indicates a decryption algorithm. This header is included in a response if SSE-C is used. </p>
<p id="obs_04_0083__p8259308">Type: string</p>
<p id="obs_04_0083__p7224915">Example: <strong id="obs_04_0083__b81881645913">x-obs-server-side-encryption-customer-algorithm:AES256</strong></p>
</td>
</tr>
<tr id="obs_04_0083__row65024239"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.10.4.2.3.1.1 "><p id="obs_04_0083__p32471986">x-obs-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0083__p12985181">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__p49757769">Type: string</p>
<p id="obs_04_0083__p45166745">Example: <strong id="obs_04_0083__b1165682075917">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
</td>
</tr>
<tr id="obs_04_0083__row538202611502"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.10.4.2.3.1.1 "><p id="obs_04_0083__p118791639154211">x-obs-object-type</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0083__p108799391421">If the object is not a normal one, this header field is returned. The value can be <strong id="obs_04_0083__b131612282215">Appendable</strong>.</p>
<p id="obs_04_0083__p32878451">Type: string</p>
</td>
</tr>
<tr id="obs_04_0083__row8411133311507"><td class="cellrowborder" valign="top" width="40.400000000000006%" headers="mcps1.3.10.4.2.3.1.1 "><p id="obs_04_0083__p434312159462">x-obs-next-append-position</p>
</td>
<td class="cellrowborder" valign="top" width="59.599999999999994%" headers="mcps1.3.10.4.2.3.1.2 "><p id="obs_04_0083__p11343121594610">This header field is returned when the object is an appendable object.</p>
<p id="obs_04_0083__p1464163613488">Type: integer</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>
View Git Blame Copy Permalink