我们已经准备好了,你呢?

2023我们与您携手共赢,为您的企业形象保驾护航!


喜讯:国内、香港、海外云服务器租用特惠活动,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

 

<WebsiteConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
      <IndexDocument>

             <Suffix>index.html</Suffix>

      </IndexDocument>

      <ErrorDocument>

             <Key>errorDocument.html</Key>

       </ErrorDocument>

       <RoutingRules>

             <RoutingRule>

                  <Condition>

                    <HttpErrorCodeReturnedEquals>string</HttpErrorCodeReturnedEquals>

<KeyPrefixEquals>string</KeyPrefixEquals>

                  </Condition

                  <Redirect>

                     <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

 

<WebsiteConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

       <RedirectAllRequestsTo>

              <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

推荐:TOP云智能建站优惠活动,仅880元即可搭建一个后台管理五端合一的智能网站(PC网站、手机网站、百度智能小程序、微信小程序、支付宝小程序),独享百度搜索SEO优势资源,让你的网站不仅有颜值有排面,更有排名,可以实实在在为您带来效益,请点击进入TOP云智能建站>>>,或咨询在线客服了解详情。



我们已经准备好了,你呢?

2023我们与您携手共赢,为您的企业形象保驾护航!

在线客服
联系方式

热线电话

131-3501-0006

上班时间

周一到周五

公司电话

130-0743-9476

二维码
线