## 简介
本文档提供关于自定义域名的 API 概览以及 SDK 示例代码。
| API | 操作名 | 操作描述 |
| ----------------- | -------------- | -------------------------- |
| PUT Bucket domain | 设置自定义域名 | 设置存储桶的自定义域名信息 |
| GET Bucket domain | 查询自定义域名 | 查询存储桶的自定义域名信息 |
## 设置自定义域名
#### 功能说明
PUT Bucket domain 用于为存储桶配置自定义域名。
#### 方法原型
在开始使用 COS 时，需要在指定的账号下先创建一个存储桶以便于对象的使用和管理，并指定存储桶所属的地域。创建存储桶的用户默认成为存储桶的持有者。若创建存储桶时没有指定访问权限，则默认为私有读写（private）权限。具体步骤如下：
1. 实例化 QCloudPutBucketDomainRequest
2. 调用 QCloudCOSXMLService 对象中的 PutBucketDomain 方法发出请求。
3. 从回调的 finishBlock 中的 outputObject 获取具体内容。
#### 请求示例
[//]: # (.cssg-snippet-objc-put-bucket-domain)
```
QCloudPutBucketDomainRequest *req = [QCloudPutBucketDomainRequest new];
req.bucket = @"examplebucket-1250000000";
QCloudDomainConfiguration *config = [QCloudDomainConfiguration new];
QCloudDomainRule *rule = [QCloudDomainRule new];
rule.status = QCloudDomainStatueEnabled;
rule.name = @"www.baidu.com";
rule.replace = QCloudCOSDomainReplaceTypeTxt;
rule.type = QCloudCOSDomainTypeRest;
config.rules = @[rule];
req.domain = config;
[req setFinishBlock:^(id outputObject, NSError *error) {
}];
[[QCloudCOSXMLService defaultCOSXML]PutBucketDomain:req];
```
Swift 代码示例：
[//]: # (.cssg-snippet-swift-put-bucket-domain)
```
let req = QCloudPutBucketDomainRequest.init();
req.bucket = "examplebucket-1250000000";
let config = QCloudDomainConfiguration.init();
let rule = QCloudDomainRule.init();
rule.status = .enabled;
rule.name = "www.baidu.com";
rule.replace = .txt;
rule.type = .rest;
config.rules = [rule];
req.domain = config;
req.finishBlock = {(result,error) in
if error != nil{
print(error!);
}else{
print( result!);
}
}
QCloudCOSXMLService.defaultCOSXML().putBucketDomain(req);
```
#### 参数说明
#### QCloudPutBucketDomainRequest 请求参数说明
| 参数名称 | 描述 | 类型 | 是否必填 |
| -------- | ------------------------------------------------------------ | --------------------------- | -------- |
| bucket |
