PutBucketCustomDomain--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

PutBucketCustomDomain

最近更新时间：2025.03.25 17:29:51首次发布时间：2023.05.24 16:53:12

功能描述

您可以通过 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