GetBucketWebsite__关于Bucket的操作_API 参考_对象存储 OSS-阿里云

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	请求的容器类型：容器父元素: 无

细节分析

如果Bucket不存在，返回404 no content错误。错误码：NoSuchBucket。
只有Bucket的拥有者才能查看Bucket的静态网站托管状态，否则返回403 Forbidden错误,错误码：AccessDenied。
如果源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=”https://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=”https://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>

最后更新：2016-11-23 17:16:08

GetBucketWebsite__关于Bucket的操作_API 参考_对象存储 OSS-阿里云

请求语法

响应元素(Response Elements)

细节分析

示例

上一篇： GetBucketLogging__关于Bucket的操作_API 参考_对象存储 OSS-阿里云

下一篇： GetBucketReferer__关于Bucket的操作_API 参考_对象存储 OSS-阿里云

相关内容

热门内容

最新内容