# 创建域名解析记录集 - CreateRecordSet
#### 功能介绍
创建域名解析记录集
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ucs/ucs_api_0026.html)。
#### URI
POST /v1/traffic/recordsets
#### 请求参数
表1请求Header参数 
| 参数                | 是否必选 | 参数类型   | 描述                                                              |
|:---|:---|:---|:---|
| X-Auth-Token      | 否    | String | 身份认证信息，调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值 |
| X-Zone-Project-ID | 是    | String | 项目ID                                                            |
| X-Zone-ID         | 是    | String | DNS区域ID                                                         |
| Content-Type      | 是    | String | 消息体的类型（格式），仅支持application/json                                  |
   
表2请求Body参数 
| 参数       | 是否必选 | 参数类型                                                                                                | 描述 |
|:---|:---|:---|:---|
| \[数组元素\] | 是    | Array of [CreateRecordSetRequestBody] objects | -  |
   
 表3CreateRecordSetRequestBody 
| 参数      | 是否必选 | 参数类型             | 描述                                       |
|:---|:---|:---|:---|
| name    | 是    | String           | 域名，后缀需以zone name结束且为FQDN（即以"."号结束的完整主机名） |
| ttl     | 是    | Integer          | 解析记录在本地DNS服务器的缓存时间，缓存时间越长更新生效越慢，以秒为单位    |
| records | 否    | Array of strings | 解析记录的值，不同类型解析记录对应的值的规则不同                 |
| line    | 是    | String           | 解析线路ID                                   |
| weight  | 否    | Integer          | 解析记录的权重                                  |
| type    | 否    | String           | Record Set的类型， 取值范围：A、CNAME              |
   
#### 响应参数
**状态码：201**
表4响应Body参数 
| 参数       | 参数类型                                                               | 描述       |
|:---|:---|:---|
| \[数组元素\] | Array of [RecordSet] objects | DNS记录集合。 |
   
 表5RecordSet 
| 参数          | 参数类型             | 描述        |
|:---|:---|:---|
| id          | String           | 记录集id     |
| description | String           | 描述信息      |
| zone_id     | String           | 可用区id     |
| zone_name   | String           | 可用区名称     |
| type        | String           | 记录类型      |
| project_id  | String           | 项目id      |
| name        | String           | 记录集名称     |
| ttl         | Integer          | 生存时间      |
| records     | Array of strings | 记录信息      |
| weight      | Integer          | 比例        |
| line        | String           | 解析线路ID    |
| create_at   | String           | 创建时间      |
| update_at   | String           | 更新时间      |
| default     | Boolean          | 是否为默认记录集合 |
   
**状态码：400**
表6响应Body参数 
| 参数 | 参数类型   | 描述 |
|:---|:---|:---|
| -  | String | -  |
   
**状态码：500**
表7响应Body参数 
| 参数 | 参数类型   | 描述 |
|:---|:---|:---|
| -  | String | -  |
   
#### 请求示例
创建域名解析记录集
```
POST https://ucs.myhuaweicloud.com/v1/traffic/recordsets
[ {
  "name" : "xxx.test1110.com.",
  "type" : "A",
  "ttl" : 300,
  "records" : [ "172.18.0.200" ],
  "line" : "default_view",
  "weight" : 1
} ]
```
#### 响应示例
**状态码：201**
返回创建的域名解析记录集
```
[ {
  "id" : "ff80808299859ea0019a6da52d3e7bb3",
  "name" : "xxx.test1110.com.",
  "description" : "",
  "zone_id" : "ff80808299859ea0019a6d1206716694",
  "zone_name" : "test1110.com.",
  "type" : "A",
  "ttl" : 300,
  "records" : [ "172.18.0.200" ],
  "create_at" : "",
  "update_at" : "",
  "default" : false,
  "project_id" : "05495693df80d3c92fa1c01795c2be02",
  "weight" : 1,
  "line" : "default_view",
  "tags" : null
} ]
```
#### 状态码
| 状态码 | 描述                |
|:---|:---|
| 201 | 返回创建的域名解析记录集      |
| 400 | 客户端请求错误，服务器无法执行请求 |
| 500 | 服务器内部错误           |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ucs/ErrorCode.html)。