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

PutBucketWebsite__关于Bucket的操作_API 参考_对象存储 OSS-阿里云

请求语法

请求元素（Request Elements）

细节分析

示例

上一篇： PutBucketLogging__关于Bucket的操作_API 参考_对象存储 OSS-阿里云

下一篇： PutBucketReferer__关于Bucket的操作_API 参考_对象存储 OSS-阿里云

相关内容

热门内容

最新内容