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
Jawei, Li f1cb839979 OBS api-ref 2.0.38.SP5 
Reviewed-by: gtema <artem.goncharov@gmail.com>
Co-authored-by: Jawei, Li <lijiawei5@huawei.com>
Co-committed-by: Jawei, Li <lijiawei5@huawei.com>
2022-11-03 11:54:51 +00:00

655 lines
43 KiB
HTML
Raw Blame History

<a name="obs_04_0083"></a><a name="obs_04_0083"></a>
<h1 class="topictitle1">Downloading Objects</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 objects 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 deletion marker, OBS returns a code meaning non-existence of the object. 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">OBS Cold Objects</h4><p class="MsoNormal" id="obs_04_0083__p13480849">If the object to be downloaded is a Cold object, restore it before downloading it. The response varies with the retrieval status of the object. If the object has been restored, the <strong id="obs_04_0083__b1207465602144715">x-obs-restore</strong> header is returned indicating the expiry date of the object when it is successfully downloaded. If you request downloading Cold objects that are not restored or are being restored, a <strong id="obs_04_0083__b1231441133144728">403 Forbidden</strong> error is 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"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4
5
6</pre></div></td><td class="code"><div class="highlight"><pre><span></span>GET /ObjectName HTTP/1.1
Host: bucketname.obs.region.example.com
Date: date
Authorization: authorization
Range:bytes=byte_range
<span class="nt">&lt;Optional</span> <span class="err">Additional</span> <span class="err">Header</span><span class="nt">&gt;</span>
</pre></div>
</td></tr></table></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 Chinese 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__b356569054">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">(Example: 0f64741bf7cb1089e988e4585d0d3434)</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">(Example: 0f64741bf7cb1089e988e4585d0d3434)</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 an encryption algorithm. The header is used in SSE-C mode.</p>
<p id="obs_04_0083__p13095202">Type: string</p>
<p id="obs_04_0083__p50747955">Example: x-obs-server-side-encryption-customer-algorithm:AES256</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 a key used to encrypt objects. The header is used in SSE-C mode. This key is used to decrypt objects.</p>
<p id="obs_04_0083__p54859934">Type: string</p>
<p id="obs_04_0083__p23977361">Example: x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=</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 a key used to encrypt objects. The header is used in SSE-C mode. The MD5 value is used to check whether any error occurs during the transmission of the key. </p>
<p id="obs_04_0083__p65556891">Type: string</p>
<p id="obs_04_0083__p53141108">Example: x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</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"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4
5
6
7
8</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 status_code
Content-Type: type
Date: date
Content-Length: length
Etag: etag
Last-Modified: time
<span class="nt">&lt;Object</span> <span class="err">Content</span><span class="nt">&gt;</span>
</pre></div>
</td></tr></table></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 following message headers may also be used. For details, see <a href="#obs_04_0083__table40465940">Table 3</a>.</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 header parameters</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 deletion 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">Valid values: <strong id="obs_04_0083__b59967403164459">true</strong> or <strong id="obs_04_0083__b263109916453">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: character 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: x-obs-server-side-encryption:kms</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 if 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__i7972111417">regionID</em> is the ID of the region to which the key belongs. <em id="obs_04_0083__i29715110148">domainID</em> is the account ID of the tenant to which the key belongs. <em id="obs_04_0083__i99810171412">key_id</em> is 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: x-obs-server-side-encryption-customer-algorithm:AES256</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: x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</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 involves 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 1</h4><p id="obs_04_0083__p1586817341276"><strong id="obs_04_0083__b134736426247">Download the entire object.</strong></p>
<div class="codecoloring" codetype="Xml" id="obs_04_0083__screen41281918122116"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4
5
6</pre></div></td><td class="code"><div class="highlight"><pre><span></span>GET /object01 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: WED, 01 Jul 2015 04:24:33 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:NxtSMS0jaVxlLnxlO9awaMTn47s=
</pre></div>
</td></tr></table></div>
</div>
<div class="section" id="obs_04_0083__section4264105742711"><h4 class="sectiontitle">Sample Response 1</h4><div class="codecoloring" codetype="Xml" id="obs_04_0083__screen195881342124611"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre> 1
2
3
4
5
6
7
8
9
10
11
12</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 8DF400000163D3F2A89604C49ABEE55E
Accept-Ranges: bytes
ETag: &quot;3b46eaf02d3b6b1206078bb86a7b7013&quot;
Last-Modified: WED, 01 Jul 2015 01:20:29 GMT
Content-Type: binary/octet-stream
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSQwxJ2I1VvxD/Xgwuw2G2RQax30gdXU
Date: WED, 01 Jul 2015 04:24:33 GMT
Content-Length: 4572
[4572 Bytes object content]
</pre></div>
</td></tr></table></div>
</div>
<div class="section" id="obs_04_0083__section2791548195820"><h4 class="sectiontitle">Sample Request 2</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"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4
5
6
7</pre></div></td><td class="code"><div class="highlight"><pre><span></span>GET /object01 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: Mon, 14 Sep 2020 09:59:04 GMT
Range:bytes=20-30
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:mNPLWQMDWg30PTkAWiqJaLl3ALg=
</pre></div>
</td></tr></table></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"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4
5
6
7</pre></div></td><td class="code"><div class="highlight"><pre><span></span>GET /object01 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: Mon, 14 Sep 2020 10:02:43 GMT
Range:bytes=20-30,40-50
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:ZwM7Vk2d7sD9o8zRsRKehgKQDkk=
</pre></div>
</td></tr></table></div>
<div class="section" id="obs_04_0083__section1181044815816"><h4 class="sectiontitle">Sample Response 2</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"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre> 1
2
3
4
5
6
7
8
9
10
11
12
13</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 206 Partial Content
Server: OBS
x-obs-request-id: 000001748C0DBC35802E360C9E869F31
Accept-Ranges: bytes
ETag: &quot;2200446c2082f27ed2a569601ca4e360&quot;
Last-Modified: Mon, 14 Sep 2020 01:16:20 GMT
Content-Range: bytes 20-30/4583
Content-Type: binary/octet-stream
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSn2JHu4okx9NBRNZAvBGawa3lt3g31g
Date: Mon, 14 Sep 2020 09:59:04 GMT
Content-Length: 11
[ 11 Bytes object content]
</pre></div>
</td></tr></table></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"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre> 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 206 Partial Content
Server: OBS
x-obs-request-id: 8DF400000163D3F2A89604C49ABEE55E
Accept-Ranges: bytes
ETag: &quot;2200446c2082f27ed2a569601ca4e360&quot;
Last-Modified: Mon, 14 Sep 2020 01:16:20 GMT
Content-Type: multipart/byteranges;boundary=35bcf444-e65f-4c76-9430-7e4a68dd3d26
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSIBWFOVW8eeWujkqSnoIANC2mNR1cdF
Date: Mon, 14 Sep 2020 10:02:43 GMT
Content-Length: 288
--35bcf444-e65f-4c76-9430-7e4a68dd3d26
Content-type: binary/octet-stream
Content-range: bytes 20-30/4583
[ 11 Bytes object content]
--35bcf444-e65f-4c76-9430-7e4a68dd3d26
Content-type: binary/octet-stream
Content-range: bytes 40-50/4583
[ 11 Bytes object content]
--35bcf444-e65f-4c76-9430-7e4a68dd3d26
</pre></div>
</td></tr></table></div>
<div class="section" id="obs_04_0083__section1081716488230"><h4 class="sectiontitle">Sample Request 4</h4><p id="obs_04_0083__p55313703612"><strong id="obs_04_0083__b4957920171011">Download an object if its Etag value matches</strong>.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0083__screen1988837122916"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4
5
6
7</pre></div></td><td class="code"><div class="highlight"><pre><span></span>GET /object01 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: WED, 01 Jul 2015 04:24:33 GMT
If-Match: 682e760adb130c60c120da3e333a8b09
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:NxtSMS0jaVxlLnxlO9awaMTn47s=
</pre></div>
</td></tr></table></div>
</div>
<div class="section" id="obs_04_0083__section154154183317"><h4 class="sectiontitle">Sample Response 4-1 (Non-Matched Etag)</h4><p id="obs_04_0083__p31791351372">If the Etag value of the stored object is not <strong id="obs_04_0083__b61482710149">682e760adb130c60c120da3e333a8b09</strong>, the system displays a message indicating that the download fails.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0083__screen1654618411336"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre> 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 412 Precondition Failed
Server: OBS
x-obs-request-id: 8DF400000163D3F2A89604C49ABEE55E
Content-Type: application/xml
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSQwxJ2I1VvxD/Xgwuw2G2RQax30gdXU
Date: WED, 01 Jul 2015 04:20:51 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="nt">&lt;Code&gt;</span>PreconditionFailed<span class="nt">&lt;/Code&gt;</span>
<span class="nt">&lt;Message&gt;</span>At least one of the pre-conditions you specified did not hold<span class="nt">&lt;/Message&gt;</span>
<span class="nt">&lt;RequestId&gt;</span>8DF400000163D3F2A89604C49ABEE55E<span class="nt">&lt;/RequestId&gt;</span>
<span class="nt">&lt;HostId&gt;</span>ha0ZGaSKVm+uLOrCXXtx4Qn1aLzvoeblctVXRAqA7pty10mzUUW/yOzFue04lBqu<span class="nt">&lt;/HostId&gt;</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 class="section" id="obs_04_0083__section65816410333"><h4 class="sectiontitle">Sample Response 4-2 (Successful Download)</h4><p id="obs_04_0083__p88331650133713">If the Etag value of the stored object is <strong id="obs_04_0083__b34660378151">682e760adb130c60c120da3e333a8b09</strong>, the download is successful.</p>
<div class="codecoloring" codetype="Xml" id="obs_04_0083__screen5585144133317"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre> 1
2
3
4
5
6
7
8
9
10
11
12</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 5DEB00000164A21E1FC826C58F6BA001
Accept-Ranges: bytes
ETag: &quot;682e760adb130c60c120da3e333a8b09&quot;
Last-Modified: Mon, 16 Jul 2015 08:03:34 GMT
Content-Type: application/octet-stream
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSbkdml1sLSvKnoHaRcOwRI+6+ustDwk
Date: Mon, 16 Jul 2015 08:04:00 GMT
Content-Length: 8
[ 8 Bytes object content]
</pre></div>
</td></tr></table></div>
</div>
<div class="section" id="obs_04_0083__section125202491859"><h4 class="sectiontitle">Sample Request 5</h4><p id="obs_04_0083__p5520149258"><strong id="obs_04_0083__b51851344152018">Carry the signature in the URL when downloading an object</strong>.</p>
<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 5</h4><div class="codecoloring" codetype="Xml" id="obs_04_0083__screen452113491751"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre> 1
2
3
4
5
6
7
8
9
10
11</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 804F00000164DB5E5B7FB908D3BA8E00
ETag: &quot;682e760adb130c60c120da3e333a8b09&quot;
Last-Modified: Mon, 16 Jul 2015 08:03:34 GMT
Content-Type: application/octet-stream
x-obs-id-2: 32AAAUJAIAABAAAQAAEAABAAAQAAEAABCTlpxILjhVK/heKOWIP8Wn2IWmQoerfw
Date: Fri, 27 Jul 2018 10:52:31 GMT
Content-Length: 8
[ 8 Bytes object content]
</pre></div>
</td></tr></table></div>
</div>
<div class="section" id="obs_04_0083__section20424171119127"><h4 class="sectiontitle">Sample Request 6</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"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4
5
6</pre></div></td><td class="code"><div class="highlight"><pre><span></span>GET /object01?response-content-disposition=attachment; filename*=utf-8''name1 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: WED, 01 Jul 2015 04:24:33 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:NxtSMS0jaVxlLnxlO9awaMTn47s=
</pre></div>
</td></tr></table></div>
</div>
<div class="section" id="obs_04_0083__section8426311201213"><h4 class="sectiontitle">Sample Response 6</h4><div class="codecoloring" codetype="Xml" id="obs_04_0083__screen4426211191219"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre> 1
2
3
4
5
6
7
8
9
10
11
12</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 804F00000164DB5E5B7FB908D3BA8E00
ETag: &quot;682e760adb130c60c120da3e333a8b09&quot;
Last-Modified: Mon, 16 Jul 2015 08:03:34 GMT
Content-Type: application/octet-stream
x-obs-id-2: 32AAAUJAIAABAAAQAAEAABAAAQAAEAABCTlpxILjhVK/heKOWIP8Wn2IWmQoerfw
Date: Fri, 27 Jul 2018 10:52:31 GMT
Content-Length: 8
Content-Disposition: attachment; filename*=utf-8''name1
[ 8 Bytes object content]
</pre></div>
</td></tr></table></div>
</div>
<div class="section" id="obs_04_0083__section9185459173518"><h4 class="sectiontitle">Sample Request 7</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"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1
2
3
4
5
6</pre></div></td><td class="code"><div class="highlight"><pre><span></span>GET /object01?attname=name1 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: WED, 01 Jul 2015 04:24:33 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:NxtSMS0jaVxlLnxlO9awaMTn47s=
</pre></div>
</td></tr></table></div>
</div>
<div class="section" id="obs_04_0083__section1378817131164"><h4 class="sectiontitle">Sample Response 7</h4><div class="codecoloring" codetype="Xml" id="obs_04_0083__screen162309310718"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre> 1
2
3
4
5
6
7
8
9
10
11
12</pre></div></td><td class="code"><div class="highlight"><pre><span></span>HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 804F00000164DB5E5B7FB908D3BA8E00
ETag: &quot;682e760adb130c60c120da3e333a8b09&quot;
Last-Modified: Mon, 16 Jul 2015 08:03:34 GMT
Content-Type: application/octet-stream
x-obs-id-2: 32AAAUJAIAABAAAQAAEAABAAAQAAEAABCTlpxILjhVK/heKOWIP8Wn2IWmQoerfw
Date: Fri, 27 Jul 2018 10:52:31 GMT
Content-Length: 8
Content-Disposition: attachment; filename*=utf-8''name1
[ 8 Bytes object content]
</pre></div>
</td></tr></table></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