forked from docs/doc-exports
Jawei, Li
1a4c1a720a
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com> Co-authored-by: Jawei, Li <lijiawei5@huawei.com> Co-committed-by: Jawei, Li <lijiawei5@huawei.com>
89 lines
6.4 KiB
HTML
89 lines
6.4 KiB
HTML
<a name="EN-US_TOPIC_0125560494"></a><a name="EN-US_TOPIC_0125560494"></a>
|
|
|
|
<h1 class="topictitle1">GET Bucket website</h1>
|
|
<div id="body44589661"><p class="msonormal" id="EN-US_TOPIC_0125560494__p1408093">You can use this operation to get the website configuration of a bucket.</p>
|
|
<p class="msonormal" id="EN-US_TOPIC_0125560494__p12672845">Only users granted the <strong id="EN-US_TOPIC_0125560494__b164631814618">s3:GetBucketWebsite</strong> permission can get the bucket website configuration. By default, only the bucket owner can get the bucket website configuration. The bucket owner can allow other users to get the bucket website configuration by granting them the permission.</p>
|
|
<div class="section" id="EN-US_TOPIC_0125560494__section12563221"><h4 class="sectiontitle">Request Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560494__screen2654321012811"> GET /?website HTTP/1.1
|
|
User-Agent: agent
|
|
Host: bucketname.obs.example.com
|
|
Accept: */*
|
|
Date: date
|
|
Authoirization: authorization</pre>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0125560494__section45960129"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0125560494__p48638545">This request involves no parameters.</p>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0125560494__section10987981"><h4 class="sectiontitle">Request Headers</h4><p id="EN-US_TOPIC_0125560494__p47408069">This request uses common headers. For details about common request headers, see section <a href="en-us_topic_0125560462.html">Common Request Headers</a>.</p>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0125560494__section31782970"><h4 class="sectiontitle">Request Elements</h4><p id="EN-US_TOPIC_0125560494__p61870584">This request involves no elements.</p>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0125560494__section25229732"><h4 class="sectiontitle">Response Syntax</h4><pre class="screen" id="EN-US_TOPIC_0125560494__screen5146608612825">HTTP/1.1 status_code
|
|
Server: Server Name
|
|
x-amz-request-id: request id
|
|
x-amz-id-2: id
|
|
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
|
|
Content-Type: type
|
|
Date: date
|
|
Content-Length: length
|
|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
|
|
<WebsiteConfiguration xmlns="http://obs.example.com/doc/2015-06-30/">
|
|
<RedirectAllRequestsTo>
|
|
<HostName>hostName</HostName>
|
|
</RedirectAllRequestsTo>
|
|
</WebsiteConfiguration></pre>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0125560494__section25741004"><h4 class="sectiontitle">Response Headers</h4><p id="EN-US_TOPIC_0125560494__p25151496">This response uses common headers. For details about common response headers, see section <a href="en-us_topic_0125560484.html">Common Response Headers</a>.</p>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0125560494__section30342446"><h4 class="sectiontitle">Response Elements</h4><p id="EN-US_TOPIC_0125560494__p65381042">This response contains elements the same as those used by the <strong id="EN-US_TOPIC_0125560494__b51558469">PUT Bucket website</strong> request. For details, see section <a href="en-us_topic_0125560321.html">PUT Bucket website</a>.</p>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0125560494__section4646565"><h4 class="sectiontitle">Error Responses</h4><p id="EN-US_TOPIC_0125560494__p15486430">This response contains common errors. For details, see <a href="en-us_topic_0125560440.html#EN-US_TOPIC_0125560440__table30733758">Table 1</a>. In addition, this response contains one special error, as described in <a href="#EN-US_TOPIC_0125560494__table19964345">Table 1</a>.</p>
|
|
|
|
<div class="tablenoborder"><a name="EN-US_TOPIC_0125560494__table19964345"></a><a name="table19964345"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0125560494__table19964345" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Special error</caption><thead align="left"><tr id="EN-US_TOPIC_0125560494__row14081115"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.10.3.2.4.1.1"><p id="EN-US_TOPIC_0125560494__p66828554">Error Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.10.3.2.4.1.2"><p id="EN-US_TOPIC_0125560494__p44403789">Description</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.10.3.2.4.1.3"><p id="EN-US_TOPIC_0125560494__p39937165">HTTP Status Code</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0125560494__row13684913"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.10.3.2.4.1.1 "><p id="EN-US_TOPIC_0125560494__p34736162">NoSuchWebsiteConfiguration</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.10.3.2.4.1.2 "><p id="EN-US_TOPIC_0125560494__p62165703">Indicates that the website configuration does not exist.</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.10.3.2.4.1.3 "><p id="EN-US_TOPIC_0125560494__p2257160">404 Not Found</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0125560494__section34566005"><h4 class="sectiontitle">Sample Request</h4><pre class="screen" id="EN-US_TOPIC_0125560494__screen4208934712846">GET /?website HTTP/1.1
|
|
User-Agent: curl/7.29.0
|
|
Host: bucketname.obs.example.com
|
|
Accept: */*
|
|
Date: Sat, 04 Jan 2014 06:47:16 +0000
|
|
Authorization: AWS C6630CD15B645CB8A3BA:XrepYUF0mA/m1RPvpA0M18FdCfg=</pre>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0125560494__section42658596"><h4 class="sectiontitle">Sample Response</h4><pre class="screen" id="EN-US_TOPIC_0125560494__screen934161212856">HTTP/1.1 200 OK
|
|
Server: OBS
|
|
x-amz-request-id: DCD2FC9CAB78000001435C0176F28223
|
|
x-amz-id-2: 8BSYBZcQKwR5nCgMsLY86TRLwhUZpLbQTxAKIAuMJqx3OURwOMhILeVNwTrEQWyc
|
|
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
|
|
Content-Type: application/xml
|
|
Date: Sat, 04 Jan 2014 06:47:16 GMT
|
|
Content-Length: 230
|
|
|
|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
|
|
<WebsiteConfiguration xmlns="http://obs.example.com/doc/2015-06-30/">
|
|
<RedirectAllRequestsTo>
|
|
<HostName>www.example.com</HostName>
|
|
</RedirectAllRequestsTo>
|
|
</WebsiteConfiguration></pre>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0125560493.html">Operations on Buckets</a></div>
|
|
</div>
|
|
</div>
|
|
|