对象存储

产品文档

对象存储

Put Bucket website

描述

指定某个Bucket设置静态网站托管配置,包括网站索引文件、错误页面及重定向规则,仅Bukcet的Owner可操作。

请求

语法


PUT /?website HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Date: <date>
Content-Length: <ContentLength>
Authorization: <authorization string> (see Authenticating Requests (AWS Signature Version4))

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

请求参数

无请求参数

请求Header

无特殊Header

请求元素

您可以将Bucket设置为静态网站托管模式,可指定默认首页、错误返回页及访问发生错误后的重定向地址。

名称 描述 必须
WebsiteConfiguration website信息集合。
Type: Container
Ancestors: None
IndexDocument suffix元素信息集合
Type: Container
Ancestors: WebsiteConfiguration
Suffix 指定索引文件,不得为空且不能包含"/"字符,如index.html。
Type: String
Ancestors: WebsiteConfiguration.IndexDocument
ErrorDocument key元素信息集合
Type: Container
Ancestors: WebsiteConfiguration
Key 当4XX错误发生时,OSS返回的自定义错误页面。
Type: String
Ancestors: WebsiteConfiguration.ErrorDocument
Condition: Required when ErrorDocument is specified.
指定ErrorDocument是必须
RoutingRules RoutingRule元素信息集合。
Type: Container
Ancestors: WebsiteConfiguration
RoutingRule 指定重定向规则。在RoutingRules规则中,至少包含一个RoutingRule规则。
Type: String
Ancestors: WebsiteConfiguration.RoutingRules
Condition 重定向条件信息集合。
Type: Container
Ancestors: WebsiteConfiguration.RoutingRules.RoutingRule
HttpErrorCodeReturnedEquals HTTP错误代码,指定错误码发生时,则进行重定向。范围为400-499,不能
Type: String
Ancestors: WebsiteConfiguration.RoutingRules.RoutingRule.Condition
Redirect 重定向信息的集合。
Type: String
Ancestors: WebsiteConfiguration.RoutingRules.RoutingRule
HostName 重定向请求的Host。Type: String
Ancestors: WebsiteConfiguration.RoutingRules.RoutingRule.Redirect
ReplaceKeyPrefixWith 将替换重定向请求中的 KeyPrefixEquals 值的对象键名称的前缀。
Type: String
Ancestors: WebsiteConfiguration.RoutingRules.RoutingRule.Redirect

响应

响应Header

无特殊响应Header

响应元素

无响应元素

示例

示例1

以下请求将example.com配置为website。请求中将index.html指定为索引页,将SomeErrorDocument.html指定为错误页面。


PUT ?website HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Content-Length: 256
Date: Thu, 27 Jan 2011 12:00:00 GMT
Authorization: <authorization string>

<WebsiteConfiguration xmlns='http://s3.amazonaws.com/doc/2006-03-01/'>
    <IndexDocument>
        <Suffix>index.html</Suffix>
    </IndexDocument>
    <ErrorDocument>
        <Key>SomeErrorDocument.html</Key>
    </ErrorDocument>
</WebsiteConfiguration>

返回示例


HTTP/1.1 200 OK
x-amz-request-id: 80CD4368BD211111
Date: Thu, 27 Jan 2011 00:00:00 GMT
Content-Length: 0
Server: JDCloudOSS

示例2

该请求中指定RoutingRule中HTTP错误码为特定条件,并指定重定向到ec2-11-22-333-44.compute-1.amazonaws.com/reprot-404/ 下。例如,如果请求ExamplePage.html发生404错误时,将会重定向到 report-404/testPage.html。如果无重定向规则,则返回Error.html。


PUT ?website HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Content-Length: 580
Date: Thu, 27 Jan 2011 12:00:00 GMT
Authorization: <authorization string>

<WebsiteConfiguration xmlns='http://s3.amazonaws.com/doc/2006-03-01/'>
  <IndexDocument>
    <Suffix>index.html</Suffix>
  </IndexDocument>
  <ErrorDocument>
    <Key>Error.html</Key>
  </ErrorDocument>

  <RoutingRules>
    <RoutingRule>
    <Condition>
      <HttpErrorCodeReturnedEquals>404</HttpErrorCodeReturnedEquals >
    </Condition>
    <Redirect>
      <HostName>ec2-11-22-333-44.compute-1.amazonaws.com</HostName>
      <ReplaceKeyPrefixWith>report-404/</ReplaceKeyPrefixWith>
    </Redirect>
    </RoutingRule>
  </RoutingRules>
</WebsiteConfiguration>
更新时间:2019-06-26 19:28:22