此操作用来获得指定Bucket的website。只有根用户和拥有GET Bucket Website权限的子用户才能执行此操作,否则会返回403 AccessDenied错误。
请求语法
GET /?website HTTP/1.1
Host: BucketName.oos-cn.ctyunapi.cn
Date: date
Authorization: SignatureValue
请求参数
名称 | 描述 | 是否必须 |
---|---|---|
BucketName | 存储桶名称。 | 是 |
响应结果
名称 | 描述 |
---|---|
WebsiteConfiguration | 响应的容器。 类型:容器。 子节点:IndexDocument、ErrorDocument、RoutingRules 或 RedirectAllRequestsTo。 |
IndexDocument | Suffix元素的容器。 类型:容器。 父节点:WebsiteConfiguration。 子节点:Suffix。 |
Suffix | 在请求website endpoint时,Suffix会被加在请求的后面。 类型:字符串。 父节点:IndexDocument。 |
ErrorDocument | Key的容器。 类型:容器。 父节点:WebsiteConfiguration。 子节点:Key。 |
Key | 如果出现 4XX 错误,返回的Object。 类型:字符串。 父节点:ErrorDocument。 |
RoutingRules | 托管模式配置到当前Bucket的重定向规则容器。 类型:容器。 父节点:WebsiteConfiguration。 子节点:RoutingRule。 |
RoutingRule | 具体重定向规则的容器。 父节点:RoutingRules。 子节点:Condition、Redirect。 |
Condition | 描述重定向规则匹配的条件的容器。 类型:容器。 父节点:RoutingRule。 子节点:HttpErrorCodeReturnedEquals、KeyPrefixEquals。 |
HttpErrorCodeReturnedEquals | Redirect生效时的HTTP错误码。 类型:字符串。 父节点:Condition。 |
KeyPrefixEquals | 重定向规则生效时的文件名的前缀。 类型:字符串。 父节点:Condition。 |
Redirect | 重定信息容器。 类型:容器。 父节点:RoutingRule。 子节点:Protocol、HostName、ReplaceKeyPrefixWith、ReplaceKeyWith。 |
Protocol | 描述重定向请求时使用的协议。 类型:字符串。 父节点:Redirect或者RedirectAllRequestsTo。 |
HostName | 重定向请求时使用的站点名。 类型:字符串。 父节点:Redirect或者RedirectAllRequestsTo。 |
ReplaceKeyPrefixWith | 重定向请求时使用的文件名前缀。 类型:字符串。 父节点:Redirect。 |
ReplaceKeyWith | 重定向请求时使用的文件名。 类型:字符串。 父节点:Redirect。 |
RedirectAllRequestsTo | 托管模式为重定向请求的容器。 父节点:WebsiteConfiguration。 子节点:HostName、Protocol。 |
请求示例
GET /?website HTTP/1.1
x-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
x-amz-date: 20220718T091530Z
Host: example-bucket.oos-cn.ctyunapi.cn
Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
Connection: keep-alive
Authorization: SignatureValue
响应示例
HTTP/1.1 200 OK
Content-Type: application/xml;charset=UTF-8
Date: Mon, 18 Jul 2022 09:15:30 GMT
x-amz-request-id: 88d52b33bef4440b3a867d8e9491947396a0828487828b9778
Content-Length: 430
Server: CTYUN
<?xml version="1.0" encoding="UTF-8"?>
<WebsiteConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<IndexDocument>
<Suffix>index.html</Suffix>
</IndexDocument>
<ErrorDocument>
<Key>error.html</Key>
</ErrorDocument>
<RoutingRules>
<RoutingRule>
<Condition>
<KeyPrefixEquals>images/</KeyPrefixEquals>
</Condition>
<Redirect>
<ReplaceKeyWith>errorpage.html</ReplaceKeyWith>
</Redirect>
</RoutingRule>
</RoutingRules>
</WebsiteConfiguration>