Jawei, Li 1a4c1a720a OBS s3api 2.0.38.SP5

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>

2022-11-16 14:51:13 +00:00

6.4 KiB

Raw Permalink Blame History

GET Bucket website

You can use this operation to get the website configuration of a bucket.

Only users granted the s3:GetBucketWebsite 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.

Request Syntax

 GET /?website HTTP/1.1 
 User-Agent: agent
 Host: bucketname.obs.example.com
 Accept: */*
 Date: date 
 Authoirization: authorization

Request Parameters

This request involves no parameters.

Request Headers

This request uses common headers. For details about common request headers, see section Common Request Headers.

Request Elements

This request involves no elements.

Response Syntax

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>

Response Headers

This response uses common headers. For details about common response headers, see section Common Response Headers.

Response Elements

This response contains elements the same as those used by the PUT Bucket website request. For details, see section PUT Bucket website.

Error Responses

This response contains common errors. For details, see Table 1. In addition, this response contains one special error, as described in Table 1.

**Table 1** Special error
Error Code	Description	HTTP Status Code
NoSuchWebsiteConfiguration	Indicates that the website configuration does not exist.	404 Not Found

Sample Request

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=

Sample Response

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>

Parent topic: Operations on Buckets

6.4 KiB Raw Permalink Blame History