閱讀42 返回首頁    go windows


PutBucketWebsite__關於Bucket的操作_API 參考_對象存儲 OSS-阿裏雲

Put Bucket Website操作可以將一個bucket設置成靜態網站托管模式。

請求語法

PUT /?website HTTP/1.1
Date: GMT Date
Content-Length:ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

<?xml version="1.0" encoding="UTF-8"?>
<WebsiteConfiguration>
    <IndexDocument>
        <Suffix>index.html</Suffix>
    </IndexDocument>
    <ErrorDocument>
        <Key>errorDocument.html</Key>
    </ErrorDocument>
</WebsiteConfiguration>

請求元素(Request 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. 所謂靜態網站是指所有的網頁都由靜態內容構成,包括客戶端執行的腳本,例如JavaScript;OSS不支持涉及到需要服務器端處理的內容,例如PHP,JSP,APS.NET等。
  2. 如果你想使用自己的域名來訪問基於bucket的靜態網站,可以通過域名CNAME來實現。具體配置方法見3.4節:自定義域名綁定。
  3. 用戶將一個bucket設置成靜態網站托管模式時,必須指定索引頁麵,錯誤頁麵則是可選的。
  4. 用戶將一個bucket設置成靜態網站托管模式時,指定的索引頁麵和錯誤頁麵是該bucket內的一個object。
  5. 在將一個bucket設置成靜態網站托管模式後,對靜態網站根域名的匿名訪問,OSS將返回索引頁麵;對靜態網站根域名的簽名訪問,OSS將返回Get Bucket結果。
  6. 如果用戶上傳了Content-MD5請求頭,OSS會計算body的Content-MD5並檢查一致性,如果不一致,將返回InvalidDigest錯誤碼。

示例

請求示例:

PUT /?website HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Content-Length: 209
Date: Fri, 04 May 2012 03:21:12 GMT
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:KU5h8YMUC78M30dXqf3JxrTZHiA=

<?xml version="1.0" encoding="UTF-8"?>
<WebsiteConfiguration>
<IndexDocument>
<Suffix>index.html</Suffix>
</IndexDocument>
<ErrorDocument>
<Key>error.html</Key>
</ErrorDocument>
</WebsiteConfiguration>

返回示例:

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906008B
Date: Fri, 04 May 2012 03:21:12 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

最後更新:2016-11-23 17:16:07

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