设置桶的自定义域名配置
此 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 | ... |