设置桶的网站配置

此 PUT 操作用于设置桶的静态网站配置。OSS允许在桶内保存静态的网页资源，如.html网页文件，当客户端通过桶的Website接入点访问这些对象资源时，浏览器可以直接解析出支持的网页资源，呈现给最终用户。典型的应用场景有：

• 重定向所有的请求到另外一个站点。

• 设定特定的重定向规则来重定向特定的请求。

要正确执行此操作，需要确保执行者有PutBucketWebsite权限。默认情况下，只有桶的所有者可以执行此操作，也可以通过设置桶策略或用户策略授权给其他用户。

请求

• 请求语法

  • 内容

      PUT /bucketname/?website HTTP/1.1
      Host: {Endpoint}
      Content-Length: {length}
      Date: {date}
      Authorization: {SignatureValue} 
      Content-Type: application/xml
    
      <?xml version="1.0" encoding="UTF-8"?>
      <WebsiteConfiguration>
          <IndexDocument>
              <Suffix>index.html</Suffix>
          </IndexDocument>
          <ErrorDocument>
              <Key>error.html</Key>
          </ErrorDocument>
      </WebsiteConfiguration>    
    

  • 描述

      Endpoint：参考与region地域的关系
      SignatureValue：参考签名算法
    

• 请求参数

  无

• 非公共请求头

  无

• 请求体

响应

• 非公共响应头

  无

• 响应体

  无

示例

• 请求

    PUT /oss-example/?website HTTP/1.1
    Host: oss-example.oss-cn-beijing.inspurcloud.com
    Authorization: authorization string
    Content-Length: {length}
    Content-Type: application/xml
    Date: Wed, 28 Oct 2020 22:32:00 GMT    
  
    <?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
    Date: Wed, 28 Oct 2020 22:32:00 GMT
    Content-Length: 0
    Content-Type: application/xml
    Connection: keep-alive                                                  
  

错误码