42
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 | 請求的容器 類型:容器 父元素: 無 |
是 |
細節分析
- 所謂靜態網站是指所有的網頁都由靜態內容構成,包括客戶端執行的腳本,例如JavaScript;OSS不支持涉及到需要服務器端處理的內容,例如PHP,JSP,APS.NET等。
- 如果你想使用自己的域名來訪問基於bucket的靜態網站,可以通過域名CNAME來實現。具體配置方法見3.4節:自定義域名綁定。
- 用戶將一個bucket設置成靜態網站托管模式時,必須指定索引頁麵,錯誤頁麵則是可選的。
- 用戶將一個bucket設置成靜態網站托管模式時,指定的索引頁麵和錯誤頁麵是該bucket內的一個object。
- 在將一個bucket設置成靜態網站托管模式後,對靜態網站根域名的匿名訪問,OSS將返回索引頁麵;對靜態網站根域名的簽名訪問,OSS將返回Get Bucket結果。
- 如果用戶上傳了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
上一篇:
PutBucketLogging__關於Bucket的操作_API 參考_對象存儲 OSS-阿裏雲
下一篇:
PutBucketReferer__關於Bucket的操作_API 參考_對象存儲 OSS-阿裏雲
數據源配置__項目管理手冊_用戶操作指南_大數據開發套件-阿裏雲
創建(提交)作業__SDK接口說明_Java版SDK_批量計算-阿裏雲
PutBucketACL__關於Bucket的操作_API 參考_對象存儲 OSS-阿裏雲
開通數加__平台介紹_數加平台介紹-阿裏雲
修改記錄__解析記錄操作_產品使用手冊_雲解析-阿裏雲
雲服務器 ECS 快照回滾規則FAQ
OSS錯誤響應__API 參考_對象存儲 OSS-阿裏雲
什麼是雲服務器 ECS__產品簡介_雲服務器 ECS-阿裏雲
SMTP之nodejs調用示例__SMTP接口說明_郵件推送-阿裏雲
自適應方向__圖片旋轉_圖片處理指南_對象存儲 OSS-阿裏雲
相關內容
常見錯誤說明__附錄_大數據計算服務-阿裏雲
發送短信接口__API使用手冊_短信服務-阿裏雲
接口文檔__Android_安全組件教程_移動安全-阿裏雲
運營商錯誤碼(聯通)__常見問題_短信服務-阿裏雲
設置短信模板__使用手冊_短信服務-阿裏雲
OSS 權限問題及排查__常見錯誤及排除_最佳實踐_對象存儲 OSS-阿裏雲
消息通知__操作指南_批量計算-阿裏雲
設備端快速接入(MQTT)__快速開始_阿裏雲物聯網套件-阿裏雲
查詢API調用流量數據__API管理相關接口_API_API 網關-阿裏雲
使用STS訪問__JavaScript-SDK_SDK 參考_對象存儲 OSS-阿裏雲