閱讀715 返回首頁    go 微信


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 請求的容器
類型:容器
父元素: 無

細節分析

  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=”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

  上一篇:go GetBucketLogging__關於Bucket的操作_API 參考_對象存儲 OSS-阿裏雲
  下一篇:go GetBucketReferer__關於Bucket的操作_API 參考_對象存儲 OSS-阿裏雲