
# 创建防护域名 - CreateDomainV2
#### 功能介绍
创建防护域名
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-aad/aad_02_0007.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-aad/abcd.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
POST /v2/aad/domains
#### 请求参数
表1请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述           |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | token        |
| Content-Type | 是    | String | Content-Type |
   
表2请求Body参数 
| 参数                    | 是否必选 | 参数类型              | 描述                                                               |
|:---|:---|:---|:---|
| domain_name           | 是    | String            | 域名                                                               |
| enterprise_project_id | 是    | String            | 企业项目id，与接入的高防实例所属企业项目保持一致。可在华为云EPS服务中查看企业项目id，default企业项目id为"0"。 |
| ips                   | 是    | Array of strings  | 高防实例ip列表。多个高防实例ip必须属于同一企业项目。                                     |
| real_server_type      | 是    | Integer           | 源站类型。0-源站IP，1-源站域名。                                              |
| port_http             | 是    | Array of integers | HTTP端口，与port_https不能同时为空。DDoS高防支持的HTTP端口可在控制台查看。                 |
| port_https            | 否    | Array of integers | HTTPS端口，与port_http不能同时为空。DDoS高防支持的HTTPS端口可在控制台查看。                |
| real_server           | 是    | String            | 源站（源站ip/源站域名）                                                    |
| overseas_type         | 是    | String            | 防护区域，0-大陆，1-海外                                                   |
| cert_name             | 否    | String            | 证书名称（必须是已经存在的证书）                                                 |
| waf_switch            | 否    | String            | 开启0，关闭1                                                          |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数        | 参数类型   | 描述           |
|:---|:---|:---|
| cname     | String | 高防提供的CNAME地址 |
| domain_id | String | 域名id         |
   
#### 请求示例
添加test.com域名，高防IP为2.x.x.2，企业项目ID为0，源站类型为源站IP，端口80，源站为4.x.x.2，证书名称为123，开启waf。
```
POST https://{endpoint}/v2/aad/domains
{
  "domain_name" : "test.com",
  "enterprise_project_id" : "0",
  "ips" : [ "2.x.x.2" ],
  "real_server_type" : 0,
  "port_http" : [ 80 ],
  "real_server" : "4.x.x.2",
  "overseas_type" : "0",
  "cert_name" : "123",
  "waf_switch" : "0"
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "domain_id" : "81c8xxxxxxxxxxxxxxxx11c9",
  "cname" : "29xxxxxxxxxxxx1e.huaweisafedns.cn"
}
```
#### 状态码
| 状态码 | 描述    |
|:---|:---|
| 200 | OK    |
| 400 | Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-aad/ErrorCode.html)。
