## **功能描述** 您可以通过 PutBucketCustomDomain 为存储桶（Bucket）绑定自定义域名，绑定后您可以通过该域名访问存储桶内资源。 ## 注意事项 * 调用此接口您必须为桶所有者，或被授权当前桶的 PutBucketCustomDomain 权限。 * 最多支持设置 20 条域名。 * 绑定自定义域名后，您需要为您的域名添加 DNS 解析，将 CNAME 指定为存储桶的外网访问域名，自定义域名才能生效。 ## **请求消息样式** ```JSON 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" } } ``` ## **请求参数和消息头** 该请求使用的公共请求消息头，请参见[公共参数](/docs/6349/75044)。 |**名称** |**位置** |**参数类型** |**是否必选** |**示例值** |**说明** | |---|---|---|---|---|---| |customdomain |Query |String |是 |\- | `PutBucketCustomDomain`请求的特殊标识。 | ## **请求元素** |**名称** |**参数类型** |**是否必选** |**示例值** |说明 | |---|---|---|---|---| |CustomDomainRule |Container |是 |\- |设置自定义域名信息。 | |Domain | String |是 |example.com |需要绑定的自定义域名。|\ | | | | |父节点：`CustomDomainRule` | |CertId | String |否 |cert\-9228928537e540f9a6a2fc844672\*\*\*\* |证书 ID。|\ | | | | |父节点：`CustomDomainRule` | |Protocol | String |否 |tos |自定义域名的访问协议，取值说明如下：|\ | | | | ||\ | | | | |* `tos`（默认值）：TOS 协议。|\ | | | | |* `s3`：S3 协议。 | ## 响应消息头该请求返回的公共响应消息头，请参见[公共参数](/docs/6349/75044)。 ## **响应元素** 该请求响应中无消息元素。 ## **请求示例 1** ```JSON 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** ```JSON 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** ```JSON 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** ```JSON 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 ```

对象存储