forked from docs/doc-exports
zhangyue
7d2a7ec198
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com> Co-authored-by: zhangyue <zhangyue164@huawei.com> Co-committed-by: zhangyue <zhangyue164@huawei.com>
325 lines
28 KiB
HTML
325 lines
28 KiB
HTML
<a name="obs_04_0074"></a><a name="obs_04_0074"></a>
|
|
|
|
<h1 class="topictitle1">Configuring Bucket CORS</h1>
|
|
<div id="body51020275"><div class="section" id="obs_04_0074__section5584184924715"><h4 class="sectiontitle">Functions</h4><p class="msonormal" id="obs_04_0074__p32096233">Cross-origin resource sharing (CORS) is a standard mechanism proposed by World Wide Web Consortium (W3C) and allows cross-origin requests from clients. For standard web page requests, the scripts and contents at one website cannot interact with those at another website due to the existence of the Same Origin Policy (SOP).</p>
|
|
<p class="msonormal" id="obs_04_0074__p20430646">OBS allows buckets to store static web resources. The buckets of OBS can serve as website resources if the buckets are properly used (for details, see <a href="obs_04_0071.html">Configuring Static Website Hosting for a Bucket</a>). A website in OBS can respond to requests of another websites only after CORS is properly configured.</p>
|
|
<p class="msonormal" id="obs_04_0074__p49658093">Typical application scenarios are as follows:</p>
|
|
<ul id="obs_04_0074__ul44269653"><li id="obs_04_0074__li39001642">With the support of CORS, you can use JavaScript and HTML5 to construct web applications and directly access the resources in OBS without the need to use proxy servers for transfer.</li><li id="obs_04_0074__li15470458">You can enable the dragging function of HTML 5 to directly upload files to the OBS (with the upload progress displayed) or update the OBS contents using web applications.</li><li id="obs_04_0074__li5016396">Hosts external web pages, style sheets, and HTML 5 applications in different origins. Web fonts or pictures on OBS can be shared by multiple websites.</li></ul>
|
|
<p class="msonormal" id="obs_04_0074__p62882560">To perform this operation, you must have the <strong id="obs_04_0074__b7243652011">PutBucketCORS</strong> permission. By default, only the bucket owner can perform this operation. The bucket owner can grant the permission to other users by configuring the bucket policy or user policy.</p>
|
|
</div>
|
|
<div class="section" id="obs_04_0074__section29072136"><h4 class="sectiontitle">Request Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0074__screen3674947"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
|
|
<span class="normal"> 2</span>
|
|
<span class="normal"> 3</span>
|
|
<span class="normal"> 4</span>
|
|
<span class="normal"> 5</span>
|
|
<span class="normal"> 6</span>
|
|
<span class="normal"> 7</span>
|
|
<span class="normal"> 8</span>
|
|
<span class="normal"> 9</span>
|
|
<span class="normal">10</span>
|
|
<span class="normal">11</span>
|
|
<span class="normal">12</span>
|
|
<span class="normal">13</span>
|
|
<span class="normal">14</span>
|
|
<span class="normal">15</span>
|
|
<span class="normal">16</span>
|
|
<span class="normal">17</span></pre></div></td><td class="code"><div><pre><span></span>PUT<span class="w"> </span>/?cors<span class="w"> </span>HTTP/1.1<span class="w"> </span>
|
|
Host:<span class="w"> </span>bucketname.obs.region.example.com
|
|
Content-Length:<span class="w"> </span>length
|
|
Date:<span class="w"> </span>date
|
|
Authorization:<span class="w"> </span>authorization
|
|
Content-MD5:<span class="w"> </span>MD5
|
|
<span class="cp"><?xml version="1.0" encoding="UTF-8"?></span><span class="w"> </span>
|
|
<span class="nt"><CORSConfiguration></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><CORSRule></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><ID></span>id<span class="nt"></ID></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><AllowedMethod></span>method<span class="nt"></AllowedMethod></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><AllowedOrigin></span>origin<span class="nt"></AllowedOrigin></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><AllowedHeader></span>header<span class="nt"></AllowedHeader></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><MaxAgeSeconds></span>seconds<span class="nt"></MaxAgeSeconds></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><ExposeHeader></span>header<span class="nt"></ExposeHeader></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"></CORSRule></span><span class="w"> </span>
|
|
<span class="nt"></CORSConfiguration></span>
|
|
</pre></div></td></tr></table></div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="obs_04_0074__section60322637"><h4 class="sectiontitle">Request Parameters</h4><p class="msonormal" id="obs_04_0074__p17010680">This request contains no parameters.</p>
|
|
</div>
|
|
<div class="section" id="obs_04_0074__section6032824"><h4 class="sectiontitle">Request Headers</h4><p class="msonormal" id="obs_04_0074__p35687858">This request uses common headers and CORS request headers. For details, see <a href="obs_04_0007.html#obs_04_0007__table25197309">Table 3</a> and <a href="#obs_04_0074__table1028118520383">Table 1</a>.</p>
|
|
|
|
<div class="tablenoborder"><a name="obs_04_0074__table1028118520383"></a><a name="table1028118520383"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0074__table1028118520383" frame="border" border="1" rules="all"><caption><b>Table 1 </b>CORS request headers</caption><thead align="left"><tr id="obs_04_0074__row828118514383"><th align="left" class="cellrowborder" valign="top" width="19.470000000000002%" id="mcps1.3.4.3.2.5.1.1"><p id="obs_04_0074__p142812543816">Header</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="8.15%" id="mcps1.3.4.3.2.5.1.2"><p id="obs_04_0074__p983314461153"><strong id="obs_04_0074__b6236170175916">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="8.84%" id="mcps1.3.4.3.2.5.1.3"><p id="obs_04_0074__p20281855384"><strong id="obs_04_0074__b115105551312">Mandatory (Yes/No)</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="63.54%" id="mcps1.3.4.3.2.5.1.4"><p id="obs_04_0074__p1928110553815"><strong id="obs_04_0074__b4521655181311">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="obs_04_0074__row162815515384"><td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.4.3.2.5.1.1 "><p id="obs_04_0074__p1128117533811">Content-MD5</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.15%" headers="mcps1.3.4.3.2.5.1.2 "><p id="obs_04_0074__p138915011618">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.84%" headers="mcps1.3.4.3.2.5.1.3 "><p id="obs_04_0074__p12819523812">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.54%" headers="mcps1.3.4.3.2.5.1.4 "><p id="obs_04_0074__p195513201711"><strong id="obs_04_0074__b115521022174">Explanation</strong>:</p>
|
|
<p id="obs_04_0074__p928175113812">Base64-encoded 128-bit MD5 digest of the message according to RFC 1864 </p>
|
|
<p id="obs_04_0074__p028110517382">Example: <strong id="obs_04_0074__b135034317596">n58IG6hfM7vqI4K0vnWpog==</strong></p>
|
|
<p id="obs_04_0074__p135526241711"><strong id="obs_04_0074__b1996387306">Restrictions</strong>:</p>
|
|
<p id="obs_04_0074__p59145553417">None</p>
|
|
<p id="obs_04_0074__p175521213171"><strong id="obs_04_0074__b1873731511442">Value range</strong>:</p>
|
|
<p id="obs_04_0074__p411817309610">None</p>
|
|
<p id="obs_04_0074__p65529220172"><strong id="obs_04_0074__b7948201611449">Default value</strong>:</p>
|
|
<p id="obs_04_0074__p11381631667">None</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="obs_04_0074__section54295418"><h4 class="sectiontitle">Request Elements</h4><p class="msonormal" id="obs_04_0074__p33690852">In this request body, you must configure the CORS rules for a bucket in XML format. <a href="#obs_04_0074__table18700125013812">Table 2</a> describes the specific configuration elements.</p>
|
|
|
|
<div class="tablenoborder"><a name="obs_04_0074__table18700125013812"></a><a name="table18700125013812"></a><table cellpadding="4" cellspacing="0" summary="" id="obs_04_0074__table18700125013812" frame="border" border="1" rules="all"><caption><b>Table 2 </b>CORS configuration elements</caption><thead align="left"><tr id="obs_04_0074__row14700750173817"><th align="left" class="cellrowborder" valign="top" width="19.470000000000002%" id="mcps1.3.5.3.2.5.1.1"><p id="obs_04_0074__p1970005003816"><strong id="obs_04_0074__b172131228111419">Element</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="8.16%" id="mcps1.3.5.3.2.5.1.2"><p id="obs_04_0074__p11348959103815"><strong id="obs_04_0074__b14213428191413">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="8.82%" id="mcps1.3.5.3.2.5.1.3"><p id="obs_04_0074__p1570010500384"><strong id="obs_04_0074__b172144281144">Mandatory (Yes/No)</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="63.55%" id="mcps1.3.5.3.2.5.1.4"><p id="obs_04_0074__p5700165023810"><strong id="obs_04_0074__b12214128141410">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="obs_04_0074__row47001350173816"><td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0074__p77001950153817">CORSConfiguration</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0074__p934815591383">Container</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.82%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0074__p1970118506381">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.55%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0074__p16414158161716"><strong id="obs_04_0074__b44141785172">Explanation</strong>:</p>
|
|
<p id="obs_04_0074__p870165019386">Root node of CORSRules.</p>
|
|
<p id="obs_04_0074__p1570117505389">Parent: none</p>
|
|
<p id="obs_04_0074__p3414128101719"><strong id="obs_04_0074__b2036393274420">Restrictions</strong>:</p>
|
|
<p id="obs_04_0074__p1666413423437">The maximum size is 64 KB.</p>
|
|
<p id="obs_04_0074__p15911828712"><strong id="obs_04_0074__b1335173304418">Value range</strong>:</p>
|
|
<p id="obs_04_0074__p179111128710">None</p>
|
|
<p id="obs_04_0074__p191132373"><strong id="obs_04_0074__b172101934104411">Default value</strong>:</p>
|
|
<p id="obs_04_0074__p89112021574">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0074__row87011450133820"><td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0074__p7701195053813">CORSRule</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0074__p3894848141816">Container</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.82%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0074__p470125033819">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.55%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0074__p1582711141713"><strong id="obs_04_0074__b458219114172">Explanation</strong>:</p>
|
|
<p id="obs_04_0074__p94092471085">CORS rules</p>
|
|
<p id="obs_04_0074__p18701175033812">Parent: CORSConfiguration</p>
|
|
<p id="obs_04_0074__p1358261117176"><strong id="obs_04_0074__b1243646857">Restrictions</strong>:</p>
|
|
<p id="obs_04_0074__p6454135011816">CORSConfiguration can contain a maximum of 100 rules.</p>
|
|
<p id="obs_04_0074__p05821745191320"><strong id="obs_04_0074__b523641194414">Value range</strong>:</p>
|
|
<p id="obs_04_0074__p227816401375">None</p>
|
|
<p id="obs_04_0074__p19582245151313"><strong id="obs_04_0074__b688254154411">Default value</strong>:</p>
|
|
<p id="obs_04_0074__p67253381714">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0074__row147012050133812"><td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0074__p14701115018388">ID</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0074__p8791155181817">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.82%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0074__p14701450163814">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.55%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0074__p13350171561719"><strong id="obs_04_0074__b3351174411441">Explanation</strong>:</p>
|
|
<p id="obs_04_0074__p77011250153815">The ID of a CORS rule.</p>
|
|
<p id="obs_04_0074__p117013505380">Parent: CORSRule</p>
|
|
<p id="obs_04_0074__p1235071531715"><strong id="obs_04_0074__b1799812450447">Restrictions</strong>:</p>
|
|
<p id="obs_04_0074__p15259204581410">The ID cannot be longer than 255 characters.</p>
|
|
<p id="obs_04_0074__p458318319717"><strong id="obs_04_0074__b17771448194411">Value range</strong>:</p>
|
|
<p id="obs_04_0074__p958314311076">A string of 1 to 255 characters.</p>
|
|
<p id="obs_04_0074__p558319319710"><strong id="obs_04_0074__b38721448124410">Default value</strong>:</p>
|
|
<p id="obs_04_0074__p45831131278">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0074__row1701105017383"><td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0074__p13701185010380">AllowedMethod</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0074__p12471175731815">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.82%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0074__p170175013388">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.55%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0074__en-us_topic_0262515644_p37088025164647"><strong id="obs_04_0074__b133291651114418">Explanation</strong>:</p>
|
|
<p id="obs_04_0074__p12319302811">The allowed HTTP methods (types of operations on buckets and objects) for a cross-origin request.</p>
|
|
<p id="obs_04_0074__p168621565218">Parent: CORSRule</p>
|
|
<p id="obs_04_0074__p23031417111717"><strong id="obs_04_0074__b16873125318444">Restrictions</strong>:</p>
|
|
<p id="obs_04_0074__p7488104184">None</p>
|
|
<p id="obs_04_0074__en-us_topic_0262515644_p1470012223452"><strong id="obs_04_0074__en-us_topic_0262515644_b2070072264511">Value range</strong>:</p>
|
|
<p id="obs_04_0074__en-us_topic_0262515644_p1453517573317">The following HTTP methods are supported:</p>
|
|
<ul id="obs_04_0074__en-us_topic_0262515644_ul1862243913291"><li id="obs_04_0074__en-us_topic_0262515644_li762243952910">GET</li><li id="obs_04_0074__en-us_topic_0262515644_li6213144119299">PUT</li><li id="obs_04_0074__en-us_topic_0262515644_li17251244102913">HEAD</li><li id="obs_04_0074__en-us_topic_0262515644_li5945470299">POST</li><li id="obs_04_0074__en-us_topic_0262515644_li126515814296">DELETE</li></ul>
|
|
<p id="obs_04_0074__en-us_topic_0262515644_p177001222124518"><strong id="obs_04_0074__b1983901900">Default value</strong>:</p>
|
|
<p id="obs_04_0074__p1857312613819">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0074__row4701185073814"><td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0074__p2070135073815">AllowedOrigin</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0074__p235013261914">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.82%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0074__p1970116502382">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.55%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0074__p780414367814"><strong id="obs_04_0074__b1376382124513">Explanation</strong>:</p>
|
|
<p id="obs_04_0074__p12804936381">The origin that is allowed to access the bucket.</p>
|
|
<p id="obs_04_0074__p272974810507">Parent: CORSRule</p>
|
|
<p id="obs_04_0074__p1080483613814"><strong id="obs_04_0074__b91254454517">Restrictions</strong>:</p>
|
|
<p id="obs_04_0074__p38041436288">Only English domain names are supported. Regular expressions are used to match. Each rule allows at most one asterisk (*). For example, <strong id="obs_04_0074__b20091531102417">https://*.vbs.example.com</strong>.</p>
|
|
<p id="obs_04_0074__p1480419361887"><strong id="obs_04_0074__b20592125104510">Value range</strong>:</p>
|
|
<p id="obs_04_0074__p68046361885">The value must comply with the CORS protocol and contain 0 to 20480 characters.</p>
|
|
<p id="obs_04_0074__p68041936986"><strong id="obs_04_0074__b980017619453">Default value</strong>:</p>
|
|
<p id="obs_04_0074__p68043361785">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0074__row12701950153812"><td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0074__p370145020381">AllowedHeader</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0074__p564781119191">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.82%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0074__p17701145073819">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.55%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0074__en-us_topic_0262515644_p817828104512"><strong id="obs_04_0074__en-us_topic_0262515644_b101702824511">Explanation</strong>:</p>
|
|
<p id="obs_04_0074__en-us_topic_0262515644_p713723514208">What headers are allowed in a CORS request. If a CORS request contains the <strong id="obs_04_0074__b572810247182">Access-Control-Request-Headers</strong> header, the headers listed in this header must match the headers in the <strong id="obs_04_0074__b8911121182119">AllowedHeader</strong> element so that the request can be considered valid. The matching is based on regular expressions.</p>
|
|
<p id="obs_04_0074__p96311957132516">Parent: CORSRule</p>
|
|
<p id="obs_04_0074__en-us_topic_0262515644_p181712824516"><strong id="obs_04_0074__b2059800310">Restrictions</strong>:</p>
|
|
<p id="obs_04_0074__en-us_topic_0262515644_p147671948182016">At most one asterisk (*) is allowed. Spaces, ampersands (&), colons (:), less-than signs (<), and full-width characters are not allowed.</p>
|
|
<p id="obs_04_0074__p1238181415269"><strong id="obs_04_0074__b123744132451">Value range</strong>:</p>
|
|
<p id="obs_04_0074__p1246312531285">The value must comply with the CORS protocol and contain 0 to 20480 characters.</p>
|
|
<p id="obs_04_0074__en-us_topic_0262515644_p2181228104515"><strong id="obs_04_0074__b1318630430">Default value</strong>:</p>
|
|
<p id="obs_04_0074__en-us_topic_0262515644_p791893316215">None</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0074__row157011050203820"><td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0074__p570175033817">MaxAgeSeconds</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0074__p19349155913387">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.82%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0074__p157011250113817">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.55%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0074__en-us_topic_0262515644_p82586308452"><strong id="obs_04_0074__en-us_topic_0262515644_b725853019451">Explanation</strong>:</p>
|
|
<p id="obs_04_0074__en-us_topic_0262515644_p1527416298228">How long the response can be cached on a client</p>
|
|
<p id="obs_04_0074__p107179545282">Parent: CORSRule</p>
|
|
<p id="obs_04_0074__p1716811301194"><strong id="obs_04_0074__b196511818164513">Restrictions</strong>:</p>
|
|
<p id="obs_04_0074__p151682030295">Each CORS rule can contain at most one <strong id="obs_04_0074__b168612620279">MaxAgeSeconds</strong>.</p>
|
|
<p id="obs_04_0074__p121684301098"><strong id="obs_04_0074__b1416813301910">Value range</strong>:</p>
|
|
<p id="obs_04_0074__p016863020916">An integer greater than or equal to 0, in seconds</p>
|
|
<p id="obs_04_0074__p161681130398"><strong id="obs_04_0074__b15461820154512">Default value</strong>:</p>
|
|
<p id="obs_04_0074__p716814309910">3000</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="obs_04_0074__row177019501389"><td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.3.5.3.2.5.1.1 "><p id="obs_04_0074__p37011150133815">ExposeHeader</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.16%" headers="mcps1.3.5.3.2.5.1.2 "><p id="obs_04_0074__p1222414246197">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.82%" headers="mcps1.3.5.3.2.5.1.3 "><p id="obs_04_0074__p1970135083815">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="63.55%" headers="mcps1.3.5.3.2.5.1.4 "><p id="obs_04_0074__p139661447991"><strong id="obs_04_0074__b1816232364519">Explanation</strong>:</p>
|
|
<p id="obs_04_0074__p1096716471098">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_0074__b1355216170273">Content-Length</strong> and <strong id="obs_04_0074__b1855331722712">Content-Type</strong>. If the browser needs to access other headers, you need to configure them in this parameter.</p>
|
|
<p id="obs_04_0074__p209671447198">Parent: CORSRule</p>
|
|
<p id="obs_04_0074__p129678471092"><strong id="obs_04_0074__b0760122616456">Restrictions</strong>:</p>
|
|
<p id="obs_04_0074__p1496717473920">Spaces, asterisks (*), ampersands (&), colons (:), less-than signs (<), and full-width characters are not allowed.</p>
|
|
<p id="obs_04_0074__p0967247792"><strong id="obs_04_0074__b1954012784516">Value range</strong>:</p>
|
|
<p id="obs_04_0074__p1967134717916">The value that complies with the CORS</p>
|
|
<p id="obs_04_0074__p169674471091"><strong id="obs_04_0074__b1621942710">Default value</strong>:</p>
|
|
<p id="obs_04_0074__p296724714916">None</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="obs_04_0074__section18896716"><h4 class="sectiontitle">Response Syntax</h4><div class="codecoloring" codetype="Xml" id="obs_04_0074__screen50474433"><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>HTTP/1.1<span class="w"> </span>status_code
|
|
|
|
Date:<span class="w"> </span>date
|
|
Content-Length:<span class="w"> </span>length
|
|
</pre></div></td></tr></table></div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="obs_04_0074__section35852719"><h4 class="sectiontitle">Response Headers</h4><p class="msonormal" id="obs_04_0074__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>
|
|
</div>
|
|
<div class="section" id="obs_04_0074__section54239021"><h4 class="sectiontitle">Response Elements</h4><p class="msonormal" id="obs_04_0074__p1126282">This response contains no elements.</p>
|
|
</div>
|
|
<div class="section" id="obs_04_0074__section18389141"><h4 class="sectiontitle">Error Responses</h4><p class="msonormal" id="obs_04_0074__p24120021">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_0074__section14482163815396"><h4 class="sectiontitle">Sample Request</h4><div class="codecoloring" codetype="Xml" id="obs_04_0074__screen8484163863919"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
|
|
<span class="normal"> 2</span>
|
|
<span class="normal"> 3</span>
|
|
<span class="normal"> 4</span>
|
|
<span class="normal"> 5</span>
|
|
<span class="normal"> 6</span>
|
|
<span class="normal"> 7</span>
|
|
<span class="normal"> 8</span>
|
|
<span class="normal"> 9</span>
|
|
<span class="normal">10</span>
|
|
<span class="normal">11</span>
|
|
<span class="normal">12</span>
|
|
<span class="normal">13</span>
|
|
<span class="normal">14</span>
|
|
<span class="normal">15</span>
|
|
<span class="normal">16</span>
|
|
<span class="normal">17</span>
|
|
<span class="normal">18</span>
|
|
<span class="normal">19</span>
|
|
<span class="normal">20</span>
|
|
<span class="normal">21</span>
|
|
<span class="normal">22</span>
|
|
<span class="normal">23</span>
|
|
<span class="normal">24</span>
|
|
<span class="normal">25</span></pre></div></td><td class="code"><div><pre><span></span>PUT<span class="w"> </span>/?cors<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>03:51:52<span class="w"> </span>GMT
|
|
Authorization:<span class="w"> </span>OBS<span class="w"> </span>H4IPJX0TQTHTHEBQQCEC:lq7BGoqE9yyhdEwE6KojJ7ysVxU=
|
|
Content-MD5:<span class="w"> </span>NGLzvw81f/A2C9PiGO0aZQ==
|
|
Content-Length:<span class="w"> </span>617
|
|
|
|
<span class="cp"><?xml version="1.0" encoding="utf-8"?></span>
|
|
<span class="nt"><CORSConfiguration></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><CORSRule></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><AllowedMethod></span>POST<span class="nt"></AllowedMethod></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><AllowedMethod></span>GET<span class="nt"></AllowedMethod></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><AllowedMethod></span>HEAD<span class="nt"></AllowedMethod></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><AllowedMethod></span>PUT<span class="nt"></AllowedMethod></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><AllowedMethod></span>DELETE<span class="nt"></AllowedMethod></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><AllowedOrigin></span>www.example.com<span class="nt"></AllowedOrigin></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><AllowedHeader></span>AllowedHeader_1<span class="nt"></AllowedHeader></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><AllowedHeader></span>AllowedHeader_2<span class="nt"></AllowedHeader></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><MaxAgeSeconds></span>100<span class="nt"></MaxAgeSeconds></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><ExposeHeader></span>ExposeHeader_1<span class="nt"></ExposeHeader></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"><ExposeHeader></span>ExposeHeader_2<span class="nt"></ExposeHeader></span><span class="w"> </span>
|
|
<span class="w"> </span><span class="nt"></CORSRule></span>
|
|
<span class="nt"></CORSConfiguration></span>
|
|
</pre></div></td></tr></table></div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="obs_04_0074__section76081155815"><h4 class="sectiontitle">Sample Response</h4><div class="codecoloring" codetype="Xml" id="obs_04_0074__screen8485113814"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
|
|
<span class="normal">2</span>
|
|
<span class="normal">3</span>
|
|
<span class="normal">4</span>
|
|
<span class="normal">5</span>
|
|
<span class="normal">6</span>
|
|
<span class="normal">7</span></pre></div></td><td class="code"><div><pre><span></span>HTTP/1.1<span class="w"> </span>100<span class="w"> </span>Continue
|
|
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>BF26000001643627112BD03512FC94A4
|
|
x-obs-id-2:<span class="w"> </span>32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSYi6wLC4bkrvuS9sqnlRjxK2a5Fe3ry
|
|
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>03:51:52<span class="w"> </span>GMT
|
|
Content-Length:<span class="w"> </span>0
|
|
</pre></div></td></tr></table></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="obs_04_0070.html">Static Website Hosting</a></div>
|
|
</div>
|
|
</div>
|
|
|