设置桶的自定义域名配置

此 PUT 操作用于设置桶的自定义域名配置。OSS支持将自定义域名和桶域名绑定,也支持将自定义域名和桶的静态网站域名绑定。如果将自定义域名和桶域名绑定,则访问自定义域名相当于访问桶域名,如果将自定义域名和桶的静态网站域名绑定,则访问自定义域名相当于访问桶的静态网站。必须保证自定义域名通过DNS能正确解析到OSS服务。

请求

  • 请求语法

    • 内容

        PUT /bucketname/?domain HTTP/1.1
        Host: {Endpoint}
        Content-Length: {length}
        Date: {date}
        Authorization: {SignatureValue} 
        Content-Type: application/json
      
        [ 
            { "domainName": "www.example.com",
              "isWebsite": true
            },
            { "domainName": "www.example2.com",
              "isWebsite": false
            },
            { "domainName": "www.example3.com",
              "isWebsite": true
            }
        ]    
      
    • 描述

        Endpoint:参考与region地域的关系
        SignatureValue:参考签名算法
      
  • 请求参数

  • 非公共请求头

  • 请求体

名称 类型 是否必须 描述
domainName 字符串 需要绑定的自定义域名
isWebsite 字符串 false表示自定义域名和桶域名绑定,true表示和桶的静态网站域名绑定

响应

  • 非公共响应头

  • 响应体

示例

  • 请求

      PUT /oss-example/?domain HTTP/1.1
      Host: oss-example.oss-cn-beijing.inspurcloud.com
      Authorization: authorization string
      Content-Length: {length}
      Content-Type: application/json
      Date: Wed, 29 Oct 2020 22:32:00 GMT    
    
      [ 
          { "domainName": "www.example.com",
            "isWebsite": false
          }
      ]    
    
  • 响应

      HTTP/1.1 200 OK
      Date: Wed, 29 Oct 2020 22:32:00 GMT
      Content-Length: 0
      Content-Type: application/json
      Connection: keep-alive                                                  
    

错误码

错误码 描述 状态码 描述
InvalidDomainConfiguration 一个自定义域名同时与桶域名和桶的静态网站域名绑定 400 ...