vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/obs/api-ref/obs_04_0084.html
zhangyue 7d2a7ec198 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-11-05 16:37:11 +00:00

513 lines
47 KiB
HTML
Raw Permalink Blame History

<a name="obs_04_0084"></a><a name="obs_04_0084"></a>
<h1 class="topictitle1">Querying Object Metadata</h1>
<div id="body5678772"><div class="section" id="obs_04_0084__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0084__p50592173">Users with the read permission on objects can perform the HeadObject operation to obtain metadata of objects. The object metadata is included in the response.</p>
<p class="msonormal" id="obs_04_0084__p52676373">SSE-C headers are required if you want to obtain the metadata of an object encrypted using SSE-C. For details, see <a href="#obs_04_0084__table96532498195">Table 2</a>.</p>
</div>
<div class="section" id="obs_04_0084__section4325311"><h4 class="sectiontitle">Versioning</h4><p class="msonormal" id="obs_04_0084__p57327367">By default, this operation returns the latest metadata of an object. If the object has a delete marker, status code 404 is returned. To obtain the object metadata of a specified version, the <strong id="obs_04_0084__b410731275716">versionId</strong> parameter can be used to specify the desired version.</p>
</div>
<div class="section" id="obs_04_0084__section38927805"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0084__screen12750633"><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></pre></div></td><td class="code"><div><pre><span></span>HEAD<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
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0084__section14805926"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0084__p34188773"><a href="#obs_04_0084__table513617459176">Table 1</a> describes the request parameters.</p>
<div class="tablenoborder"><a name="obs_04_0084__table513617459176"></a><a name="table513617459176"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0084__table513617459176" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="obs_04_0084__row4136345111715"><th align="left" class="cellrowborder" valign="top" width="13.919999999999998%" id="mcps1.3.4.3.2.5.1.1"><p id="obs_04_0084__p181364453172">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.62%" id="mcps1.3.4.3.2.5.1.2"><p id="obs_04_0084__p21569541173"><strong id="obs_04_0084__b98916182495">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="9.93%" id="mcps1.3.4.3.2.5.1.3"><p id="obs_04_0084__p1613684518176"><strong id="obs_04_0084__b326573616166">Mandatory (Yes/No)</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="61.529999999999994%" id="mcps1.3.4.3.2.5.1.4"><p id="obs_04_0084__p1413613452173"><strong id="obs_04_0084__b18298135820373">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0084__row12136164517170"><td class="cellrowborder" valign="top" width="13.919999999999998%" headers="mcps1.3.4.3.2.5.1.1 "><p id="obs_04_0084__p19136144518178">versionId</p>
</td>
<td class="cellrowborder" valign="top" width="14.62%" headers="mcps1.3.4.3.2.5.1.2 "><p id="obs_04_0084__p71364453173">String</p>
</td>
<td class="cellrowborder" valign="top" width="9.93%" headers="mcps1.3.4.3.2.5.1.3 "><p id="obs_04_0084__p4136154571717">No</p>
</td>
<td class="cellrowborder" valign="top" width="61.529999999999994%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0084__p7134184955020"><strong id="obs_04_0084__b120028508983826">Explanation</strong>:</p>
<p id="obs_04_0084__p1711116513225">Version ID of the object.</p>
<p id="obs_04_0084__p17930912141817"><strong id="obs_04_0084__b15930412161812">Restrictions</strong>:</p>
<p id="obs_04_0084__p179302012141813">None</p>
<p id="obs_04_0084__p7930191211810"><strong id="obs_04_0084__b19930131210183">Value range</strong>:</p>
<p id="obs_04_0084__p293071219185">The value must contain 32 characters.</p>
<p id="obs_04_0084__p14930101281819"><strong id="obs_04_0084__b149301212171818">Default value</strong>:</p>
<p id="obs_04_0084__p189306121183">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0084__section66144477"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0084__p16621896">This request uses common headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a>.</p>
<p class="msonormal" id="obs_04_0084__p4196316">In addition, the request can use additional headers shown in <a href="#obs_04_0084__table96532498195">Table 2</a>.</p>
<div class="tablenoborder"><a name="obs_04_0084__table96532498195"></a><a name="table96532498195"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0084__table96532498195" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request headers</caption><thead align="left"><tr id="obs_04_0084__row1365364914192"><th align="left" class="cellrowborder" valign="top" width="19.470000000000002%" id="mcps1.3.5.4.2.5.1.1"><p id="obs_04_0084__p56539494199">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="8.83%" id="mcps1.3.5.4.2.5.1.2"><p id="obs_04_0084__p103119652217"><strong id="obs_04_0084__b18106203814220">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="8.16%" id="mcps1.3.5.4.2.5.1.3"><p id="obs_04_0084__p196531493194"><strong id="obs_04_0084__b125510576410">Mandatory (Yes/No)</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="63.54%" id="mcps1.3.5.4.2.5.1.4"><p id="obs_04_0084__p465314497197"><strong id="obs_04_0084__b3692188103814">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0084__row1653164917196"><td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.5.4.2.5.1.1 "><p id="obs_04_0084__p665324951910">Origin</p>
</td>
<td class="cellrowborder" valign="top" width="8.83%" headers="mcps1.3.5.4.2.5.1.2 "><p id="obs_04_0084__p1792134117226">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.4.2.5.1.3 "><p id="obs_04_0084__p19653649191913">No</p>
</td>
<td class="cellrowborder" valign="top" width="63.54%" headers="mcps1.3.5.4.2.5.1.4 "><p id="obs_04_0084__p6361112212579"><strong id="obs_04_0084__b155537612383826">Explanation</strong>:</p>
<p id="obs_04_0084__p18341912248">Origin specified in a preflight request that makes a cross-domain request, usually as a domain name.</p>
<p id="obs_04_0084__p2058311368186"><strong id="obs_04_0084__b145831236131811">Restrictions</strong>:</p>
<p id="obs_04_0084__p17583536161816">You can enter multiple origins, with one separated from another using a line break. Each origin can contain at most one wildcard character (<strong id="obs_04_0084__b157477636035417">*</strong>).</p>
<p id="obs_04_0084__p3583123619187"><strong id="obs_04_0084__b058353611184">Value range</strong>:</p>
<p id="obs_04_0084__p175831436201811">The value that complies with the CORS</p>
<p id="obs_04_0084__p13583036131817"><strong id="obs_04_0084__b17583136141815">Default value</strong>:</p>
<p id="obs_04_0084__p25831336191813">None</p>
</td>
</tr>
<tr id="obs_04_0084__row1865316497190"><td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.5.4.2.5.1.1 "><p id="obs_04_0084__p156531249181911">Access-Control-Request-Headers</p>
</td>
<td class="cellrowborder" valign="top" width="8.83%" headers="mcps1.3.5.4.2.5.1.2 "><p id="obs_04_0084__p741814412221">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.4.2.5.1.3 "><p id="obs_04_0084__p865310496191">No</p>
</td>
<td class="cellrowborder" valign="top" width="63.54%" headers="mcps1.3.5.4.2.5.1.4 "><p id="obs_04_0084__p17425724135719"><strong id="obs_04_0084__b110822609283826">Explanation</strong>:</p>
<p id="obs_04_0084__p66531549121910">Indicates the HTTP headers that are allowed in a request. The request can use multiple HTTP headers.</p>
<p id="obs_04_0084__p13654458101813"><strong id="obs_04_0084__b11654195881819">Restrictions</strong>:</p>
<p id="obs_04_0084__p165485820185">You can enter multiple allowed headers, with one separated from another using a line break. Each header can contain at most one wildcard character (*). Spaces, ampersands (&amp;), colons (:), less-than signs (&lt;), and full-width characters are not allowed.</p>
<p id="obs_04_0084__p46548584185"><strong id="obs_04_0084__b665412588184">Value range</strong>:</p>
<p id="obs_04_0084__p565435820188">The value that complies with the CORS</p>
<p id="obs_04_0084__p1465495891816"><strong id="obs_04_0084__b76541158111815">Default value</strong>:</p>
<p id="obs_04_0084__p9654058151813">None</p>
</td>
</tr>
<tr id="obs_04_0084__row17653549131910"><td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.5.4.2.5.1.1 "><p id="obs_04_0084__p46531149191912">x-obs-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="8.83%" headers="mcps1.3.5.4.2.5.1.2 "><p id="obs_04_0084__p060104652216">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.4.2.5.1.3 "><p id="obs_04_0084__p765434911914">No. This header is required when SSE-C is used.</p>
</td>
<td class="cellrowborder" valign="top" width="63.54%" headers="mcps1.3.5.4.2.5.1.4 "><p id="obs_04_0084__p164012612577"><strong id="obs_04_0084__b46693345683826">Explanation</strong>:</p>
<p id="obs_04_0084__p36539492190">Indicates the decryption algorithm used when SSE-C is used.</p>
<p id="obs_04_0084__p1765311495199">Example: <strong id="obs_04_0084__b1661931385">x-obs-server-side-encryption-customer-algorithm:AES256</strong></p>
<p id="obs_04_0084__p5641112615570"><strong id="obs_04_0084__b8495192316388">Restrictions</strong>:</p>
<p id="obs_04_0084__p0517133217234">This header must be used together with <strong id="obs_04_0084__b8171152423817">x-obs-server-side-encryption-customer-key</strong> and <strong id="obs_04_0084__b017118249384">x-obs-server-side-encryption-customer-key-MD5</strong>.</p>
<p id="obs_04_0084__p97938183190"><strong id="obs_04_0084__b2793191881917">Value range</strong>:</p>
<p id="obs_04_0084__p1479311851912">AES256</p>
<p id="obs_04_0084__p6793161815195"><strong id="obs_04_0084__b20793118171917">Default value</strong>:</p>
<p id="obs_04_0084__p18793131881917">None</p>
</td>
</tr>
<tr id="obs_04_0084__row86541249171917"><td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.5.4.2.5.1.1 "><p id="obs_04_0084__p96544491196">x-obs-server-side-encryption-customer-key</p>
</td>
<td class="cellrowborder" valign="top" width="8.83%" headers="mcps1.3.5.4.2.5.1.2 "><p id="obs_04_0084__p17290114813227">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.4.2.5.1.3 "><p id="obs_04_0084__p1765404961914">No. This header is required when SSE-C is used.</p>
</td>
<td class="cellrowborder" valign="top" width="63.54%" headers="mcps1.3.5.4.2.5.1.4 "><p id="obs_04_0084__p13031030145720"><strong id="obs_04_0084__b164203081383826">Explanation</strong>:</p>
<p id="obs_04_0084__p1265494917196">Indicates the decryption key used when SSE-C is used.</p>
<p id="obs_04_0084__p1465416495193">Example: <strong id="obs_04_0084__b1405291906">x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=</strong></p>
<p id="obs_04_0084__p17303203085719"><strong id="obs_04_0084__b183039302573">Restrictions</strong>:</p>
<p id="obs_04_0084__p196541249151914">This header is a Base64-encoded 256-bit key and must be used together with <strong id="obs_04_0084__b25571304384">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0084__b155743013818">x-obs-server-side-encryption-customer-key-MD5</strong>.</p>
<p id="obs_04_0084__p11434944724"><strong id="obs_04_0084__b243418447220">Value range</strong>:</p>
<p id="obs_04_0084__p11614137161916">None</p>
<p id="obs_04_0084__p543410442216"><strong id="obs_04_0084__b1643420445216">Default value</strong>:</p>
<p id="obs_04_0084__p0190103514195">None</p>
</td>
</tr>
<tr id="obs_04_0084__row6654104971917"><td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.5.4.2.5.1.1 "><p id="obs_04_0084__p1865412491196">x-obs-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="8.83%" headers="mcps1.3.5.4.2.5.1.2 "><p id="obs_04_0084__p395514972218">String</p>
</td>
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.4.2.5.1.3 "><p id="obs_04_0084__p17654144991911">No. This header is required when SSE-C is used.</p>
</td>
<td class="cellrowborder" valign="top" width="63.54%" headers="mcps1.3.5.4.2.5.1.4 "><p id="obs_04_0084__p390653595715"><strong id="obs_04_0084__b28718942083826">Explanation</strong>:</p>
<p id="obs_04_0084__p56541549111919">Indicates the MD5 value of the decryption 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_0084__p5654194916192">Example: <strong id="obs_04_0084__b1660286162">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0084__p1990663516574"><strong id="obs_04_0084__b7906183514571">Restrictions</strong>:</p>
<p id="obs_04_0084__p465404916194">This header is a Base64-encoded 128-bit MD5 value and must be used together with <strong id="obs_04_0084__b9619538163815">x-obs-server-side-encryption-customer-algorithm</strong> and <strong id="obs_04_0084__b17619183813386">x-obs-server-side-encryption-customer-key</strong>.</p>
<p id="obs_04_0084__p19261354141917"><strong id="obs_04_0084__b22605451915">Value range</strong>:</p>
<p id="obs_04_0084__p226135431920">Base64-encoded MD5 value of the key ID.</p>
<p id="obs_04_0084__p1526165411196"><strong id="obs_04_0084__b132665471911">Default value</strong>:</p>
<p id="obs_04_0084__p1726185441913">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0084__section58429386"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0084__p36881577">This request involves no elements.</p>
</div>
<div class="section" id="obs_04_0084__section56102430"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0084__screen3213824"><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>HTTP/1.1<span class="w"> </span>status_code
Content-Type:<span class="w"> </span>type
Date:<span class="w"> </span>date
Content-Length:<span class="w"> </span>length
Etag:<span class="w"> </span>etag
Last-Modified:<span class="w"> </span>time
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0084__section35159826"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0084__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_0084__p56384785">In addition to the common response headers, the headers listed in <a href="#obs_04_0084__table689195872210">Table 3</a> may be used.</p>
<div class="tablenoborder"><a name="obs_04_0084__table689195872210"></a><a name="table689195872210"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0084__table689195872210" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Additional response headers</caption><thead align="left"><tr id="obs_04_0084__row289145818223"><th align="left" class="cellrowborder" valign="top" width="25.15%" id="mcps1.3.8.4.2.4.1.1"><p id="obs_04_0084__p2089105814226">Header</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.73%" id="mcps1.3.8.4.2.4.1.2"><p id="obs_04_0084__p9133171519239"><strong id="obs_04_0084__b735773292318">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="55.120000000000005%" id="mcps1.3.8.4.2.4.1.3"><p id="obs_04_0084__p1689155818222"><strong id="obs_04_0084__b895517215515">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="obs_04_0084__row1789135819228"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p1589135882213">x-obs-expiration</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p81332015132312">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__p6149351132019"><strong id="obs_04_0084__b680039396">Explanation</strong>:</p>
<p id="obs_04_0084__p814910516203">Expiration details</p>
<p id="obs_04_0084__p91491151102015"><strong id="obs_04_0084__b61491551102017">Restrictions</strong>:</p>
<p id="obs_04_0084__p614914519201">None</p>
<p id="obs_04_0084__p3149185192017"><strong id="obs_04_0084__b31491851162013">Value range</strong>:</p>
<p id="obs_04_0084__p914985142020">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_0084__b215336524">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_0084__b984366955">expiry-date</strong> and <strong id="obs_04_0084__b867550044">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_0084__p10149155114206"><strong id="obs_04_0084__b814905122010">Default value</strong>:</p>
<p id="obs_04_0084__p714925116209">None</p>
</td>
</tr>
<tr id="obs_04_0084__row48965842212"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p118965822216">x-obs-website-redirect-location</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p613317159235">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__p14160499211"><strong id="obs_04_0084__b510833471">Explanation</strong>:</p>
<p id="obs_04_0084__p11160995219">Indicates where an object request is redirected. If the bucket that contains the object is configured with Website settings, this parameter can be set in the object metadata so that the request for the object can be redirected to another object in the same bucket or an external URL after the website returns a 301 redirect response.</p>
<p id="obs_04_0084__p816013952113">To another object in the same bucket:</p>
<p id="obs_04_0084__p016012913212">x-obs-website-redirect-location:/anotherPage.html</p>
<p id="obs_04_0084__p81609915214">To an external URL:</p>
<p id="obs_04_0084__p81608982111">x-obs-website-redirect-location:http://www.example.com/</p>
<p id="obs_04_0084__p171608912110">OBS obtains the specified value from the header and stores it in the object metadata <strong id="obs_04_0084__b1068611678">WebsiteRedirectLocation</strong>.</p>
<p id="obs_04_0084__p316015952118"><strong id="obs_04_0084__b161607911214">Restrictions</strong>:</p>
<ul id="obs_04_0084__ul71601195210"><li id="obs_04_0084__li216019917212">The value must start with a slash (/), <strong id="obs_04_0084__b334224874">http://</strong>, or <strong id="obs_04_0084__b53434419714">https://</strong> and cannot exceed 2 KB.</li><li id="obs_04_0084__li18160799216">OBS supports redirection for objects in the root directory of a bucket, not for those in folders.</li></ul>
<p id="obs_04_0084__p19160691213"><strong id="obs_04_0084__b181608992114">Default value</strong>:</p>
<p id="obs_04_0084__p71601596219">None</p>
</td>
</tr>
<tr id="obs_04_0084__row38965813220"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p1789135816225">x-obs-version-id</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p9133131592314">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__p564711472572"><strong id="obs_04_0084__b180206576283826">Explanation</strong>:</p>
<p id="obs_04_0084__p1889145815225">Version ID of the object. If the object has no version number specified, the response does not contain this header.</p>
<p id="obs_04_0084__p1664718473572"><strong id="obs_04_0084__b36471947185711">Restrictions</strong>:</p>
<p id="obs_04_0084__en-us_topic_0262985983_p6836138122914">The value must contain 32 characters.</p>
<p id="obs_04_0084__p106471547175715"><strong id="obs_04_0084__b12806934878410">Value range</strong>:</p>
<p id="obs_04_0084__p12821526401">None</p>
<p id="obs_04_0084__p7647194705715"><strong id="obs_04_0084__b115775064884153">Default value</strong>:</p>
<p id="obs_04_0084__p20891058102210">None</p>
</td>
</tr>
<tr id="obs_04_0084__row198915585221"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p208925820224">Access-Control-Allow-Origin</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p11133201592310">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__p15299105075718"><strong id="obs_04_0084__b172193230283826">Explanation</strong>:</p>
<p id="obs_04_0084__p589135862211">Returned if the request origin meets the CORS configured on the server.</p>
<p id="obs_04_0084__p128261625224"><strong id="obs_04_0084__b082616218222">Restrictions</strong>:</p>
<p id="obs_04_0084__p982612202212">None</p>
<p id="obs_04_0084__p28261922223"><strong id="obs_04_0084__b68265282213">Value range</strong>:</p>
<p id="obs_04_0084__p1682617212228">The value that complies with the CORS</p>
<p id="obs_04_0084__p68261121225"><strong id="obs_04_0084__b982612282218">Default value</strong>:</p>
<p id="obs_04_0084__p382613212229">None</p>
</td>
</tr>
<tr id="obs_04_0084__row0897583221"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p1489155810225">Access-Control-Allow-Headers</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p17133151532312">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__p1646145218570"><strong id="obs_04_0084__b189160584583826">Explanation</strong>:</p>
<p id="obs_04_0084__p8249513162820">Returned if the request headers meet the CORS configured on the server.</p>
<p id="obs_04_0084__p7446101912227"><strong id="obs_04_0084__b0446111920222">Restrictions</strong>:</p>
<p id="obs_04_0084__p144681913220">At most one asterisk (*) is allowed. Spaces, ampersands (&amp;), colons (:), less-than signs (&lt;), and full-width characters are not allowed.</p>
<p id="obs_04_0084__p1944641910222"><strong id="obs_04_0084__b4446161962210">Value range</strong>:</p>
<p id="obs_04_0084__p19446219192210">The value that complies with the CORS</p>
<p id="obs_04_0084__p144462019192219"><strong id="obs_04_0084__b14446151952215">Default value</strong>:</p>
<p id="obs_04_0084__p644614192228">None</p>
</td>
</tr>
<tr id="obs_04_0084__row1189158182213"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p20892584225">Access-Control-Max-Age</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p81333158234">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__p330811371224"><strong id="obs_04_0084__b2075705626">Explanation</strong>:</p>
<p id="obs_04_0084__p5308113722213"><strong id="obs_04_0084__b76379031735417">MaxAgeSeconds</strong> in the CORS rules of the bucket. It specifies the time your client can cache the response for a cross-origin request.</p>
<p id="obs_04_0084__p130833719224"><strong id="obs_04_0084__b330803711225">Restrictions</strong>:</p>
<p id="obs_04_0084__p13308123722210">Each CORS rule can contain at most one <strong id="obs_04_0084__b51021496235417">MaxAgeSeconds</strong>.</p>
<p id="obs_04_0084__p130853711220"><strong id="obs_04_0084__b5308103782214">Value range</strong>:</p>
<p id="obs_04_0084__p9308203722215">An integer greater than or equal to 0, in seconds</p>
<p id="obs_04_0084__p1530814378222"><strong id="obs_04_0084__b4308203742212">Default value</strong>:</p>
<p id="obs_04_0084__p1230817370221">3000</p>
</td>
</tr>
<tr id="obs_04_0084__row16891958102214"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p78905882214">Access-Control-Allow-Methods</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p19133121512230">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__en-us_topic_0262985983_p260932420571"><strong id="obs_04_0084__b143826600183826">Explanation</strong>:</p>
<p id="obs_04_0084__p382936134610">Indicates that methods in the rule are included in the response if Access-Control-Request-Method in the request meets the CORS configuration requirements when CORS is configured for buckets.</p>
<p id="obs_04_0084__en-us_topic_0262985983_p460962411579"><strong id="obs_04_0084__en-us_topic_0262985983_b1609224105711">Value range</strong>:</p>
<ul id="obs_04_0084__en-us_topic_0262985983_en-us_topic_0262515644_ul1862243913291"><li id="obs_04_0084__en-us_topic_0262985983_en-us_topic_0262515644_li762243952910">GET</li><li id="obs_04_0084__en-us_topic_0262985983_en-us_topic_0262515644_li6213144119299">PUT</li><li id="obs_04_0084__en-us_topic_0262985983_en-us_topic_0262515644_li17251244102913">HEAD</li><li id="obs_04_0084__en-us_topic_0262985983_en-us_topic_0262515644_li5945470299">POST</li><li id="obs_04_0084__en-us_topic_0262985983_en-us_topic_0262515644_li126515814296">DELETE</li></ul>
</td>
</tr>
<tr id="obs_04_0084__row168910587220"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p168915817221">Access-Control-Expose-Headers</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p6133171515236">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__p1435143918235"><strong id="obs_04_0084__b1226289163">Explanation</strong>:</p>
<p id="obs_04_0084__p103533917232"><strong id="obs_04_0084__b200747670935417">ExposeHeader</strong> in the CORS rules of the bucket. It specifies additional headers allowed in the response by a CORS rule, which are used to provide extra information to clients. By default, a browser can access only headers <strong id="obs_04_0084__b856845012912">Content-Length</strong> and <strong id="obs_04_0084__b2568155011916">Content-Type</strong>. If the browser needs to access other headers, you need to configure them as additional headers.</p>
<p id="obs_04_0084__p435839162317"><strong id="obs_04_0084__b43519398237">Restrictions</strong>:</p>
<p id="obs_04_0084__p4359399235">Spaces, asterisks (*), ampersands (&amp;), colons (:), less-than signs (&lt;), and full-width characters are not allowed.</p>
<p id="obs_04_0084__p4359392231"><strong id="obs_04_0084__b93523910238">Value range</strong>:</p>
<p id="obs_04_0084__p1535193922320">None</p>
<p id="obs_04_0084__p13351439132319"><strong id="obs_04_0084__b03503917236">Default value</strong>:</p>
<p id="obs_04_0084__p63573942312">None</p>
</td>
</tr>
<tr id="obs_04_0084__row689158132211"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p1290125810226">x-obs-server-side-encryption</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p13133151510237">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__p141492175810"><strong id="obs_04_0084__b157956871983826">Explanation</strong>:</p>
<p id="obs_04_0084__p99075815227">The encryption method used by the server.</p>
<p id="obs_04_0084__p1790175882218">Example: <strong id="obs_04_0084__b105188008">x-obs-server-side-encryption:kms</strong></p>
<p id="obs_04_0084__p841517245820"><strong id="obs_04_0084__b148151959194913">Restrictions</strong>:</p>
<p id="obs_04_0084__p16836206104">This header is included in a response if SSE-KMS is used. </p>
<p id="obs_04_0084__p1766135813239"><strong id="obs_04_0084__b2066185832311">Value range</strong>:</p>
<ul id="obs_04_0084__ul495218392410"><li id="obs_04_0084__li19525352417">kms</li><li id="obs_04_0084__li1995215311248">AES256</li></ul>
<p id="obs_04_0084__p06665816237"><strong id="obs_04_0084__b13661958172314">Default value</strong>:</p>
<p id="obs_04_0084__p136612587235">None</p>
</td>
</tr>
<tr id="obs_04_0084__row16901658102219"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p13908584222">x-obs-server-side-encryption-kms-key-id</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p913314157238">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__p17204151151920"><strong id="obs_04_0084__b0854164516487">Explanation</strong>:</p>
<p id="obs_04_0084__p420411120199">ID of a specified key used for SSE-KMS encryption.</p>
<p id="obs_04_0084__p10205911141918"><strong id="obs_04_0084__b1105954265">Restrictions</strong>:</p>
<p id="obs_04_0084__p10205111141912">This header can only be used when you specify <strong id="obs_04_0084__b6343347453727">kms</strong> for the <strong id="obs_04_0084__b11342082693727">x-obs-server-side-encryption</strong> header.</p>
<p id="obs_04_0084__p3205121115191"><strong id="obs_04_0084__b455227162">Default value</strong>:</p>
<p id="obs_04_0084__p3205511101919">If you specify <strong id="obs_04_0084__b1780352493727">kms</strong> for encryption but do not specify a key ID, the default master key will be used. If there is not a default master key, OBS will create one and use it.</p>
</td>
</tr>
<tr id="obs_04_0084__row1690145815221"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p7906586225">x-obs-server-side-encryption-customer-algorithm</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p013341517239">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__p64281111185818"><strong id="obs_04_0084__b144225574183826">Explanation</strong>:</p>
<p id="obs_04_0084__p1690205822215">Indicates a decryption algorithm. This header is included in a response if SSE-C is used. </p>
<p id="obs_04_0084__p109025812227">Example: <strong id="obs_04_0084__b1927506029">x-obs-server-side-encryption-customer-algorithm:AES256</strong></p>
<p id="obs_04_0084__p161244122516"><strong id="obs_04_0084__b17925457253">Restrictions</strong>:</p>
<p id="obs_04_0084__p461214172520">None</p>
<p id="obs_04_0084__p17612541152513"><strong id="obs_04_0084__b19437747162512">Value range</strong>:</p>
<p id="obs_04_0084__p1061274115255">AES256</p>
<p id="obs_04_0084__p561244117255"><strong id="obs_04_0084__b5911349132519">Default value</strong>:</p>
<p id="obs_04_0084__p17612164117255">None</p>
</td>
</tr>
<tr id="obs_04_0084__row190145819222"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p39035811221">x-obs-server-side-encryption-customer-key-MD5</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p121332015132317">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__p166712014175810"><strong id="obs_04_0084__b167100704883826">Explanation</strong>:</p>
<p id="obs_04_0084__p49065802213">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_0084__p690135842219">Example: <strong id="obs_04_0084__b210959597">x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==</strong></p>
<p id="obs_04_0084__p1871269122618"><strong id="obs_04_0084__b171215932615">Restrictions</strong>:</p>
<p id="obs_04_0084__p187121693265">Base64-encoded MD5 value of the key, for example, <strong id="obs_04_0084__b64588923335417">4XvB3tbNTN+tIEVa0/fGaQ==</strong>.</p>
<p id="obs_04_0084__p127121599265"><strong id="obs_04_0084__b47134922617">Value range</strong>:</p>
<p id="obs_04_0084__p87131922615">Base64-encoded MD5 value of the key ID.</p>
<p id="obs_04_0084__p971310912614"><strong id="obs_04_0084__b1971309192612">Default value</strong>:</p>
<p id="obs_04_0084__p5713159192617">None</p>
</td>
</tr>
<tr id="obs_04_0084__row990158172213"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p1790258122213">x-obs-storage-class</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p21333151235">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__p1031011188584"><strong id="obs_04_0084__b212175655583826">Explanation</strong>:</p>
<p id="obs_04_0084__p8902581224">Storage class of an object.</p>
<p id="obs_04_0084__p331011816589"><strong id="obs_04_0084__b19997505">Restrictions</strong>:</p>
<p id="obs_04_0084__p1143102242514">This header is returned only when the storage class of an object is not Standard.</p>
<p id="obs_04_0084__p173101318135820"><strong id="obs_04_0084__b8241583088410">Value range</strong>:</p>
<ul id="obs_04_0084__ul0556181114273"><li id="obs_04_0084__li115561611192718">WARM</li><li id="obs_04_0084__li855681114278">COLD</li></ul>
<p id="obs_04_0084__p18310161865814"><strong id="obs_04_0084__b5472406884153">Default value</strong>:</p>
<p id="obs_04_0084__p2790153717269">None</p>
</td>
</tr>
<tr id="obs_04_0084__row1490165818223"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p119035811220">x-obs-restore</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p11333151231">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__en-us_topic_0262985983_p1666995465917"><strong id="obs_04_0084__b634928591">Explanation</strong>:</p>
<p id="obs_04_0084__p393113584325">Restore status of an object.</p>
<p id="obs_04_0084__en-us_topic_0262985983_p1713910118555">For example, <strong id="obs_04_0084__b1715341011137">ongoing-request="true"</strong> indicates that the object is being restored. <strong id="obs_04_0084__b4153910181313">ongoing-request="false", expiry-date="Wed, 7 Nov 2012 00:00:00 GMT"</strong> indicates that the object has been restored, where <strong id="obs_04_0084__b115411102139">expiry-date</strong> indicates when the restored object expires.</p>
<p id="obs_04_0084__en-us_topic_0262985983_p195611849195717"><strong id="obs_04_0084__en-us_topic_0262985983_b18561349105713">Restrictions</strong>:</p>
<p id="obs_04_0084__p199918274558">This header is returned only when a Cold object is being restored or has been restored.</p>
<p id="obs_04_0084__p791211507278"><strong id="obs_04_0084__b991211504276">Value range</strong>:</p>
<p id="obs_04_0084__p491212506270">None</p>
<p id="obs_04_0084__p18912350182715"><strong id="obs_04_0084__b14912135011278">Default value</strong>:</p>
<p id="obs_04_0084__p14912650102718">None</p>
</td>
</tr>
<tr id="obs_04_0084__row1691458132214"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p119185852212">x-obs-object-type</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p013391542315">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__p3455132485816"><strong id="obs_04_0084__b107951177783826">Explanation</strong>:</p>
<p id="obs_04_0084__p1791414122263">Object type</p>
<p id="obs_04_0084__p16455324135818"><strong id="obs_04_0084__b189391313165011">Restrictions</strong>:</p>
<p id="obs_04_0084__p32940475365">This header is returned only when the object is not a Normal object.</p>
<p id="obs_04_0084__p368815114295"><strong id="obs_04_0084__b1168815513292">Value range</strong>:</p>
<p id="obs_04_0084__p186881351142913">Appendable</p>
<p id="obs_04_0084__p7688155118291"><strong id="obs_04_0084__b13688125118292">Default value</strong>:</p>
<p id="obs_04_0084__p6688155162912">None</p>
</td>
</tr>
<tr id="obs_04_0084__row169110581226"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p2913582225">x-obs-next-append-position</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p1191175815223">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__p1829916818302"><strong id="obs_04_0084__b653499666">Explanation</strong>:</p>
<p id="obs_04_0084__p629938113018">Indicates the position that should be provided in the next request.</p>
<p id="obs_04_0084__p12992853019"><strong id="obs_04_0084__b152994814307">Restrictions</strong>:</p>
<p id="obs_04_0084__p11299389305">This header is returned only when the object is an Appendable object.</p>
<p id="obs_04_0084__p229913814300"><strong id="obs_04_0084__b3299583309">Value range</strong>:</p>
<p id="obs_04_0084__p82991787309">None</p>
<p id="obs_04_0084__p529998103019"><strong id="obs_04_0084__b172991888301">Default value</strong>:</p>
<p id="obs_04_0084__p192991815307">None</p>
</td>
</tr>
<tr id="obs_04_0084__row169116583226"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p18911358112218">x-obs-uploadId</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p141331415192318">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__p1093103115816"><strong id="obs_04_0084__b25096969783826">Explanation</strong>:</p>
<p id="obs_04_0084__p179175832220">Indicates the ID of a multipart task.</p>
<p id="obs_04_0084__p5815659172015"><strong id="obs_04_0084__b9815195919208">Restrictions</strong>:</p>
<p id="obs_04_0084__p199619464014">This header is returned only when the object is created from a multipart upload.</p>
<p id="obs_04_0084__p1172912712307"><strong id="obs_04_0084__b472952783014">Value range</strong>:</p>
<p id="obs_04_0084__p07291927183010">None</p>
<p id="obs_04_0084__p5729227143012"><strong id="obs_04_0084__b77294276303">Default value</strong>:</p>
<p id="obs_04_0084__p772992713011">None</p>
</td>
</tr>
<tr id="obs_04_0084__row199120588227"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p7911858152217">x-obs-tagging-count</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p313391510238">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__p117091233135818"><strong id="obs_04_0084__b133112379883826">Explanation</strong>:</p>
<p id="obs_04_0084__p7911458162210">Number of tags associated with an object. </p>
<p id="obs_04_0084__p179219585227">Example: <strong id="obs_04_0084__b1609219000">x-obs-tagging-count:1</strong></p>
<p id="obs_04_0084__p11958326215"><strong id="obs_04_0084__b39583213213">Restrictions</strong>:</p>
<p id="obs_04_0084__p10959102122110">This header is returned only when you have the permission to read tags.</p>
<p id="obs_04_0084__p1665215403010"><strong id="obs_04_0084__b1165218544306">Value range</strong>:</p>
<p id="obs_04_0084__p56521054103016">None</p>
<p id="obs_04_0084__p365235410307"><strong id="obs_04_0084__b8652954183015">Default value</strong>:</p>
<p id="obs_04_0084__p36527547308">None</p>
</td>
</tr>
<tr id="obs_04_0084__row1292758152219"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p1392115816229">x-obs-object-lock-mode</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p613381514239">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__p173652376587"><strong id="obs_04_0084__b66151603483826">Explanation</strong>:</p>
<p id="obs_04_0084__p5927581228">WORM mode applied to the object.</p>
<p id="obs_04_0084__p179225872216">Example: <strong id="obs_04_0084__b1263800087">x-obs-object-lock-mode:COMPLIANCE</strong></p>
<p id="obs_04_0084__p145841542120"><strong id="obs_04_0084__b8584165162116">Restrictions</strong>:</p>
<ul id="obs_04_0084__ul8745162913449"><li id="obs_04_0084__li1674517290448">This parameter is returned only when the object has any object-level WORM retention policy configured or has a default bucket-level WORM policy applied.</li><li id="obs_04_0084__li074513292447">The user must have the GetObjectRetention permission.</li></ul>
<p id="obs_04_0084__p206961871319"><strong id="obs_04_0084__b1869710783117">Value range</strong>:</p>
<p id="obs_04_0084__p18697197143116">Currently, only COMPLIANCE (compliance mode) is supported.</p>
<p id="obs_04_0084__p16971676319"><strong id="obs_04_0084__b1769710718317">Default value</strong>:</p>
<p id="obs_04_0084__p669715703112">None</p>
</td>
</tr>
<tr id="obs_04_0084__row99285816229"><td class="cellrowborder" valign="top" width="25.15%" headers="mcps1.3.8.4.2.4.1.1 "><p id="obs_04_0084__p392958162211">x-obs-object-lock-retain-until-date</p>
</td>
<td class="cellrowborder" valign="top" width="19.73%" headers="mcps1.3.8.4.2.4.1.2 "><p id="obs_04_0084__p17133131517233">String</p>
</td>
<td class="cellrowborder" valign="top" width="55.120000000000005%" headers="mcps1.3.8.4.2.4.1.3 "><p id="obs_04_0084__p153034403585"><strong id="obs_04_0084__b102185024583826">Explanation</strong>:</p>
<p id="obs_04_0084__p1692185822211">When an object lock expires.</p>
<p id="obs_04_0084__p14922058202218">Example: <strong id="obs_04_0084__b1499743977">x-obs-object-lock-retain-until-date:2015-07-01T04:11:15Z</strong></p>
<p id="obs_04_0084__p1948911813212"><strong id="obs_04_0084__b1048938152118">Restrictions</strong>:</p>
<ul id="obs_04_0084__ul5798172519450"><li id="obs_04_0084__li679842524517">The value must be a UTC time that complies with the ISO 8601 standard. Example: <strong id="obs_04_0084__b4296932133116">2015-07-01T04:11:15Z</strong></li><li id="obs_04_0084__li1579872544512">This parameter is returned only when the object has any object-level WORM retention policy configured or has a default bucket-level WORM policy applied.</li><li id="obs_04_0084__li1579819253455">The user must have the GetObjectRetention permission.</li></ul>
<p id="obs_04_0084__p20428632163118"><strong id="obs_04_0084__b1842883293111">Value range</strong>:</p>
<p id="obs_04_0084__p1542811326316">The value must be later than the current time.</p>
<p id="obs_04_0084__p8428123217319"><strong id="obs_04_0084__b154281832173116">Default value</strong>:</p>
<p id="obs_04_0084__p642810321318">None</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="obs_04_0084__section48002983"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0084__p4861884">This response contains no elements.</p>
</div>
<div class="section" id="obs_04_0084__section29373671"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0084__p58268319">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_0084__section412912471360"><h4 class="sectiontitle">Sample Request</h4><div class="codecoloring" codetype="Xml" id="obs_04_0084__screen893117504617"><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>HEAD<span class="w"> </span>/object1<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:19:25<span class="w"> </span>GMT
Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEBQQCEC:/cARjk81l2iExMfQqn6iT3qEZ74=
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="obs_04_0084__section18605296485"><h4 class="sectiontitle">Sample Response</h4><div class="codecoloring" codetype="Xml" id="obs_04_0084__screen91063375488"><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></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>8DF400000163D3E4BB5905C41B6E65B6
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:19:21<span class="w"> </span>GMT
Content-Type:<span class="w"> </span>binary/octet-stream
x-obs-id-2:<span class="w"> </span>32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSD3nAiTaBoeyt9oHp9vTYtXnLDmwV6D
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:19:21<span class="w"> </span>GMT
Content-Length:<span class="w"> </span>4572
</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