文档简介:
PUT Bucket WebSite
在PUT操作的url中加上website,可以设置website配置。如果Bucket已经存在了website,此操作会替换原有website。只有根用户和拥有PUT Bucket WebSite权限的子用户才能执行此操作,否则会返回403 AccessDenied错误。
WebSite功能可以让用户将静态网站存放到OOS上。对于已经设置了WebSite的Bucket,当用户访问/em>.oos-website-cn.oos-cn.ctyunapi.cn时,会跳转到用户指定的主页,当出现4XX错误时,会跳转到用户指定的出错页面。
如果想通过自有域名的形式(例如/em>.com/login.html)而非通过第三方域名的形式(例如/em>.com.oos-cn.ctyunapi.cn/login.html)访问,可以创建一个名为“yourdomain.com”的bucket,并在域名管理系统中将“yourdomain.com”增加一个别名记录“oos-cn.ctyunapi.cn”。
请求语法
PUT /?website HTTP/1.1 Host: BucketName.oos-cn.ctyunapi.cn Date: date Content-Length: ContentLength Authorization: signatureValue
<WebsiteConfiguration xmlns="/doc/2006-03-01/"> <IndexDocument> <Suffix>index.html</Suffix> </IndexDocument> <ErrorDocument> <Key>errorDocument.html</Key> </ErrorDocument> </WebsiteConfiguration> |
请求元素
名称 |
描述 |
是否必须 |
WebsiteConfiguration |
请求的容器。 |
是 |
IndexDocument |
Suffix元素的容器。 |
是 |
Suffix |
在请求website endpoint 上的路径时,Suffix会被加在请求的后面。例如,如果suffix是Index.html,而你请求的是bucket/images/,那么返回的响应是名为images/index.html的Object。 |
是 |
ErrorDocument |
Key的容器。 |
否 |
Key |
如果出现4XX错误,会返回指定的Object。 |
否 |
请求示例
PUT /?website HTTP/1.1 Host: doc.oos-cn.ctyunapi.cn Date: Mon, 03Sep 2012 12:00:00 GMT Authorization: AWS 7799e793ce4624ee7e5a:xQE0diMbLRepdf3YB+FIEXAMPLE=
<WebsiteConfiguration xmlns='/doc/2006-03-01/'> <IndexDocument> <Suffix>index.html</Suffix> </IndexDocument> <ErrorDocument> <Key>404.html</Key> </ErrorDocument> </WebsiteConfiguration> |
返回示例
HTTP/1.1 200OK x-amz-request-id: 32FE2CEB32F5EE25 Date: Mon, 03Sep 2012 12:00:00 GMT Connection: close Server: CTYUN |