对象存储经典版I型 > 天翼云对象存储（经典版）I型API参考-PUT Bucket Website

天翼云对象存储（经典版）I型API参考-PUT Bucket Website

喜讯：国内、香港、海外云服务器租用特惠活动，2核/4G/10M仅需31元每月，点击抢购>>>

点击这里注册天翼云特邀VIP帐号，立即体验天翼云对象存储>>>

天翼云对象存储（经典版）I型API参考-PUT Bucket Website

此操作用来配置网站托管属性。如果Bucket已经存在了website，此操作会替换原有website。只有根用户和拥有PUT Bucket WebSite权限的子用户才能执行此操作。

注意：

OOS自有网站托管域名不支持HTTPS访问，用户自定义域名支持HTTPS访问。
如果配置静态网站托管后，当匿名用户直接访问Bucket的域名，会将静态网站文件下载到本地。如果您需要实现访问静态网站时，是预览网站内容而非下载静态网站文件，您需要为桶绑定已通过备案的自定义域名，请联系天翼云客服申请绑定自定义域名。
设置Bucket的网络配置请求消息体的上限是10KiB。
尽量避免目标Bucket名中带有“.”，否则通过HTTPS访问时可能出现客户端校验证书出错。

网站托管配置步骤如下：

1) 创建一个只读属性的对象容器（Bucket）。

2) 向天翼云客服提交工单，申请客户自定义域名添加白名单。

3) 在域名管理中添加别名。

如果不使用CDN加速，将Bucket的CNAME Record Value（bucketname.oos-website-cn.oos-xx.ctyunapi.cn）作为别名添加到域名管理系统中。
如果使用CDN加速，将CDN厂商提供的别名添加到域名管理系统中，然后在CDN回源地址中配置OOS侧的CNAME Record Value，并将回源host配置为您的自定义域名（如yourdomain.com）。

说明：创建Bucket时显示的Endpoint为oos-cn.ctyunapi.cn，该Endpoint是针对整个对象存储网络的域名，该域名在解析时，会根据用户地理位置的不同解析到不同的资源池地址。如果创建Bucket时有多个数据域，系统默认选取创建时第一个有效数据位置作为CNAME Record Value（bucketname.oos-website-cn.oos-xx.ctyunapi.cn）。CNAME Record Value可以通过控制台Bucket属性中的网站查看。如果创建Bucket时，只有一个数据域可用，则在Bucket区域中展示的CNAME Record Value为bucketname.oos-website-cn.oos-cn.ctyunapi.cn。所以如果使用静态网站托管，建议您根据Bucket区域属性中的数据位置，选择您想使用的数据位置的CNAME Record Value作为域名管理系统中的别名。例如您创建Bucket时有效数据位置为沈阳、兰州、成都、贵阳，则Bucket中展示的CNAME Record Value为bucketname.oos-website-cn.oos-lnsy.ctyunapi.cn，您可以将bucketname.oos-website-cn.oos-lnsy.ctyunapi.cn作为别名，也可以将兰州、成都或者贵阳为域名的CNAME Record Value作为您的别名。

4) 上传文件

将网站的所有文件（html、CSS、js、图片等）上传到之前创建的Bucket中，注意要保持文件之间的相对路径。

5) 配置Bucket网站属性：可以通过控制台或者调用本接口配置。

请求语法

托管模式为当前容器

PUT /?website HTTP/1.1

Host: BucketName.oos-cn.ctyunapi.cn

Date: date

Content-Length: ContentLength

Authorization: signatureValue

<Suffix>index.html</Suffix>

</IndexDocument>

<Key>errorDocument.html</Key>

</ErrorDocument>

<HttpErrorCodeReturnedEquals>string</HttpErrorCodeReturnedEquals>

<KeyPrefixEquals>string</KeyPrefixEquals>

</Condition

<HostName>string</HostName>

<Protocol>string</Protocol>

<ReplaceKeyPrefixWith>string</ReplaceKeyPrefixWith>

<ReplaceKeyWith>string</ReplaceKeyWith>

</Redirect>

</RoutingRule>

</RoutingRules>

</WebsiteConfiguration>

托管模式为重定向请求

PUT /?website HTTP/1.1

Host: BucketName.oos-cn.ctyunapi.cn

Date: date

Content-Length: ContentLength

Authorization: signatureValue

<HostName>string</HostName>

<Protocol>string</Protocol>

</RedirectAllRequestsTo>

</WebsiteConfiguration>

请求参数

