跳到主要内容

彩票注册开户网站注册网站 PutBucketWebsite

彩票注册开户网站注册网站 PutBucketWebsite操作可以将一个Bucket设置成静态网站托管模式。

请求语法

PUT /?website HTTP/1.1
Date: GMT Date
Content-Type: application/json
Content-Length:ContentLength
Host: bucketname.cos.cpzckhwz.sbs
Authorization: SignatureValue

{
"IndexDocument":{"Suffix":"index.html"},
"ErrorDocument":{"Key":"errorDocument.html"}
}

请求元素

NameTypeDescription
ErrorDocumentObject子元素Key的父元素
IndexDocumentObject子元素Suffix的父元素
KeyString返回404错误时使用的文件名
SuffixString返回主页URL时添加的索引文件名

细节分析

  1. 所谓静态网站是指所有的网页都由静态内容构成,包括客户端执行的脚本,例如JavaScript;COS不支持涉及到需要服务器端处理的内容,例如PHP,JSP,APS.NET等
  2. 索引文档是指当用户直接访问静态网站根域名时,COS返回的默认索引文档(相当于网站的index.html)。如果你为一个Bucket配置了静态网站托管模式,就必须指定一个索引文档
  3. 错误新世界官方下载地址支持(Error Document Support) 错误文档是指在用户访问该静态网站时,如果遇到404 NOT FOUNT错误,COS返回给用户的错误新世界官方下载地址。通过指定错误新世界官方下载地址,你可以为你的用户提供恰当的出错提示。
  4. 用户将一个Bucket设置成静态网站托管模式时,指定的索引新世界官方下载地址和错误新世界官方下载地址是该Bucket内的对象
  5. 如果用户上传了Content-MD5请求头,COS会计算body的Content-MD5并检查一致性,如果不一致,将返回InvalidDigest错误码
  6. 用户在将一个Bucket设置成静态网站托管模式后,用户想要查看到设置的静态网站托管效果需要访问website域名,如bucketname.cos-website.cpzckhwz.sbs,如访问默认域名cos.cpzckhwz.sbs返回不变,和接口描述一致

举例说明

场景一:用户设置了索引新世界官方下载地址支持为index.html, 错误新世界官方下载地址支持为error.html,且index和error新世界官方下载地址为桶内对象。Bucket为cos-example,Endpoint为cos-cn-suzhou.cpzckhwz.sbs
用户访问http://cos-example.cos-cn-suzhou.cpzckhwz.sbs,返回GetBucket结果
用户访问http://cos-example.cos-cn-suzhou-website.cpzckhwz.sbs,返回index.html
用户访问http://cos-example.cos-cn-suzhou.cpzckhwz.sbs/object,如果object不存在,返回404 NoSuchKey
用户访问http://cos-example.cos-cn-suzhou-website.cpzckhwz.sbs/object,如果object不存在,返回error.html
场景二:用户设置了索引新世界官方下载地址支持为index.html,且上传/dir/index.html为桶内对象。Bucket为cos-example,Endpoint为cos-cn-suzhou.cpzckhwz.sbs
用户访问http://cos-example.cos-cn-suzhou.cpzckhwz.sbs/dir/,返回dir/空目录
用户访问http://cos-example.cos-cn-suzhou-website.cpzckhwz.sbs/dir/,返回上传的index.html内容

注意:URL末尾的斜线。

请求示例

同时设置index和error新世界官方下载地址

请求示例

PUT /?website HTTP/1.1
Host: test-bucket.cos.cpzckhwz.sbs
Content-Length: 209
Date: Fri, 04 May 2012 03:21:12 GMT
Authorization: COS qn6qrrqxo2oawuk53otfjbyc:KU5h8YMUC78M30dXqf3JxrTZHiA=

{
"IndexDocument":{"Suffix":"index.html"},
"ErrorDocument":{"Key":"errorDocument.html"}
}

返回示例

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

只设置index新世界官方下载地址

请求示例

PUT /?website HTTP/1.1
Host: test-bucket.cos.cpzckhwz.sbs
Content-Length: 209
Date: Fri, 04 May 2012 03:21:12 GMT
Authorization: COS qn6qrrqxo2oawuk53otfjbyc:KU5h8YMUC78M30dXqf3JxrTZHiA=

{
"IndexDocument":{"Suffix":"index.html"},
"ErrorDocument":{"Key":" "}
}

返回示例

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