全部产品
对象存储 OSS

GetBucketWebsite

更新时间:2017-06-07 13:26:11   分享:   

Get Bucket Website操作用于查看bucket的静态网站托管状态。

请求语法

GET /?website HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

响应元素(Response Elements)

名称 描述
ErrorDocument 子元素Key的父元素
类型: 容器
父元素: WebsiteConfiguration
IndexDocument 子元素Suffix的父元素.
类型: 容器
父元素: WebsiteConfiguration
Key 返回404错误时使用的文件名
类型:字符串 父元素: WebsiteConfiguration.ErrorDocument
有条件:当ErrorDocument设置时,必需
Suffix 返回目录URL时添加的索引文件名,不要为空,也不要包含"/"。例如索引文件设置为index.html,则访问:oss-cn-hangzhou.aliyuncs.com/mybucket/mydir/这样请求的时候默认都相当于访问oss-cn-hangzhou.aliyuncs.com/mybucket/index.html
类型:字符串
父元素: WebsiteConfiguration.IndexDocument
WebsiteConfiguration 请求的容器
类型:容器
父元素: 无

细节分析

  1. 如果Bucket不存在,返回404 no content错误。错误码:NoSuchBucket。
  2. 只有Bucket的拥有者才能查看Bucket的静态网站托管状态,否则返回403 Forbidden错误,错误码:AccessDenied。
  3. 如果源Bucket未设置静态网站托管功能,OSS会返回404错误,错误码为:NoSuchWebsiteConfiguration。

示例

请求示例:

    Get /?website HTTP/1.1
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com  
    Date: Thu, 13 Sep 2012 07:51:28 GMT
    Authorization: OSS qn6qrrqxo2oawuk53otfjbyc: BuG4rRK+zNhH1AcF51NNHD39zXw=

已设置LOG规则的返回示例:

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906008B
Date: Thu, 13 Sep 2012 07:51:28 GMT
Connection: keep-alive
Content-Length: 218  
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<WebsiteConfiguration xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”>
<IndexDocument>
<Suffix>index.html</Suffix>
    </IndexDocument>
    <ErrorDocument>
        <Key>error.html</Key>
    </ErrorDocument>
</WebsiteConfiguration>

未设置LOG规则的返回示例

HTTP/1.1 404 
x-oss-request-id: 534B371674E88A4D8906008B
Date: Thu, 13 Sep 2012 07:56:46 GMT
Connection: keep-alive
Content-Length: 308  
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<Error xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”>
    <Code>NoSuchWebsiteConfiguration</Code>
    <Message>The specified bucket does not have a website configuration.</Message>
    <BucketName>oss-example</BucketName>
    <RequestId>505191BEC4689A033D00236F</RequestId>
    <HostId>oss-example.oss-cn-hangzhou.aliyuncs.com</HostId>
</Error>
本文导读目录
本文导读目录
以上内容是否对您有帮助?