This API (GET Bucket website) is used to obtain the configuration of the static website associated with the Bucket.
GET /?website HTTP/1.1
Host:<BucketName-APPID>.<Region>.myqcloud.com
Date:date
Authorization: Auth StringAuthorization: Auth String (For more information, see Request Signature).
Common request headers are used for the implementation of this request operation. For more information, see Common Request Headers.
This request operation does not use any special request header.
The request body of this request is empty.
This response uses common response headers. For more information, see Common Response Headers.
This response does not use any special response header.
Application/xml data is returned in the response body. It contains the complete node data, as shown below:
<WebsiteConfiguration>
<IndexDocument>
<Suffix>index.html</Suffix>
</IndexDocument>
<RedirectAllRequestsTo>
<Protocol>https</Protocol>
</RedirectAllRequestsTo>
<ErrorDocument>
<Key>Error.html</Key>
</ErrorDocument>
<RoutingRules>
<RoutingRule>
<Condition>
<HttpErrorCodeReturnedEquals>404</HttpErrorCodeReturnedEquals>
</Condition>
<Redirect>
<Protocol>https</Protocol>
<ReplaceKeyWith>404.html</ReplaceKeyWith>
</Redirect>
</RoutingRule>
<RoutingRule>
<Condition>
<KeyPrefixEquals>docs/</KeyPrefixEquals>
</Condition>
<Redirect>
<Protocol>https</Protocol>
<ReplaceKeyPrefixWith>documents/</ReplaceKeyPrefixWith>
</Redirect>
</RoutingRule>
<RoutingRule>
<Condition>
<KeyPrefixEquals>img/</KeyPrefixEquals>
</Condition>
<Redirect>
<Protocol>https</Protocol>
<ReplaceKeyWith>demo.jpg</ReplaceKeyWith>
</Redirect>
</RoutingRule>
</RoutingRules>
</WebsiteConfiguration>Details are described below:
| Name | Parent Node | Description | Type | Required |
|---|---|---|---|---|
| WebsiteConfiguration | None | Static website configuration, including index document, error document, protocol conversion and routing rules. | Container | Yes |
| IndexDocument | WebsiteConfiguration | Index document | Container | Yes |
| Suffix | IndexDocument | Specifies the index document | String | Yes |
| ErrorDocument | WebsiteConfiguration | Error document | Container | No |
| Key | ErrorDocument | Specifies the common error page returned | String | No |
| RedirectAllRequestsTo | WebsiteConfiguration | Redirects all requests | Container | No |
| Protocol | RedirectAllRequestsTo | Specifies the routing protocol for the entire website. Only HTTP is supported. | String | No |
| RoutingRules | WebsiteConfiguration | Sets routing rules in batch. A maximum of 100 routing rules can be set. | Container | No |
| RoutingRule | RoutingRules | Sets a single routing rule. You can set a routing rule for the requests with a specified path prefix or for the requests for which a specified error code is returned. | Container | No |
| Condition | RoutingRule | Specifies the condition for the redirection. You cannot specify both prefix match routing condition and error code routing condition. | Container | No |
| HttpErrorCodeReturnedEquals | Condition | Specifies the redirection error code. Only 4XX status codes are supported. It has a higher priority than ErrorDocument. | Integer | No |
| KeyPrefixEquals | Condition | Specifies the prefix of the paths to be redirected. | String | No |
| Redirect | RoutingRule | Specifies the replacement rule when the redirection condition is met. | Container | No |
| ReplaceKeyWith | Redirect | Specifies the content which is used to replace the entire Key. | String | No |
| ReplaceKeyPrefixWith | Redirect | Specifies the content which is used to replace the prefix of Key. This is allowed only when Conditon is KeyPrefixEquals. | String | No |
No special error message is returned for this request operation. For common error messages, see Error Codes.
GET /?website HTTP/1.1
Host: examplebucket-1250000000.cos.ap-shanghai.myqcloud.com
Date:Thu, 21 Sep 2017 13:09:53 +0000
Authorization:q-sign-algorithm=sha1&q-ak=AKIDWtTCBYjM5OwLB9CAwA1Qb2ThTSUjfGFO&q-sign-time=1484815944;32557711944&q-key-time=1484815944;32557711944&q-header-list=host&q-url-param-list=website&q-signature=a2d28e1b9023d09f9277982775a4b3b705d0e23eHTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 751
Connection: keep-alive
Date: Thu, 21 Sep 2017 13:15:39 GMT
Server: tencent-cos
x-cos-request-id: NTljM2JiN2FfMjQ4OGY3MGFfNzk4OV84Mg==
<WebsiteConfiguration>
<IndexDocument>
<Suffix>index.html</Suffix>
</IndexDocument>
<RedirectAllRequestsTo>
<Protocol>https</Protocol>
</RedirectAllRequestsTo>
<ErrorDocument>
<Key>Error.html</Key>
</ErrorDocument>
<RoutingRules>
<RoutingRule>
<Condition>
<HttpErrorCodeReturnedEquals>404</HttpErrorCodeReturnedEquals>
</Condition>
<Redirect>
<Protocol>https</Protocol>
<ReplaceKeyWith>404.html</ReplaceKeyWith>
</Redirect>
</RoutingRule>
<RoutingRule>
<Condition>
<KeyPrefixEquals>docs/</KeyPrefixEquals>
</Condition>
<Redirect>
<Protocol>https</Protocol>
<ReplaceKeyPrefixWith>documents/</ReplaceKeyPrefixWith>
</Redirect>
</RoutingRule>
<RoutingRule>
<Condition>
<KeyPrefixEquals>img/</KeyPrefixEquals>
</Condition>
<Redirect>
<Protocol>https</Protocol>
<ReplaceKeyWith>demo.jpg</ReplaceKeyWith>
</Redirect>
</RoutingRule>
</RoutingRules>
</WebsiteConfiguration>
Was this page helpful?