文档中心

对象存储

请输入

自定义域名

PutBucketCustomDomain

功能描述

您可以通过 PutBucketCustomDomain 为存储桶（Bucket）绑定自定义域名，绑定后您可以通过该域名访问存储桶内资源。

注意事项

调用此接口您必须为桶所有者，或被授权当前桶的 PutBucketCustomDomain 权限。

最多支持设置 20 条域名。

绑定自定义域名后，您需要为您的域名添加 DNS 解析，将 CNAME 指定为存储桶的外网访问域名，自定义域名才能生效。

请求消息样式

PUT /?customdomain HTTP/1.1​
Host: bucketname.tos-cn-beijing.volces.com​
Date: Fri, 30 Jul 2021 08:05:36 +0000​
Authorization: authorization string​
Content-Length: 89​
{​
   "CustomDomainRule": {​
      "Domain": "example.com",​
      "CertId": "certID"​
   }​
}​

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
customdomain	Query	String	是	-	PutBucketCustomDomain请求的特殊标识。

请求元素

名称	参数类型	是否必选	示例值	说明
CustomDomainRule	Container	是	-	设置自定义域名信息。
Domain	String	是	example.com	需要绑定的自定义域名。父节点：CustomDomainRule
CertId	String	否	cert-9228928537e540f9a6a2fc844672****	证书 ID。父节点：CustomDomainRule
Protocol	String	否	tos	自定义域名的访问协议，取值说明如下： tos（默认值）：TOS 协议。 s3：S3 协议。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

该请求响应中无消息元素。

请求示例 1

PUT /?customdomain HTTP/1.1​
Host: bucketname.tos-cn-beijing.volces.com​
Date: Fri, 30 Jul 2021 08:05:36 +0000​
Authorization: authorization string​
Content-Length: 64​
​
{​
   "CustomDomainRule": {​
      "Domain": "example.com",​
      "Protocol": "tos"​
   }​
}​

响应示例 1

HTTP/1.1 200 OK​
x-tos-id-2: f91b0c03a01300c1-a444ed0        ​
x-tos-request-id: f91b0c03a01300c1-a444ed0            ​
Date: Fri, 30 Jul 2021 06:45:39 GMT​
server: TosServer​

请求示例 2

PUT /?customdomain HTTP/1.1​
Host: bucketname.tos-cn-beijing.volces.com​
Date: Fri, 30 Jul 2021 08:05:36 +0000​
Authorization: authorization string​
Content-Length: 89​
​
{​
   "CustomDomainRule": {​
      "Domain": "example.com",​
      "CertId": "certID"​
   }​
}​

响应示例 2

HTTP/1.1 200 OK​
x-tos-id-2: f91b0c03a01300c1-a444ed0        ​
x-tos-request-id: f91b0c03a01300c1-a444ed0            ​
Date: Fri, 30 Jul 2021 06:45:39 GMT​
server: TosServer​

最近更新时间：2026.04.15 14:10:29

这个页面对您有帮助吗？

有用

无用