更新时间：2026-01-15 GMT+08:00

设置桶的自定义域名

功能介绍

OBS使用PUT操作为桶设置自定义域名，设置成功之后，用户访问桶的自定义域名就能访问到桶。请确保自定义域名通过DNS能够正确解析到OBS服务。

请求消息样式

     PUT /?customdomain=domainname HTTP/1.1
User-Agent: curl/7.29.0
Host: bucketname.obs.region.example.com
Accept: */*
Date: date
Authorization: authorization string
Content-Length: 0
 
 
  

请求参数

表1 请求消息参数
参数	是否必选	参数类型	描述
customdomain	是	String	参数解释：桶的自定义域名。约束限制：一个桶最多可以设置30个自定义域名，一个自定义域名只能被一个桶使用。取值范围：长度为0~256的字符串。默认取值：不涉及

请求消息头

表2 请求消息头
消息头名称	参数类型	是否必选	描述
Content-MD5	String	否	参数解释：设置自定义域名证书时，必须要携带此头域，来校验请求消息体内容和发送时是否一致。按照RFC 1864标准计算出消息体的MD5摘要字符串，即消息体128-bit MD5值经过base64编码后得到的字符串。示例：n58IG6hfM7vqI4K0vnWpog== 约束限制：无取值范围：无默认取值：无

其他公共消息头，具体参见表3。

请求消息元素

此请求消息中不使用消息元素。

响应消息样式

     HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: request id
x-obs-id-2:  id
Date: date
Content-Length: 0
 
 
  

响应消息头

该请求的响应消息使用公共消息头，具体请参考表1。

响应消息元素

该请求的响应消息中不带有响应元素。

错误响应消息

无特殊错误，所有错误已经包含在表2中。

请求示例

     PUT /?customdomain=obs.ccc.com HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: Mon, 14 Jan 2019 08:31:36 +0000
Authorization: OBS UDSIAMSTUBTEST000094:u2kJF4kENs6KlIDcAZpAKSKPtnc=
Content-Length: 0
 
 
  

响应示例

     HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 000001697692CC5380E9D272E6D8F830
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSsfu2GXj9gScHhFnrrTPY2cFOEZuvta
Date: Wed, 13 Mar 2019 10:22:05 GMT
Content-Length: 0
 
 
  

父主题： 桶的高级配置