名称	描述	是否必须
WebsiteConfiguration	请求的容器。类型：容器子节点：IndexDocument、ErrorDocument、RoutingRules或RedirectAllRequestsTo	是
IndexDocument	Suffix元素的容器。类型：容器父节点：WebsiteConfiguration 子节点：Suffix	是
Suffix	在请求website endpoint 上的路径时，Suffix会被加在请求的后面。例如，如果suffix是Index.html，而你请求的是bucket/images/，那么返回的响应是名为images/index.html的Object。类型：字符串父节点：IndexDocument	是
ErrorDocument	Key的容器。类型：容器父节点：WebsiteConfiguration 子节点：Key	否
Key	如果出现4XX错误，会返回指定的Object。类型：字符串有效值：长度为1~1024的字符串。父节点：ErrorDocument	是
RoutingRules	托管模式配置到当前容器的重定向规则容器。注意：如果RoutingRules下有多个RoutingRule，各RoutingRule之间无影响，按照配置的先后顺序向下执行，当有一个满足条件时，就不再继续向后匹配。如果都没有匹配，就不使用重定向规则。类型：容器父节点：WebsiteConfiguration 子节点：RoutingRule	否
RoutingRule	重定向规则的容器。一条重定向规则包含一个Condition和一个Redirect，当Condition匹配时，Redirect生效。容器中至少要有一个重定向规则。注意：一个RoutingRule下，出现多个Condition和Redirect时，以最后一个为准。类型：容器父节点：RoutingRules 子节点：Condition、Redirect	是
Condition	描述重定向规则匹配的条件的容器。如果重定向规则匹配的条件未配置，则重定向规则将应用于所有请求。注意：该容器可以不配置，如果配置，则至少应该包含HttpErrorCodeReturnedEquals、KeyPrefixEquals中的一个。类型：容器父节点：RoutingRule 子节点：HttpErrorCodeReturnedEquals、KeyPrefixEquals	否
HttpErrorCodeReturnedEquals	指定Redirect生效时的HTTP错误码。当发生错误时，如果错误码等于这个值，那么Redirect生效。注意：HttpErrorCodeReturnedEquals和KeyPrefixEquals同时存在时，只有都匹配时，Redirect才生效。类型：字符串有效值：[ 400, 417 ]，[ 500, 505]。例如：当返回的http错误码为404时重定向到NotFound.html，可以将Condition中的HttpErrorCodeReturnedEquals设置为404，Redirect中的ReplaceKeyWith设置为NotFound.html。父节点：Condition	否
KeyPrefixEquals	重定向规则生效时的对象名的前缀。注意：HttpErrorCodeReturnedEquals 和KeyPrefixEquals同时存在时，只有都匹配时，Redirect才生效。类型：字符串有效值：长度为0-1024的字符串。父节点：Condition	否
Redirect	重定信息容器。注意：Redirect配置包含的元素可以为空，也可以包含以下元素:Protocol、HostName、ReplaceKeyPrefixWith、ReplaceKeyWith。当某一元素存在多条值时以最后一条为准。类型：容器父节点：RoutingRule 子节点：Protocol、HostName、ReplaceKeyPrefixWith、ReplaceKeyWith	是
Protocol	重定向请求时使用的协议。类型：字符串有效值：http、https，默认值为http。父节点：Redirect或者RedirectAllRequestsTo	否
HostName	重定向请求时使用的站点名。如果父节点为RedirectAllRequestsTo，此项必须填写。类型：字符串有效值：1~1024个字符，不能包含空格。父节点为Redirect，也不能包含斜杠(/)。父节点：Redirect或者RedirectAllRequestsTo	否
ReplaceKeyPrefixWith	重定向请求时使用的对象名前缀。注意：ReplaceKeyPrefixWith与ReplaceKeyWith不能同时存在。类型：字符串有效值：0~1024个字符。父节点：Redirect	否
ReplaceKeyWith	指定重定向请求时使用的对象名。注意：ReplaceKeyPrefixWith与ReplaceKeyWith不能同时存在。类型：字符串有效值：0~1024个字符。父节点：Redirect	否
RedirectAllRequestsTo	托管模式为重定向请求的容器。父节点：WebsiteConfiguration 子节点：HostName、Protocol	否

火山引擎文档

天翼云文档

百度智能云文档

腾讯云文档

阿里云文档

华为云文档

帐号服务

云计算

云安全

企业服务

备案服务

请求语法

请求参数

TOP云产品

解决方案

帮助与支持

其他链接

快速通道

关于 TOP云