# 添加CDN加速域名
#### 场景描述
本章节指导用户通过API创建加速域名，API的调用方法请参见[如何调用API](https://support.huaweicloud.com/api-cdn/cdn_02_0019.html)。
#### 约束限制
- 华为账号已开通CDN服务。
- 调用API不支持批量创建加速域名。
 
#### 涉及API
- 当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加"X-Auth-Token"到业务接口请求消息头中。
- [创建加速域名](https://support.huaweicloud.com/api-cdn/CreateDomain.html)：创建加速域名。
 
#### 操作步骤
1. [获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)，用于调用添加CDN加速域名接口时进行认证鉴权，具体操作请参考[构造请求](https://support.huaweicloud.com/api-cdn/cdn_02_0029.html)。
   - ***username和*** ***domainname***可以在"华为云控制台\>右上方账号名称\>我的凭证"页面获取。
   
   - 请求URL：POST https://iam.myhuaweicloud.com/v3/auth/tokens
   
   - 请求头消息：Content-Type：application/json
   
   - 请求体：
     ```
     {
     "auth": {
     "identity": {
     "methods": ["password"],
     "password": {
     "user": {
     "name": "name",           --用户名
     "password": "password",       --密码
     "domain": {
     "name": "domainname"    --用户所属的账号名称
     }
     }
     }
     },
     "scope": {
     "domain": {
     "name": "domainname"    --用户所属的账号名称
     }
     }
     }
       }
     ```
     
   
   
   如[图1]所示，红框中的信息为获取用户Token。
   图1获取用户Token   
   ![](https://support.huaweicloud.com/api-cdn/zh-cn_image_0172661692.png)
   ![](https://support.huaweicloud.com/api-cdn/public_sys-resources/note_3.0-zh-cn.png)
   您还可以在在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=IAM&api=KeystoneCreateUserTokenByPassword)中运行调试获取Token。
   
2. 选择**POST** 请求方法并输入请求URI。
   ```
   POST  https://cdn.myhuaweicloud.com/v1.0/cdn/domains
   ```
   
3. 在Request Header中增加"X-Auth-Token"。"X-Auth-Token"填写的内容为请求认证Header中返回的"x-subject-token"字段信息，如[图1]中红框字段。
4. 在Request Body中传入参数如下：
   ```
   {
       "domain": {
           "domain_name": "example1.example2.example3.com",
           "business_type": "web",
           "sources": [
               {
                   "ip_or_domain": "192.168.53.75",
                   "origin_type": "ipaddr",
                   "active_standby":1
               }
           ],
   "enterprise_project_id":"0"
       }
   }
   ```
   - 各参数解释请参见[创建加速域名](https://support.huaweicloud.com/api-cdn/CreateDomain.html)。
   
   
   请求响应成功后，返回创建的域名的相关信息，响应示例如下：
   ```
   {
       "domain": {
           "sources": [
               {
                   "domain_id":"ff80*************************07b",
                   "ip_or_domain": "192.168.53.75",
                   "origin_type": "ipaddr",
                   "active_standby":1
               }
           ],
           "id": "ff80*************************07b",
           "user_domain_id": "38***********************5024dcb",
           "domain_name": "example11.example2.example3.com",
           "business_type": "web",
           "cname": "example1.example2.example3.com.c.example4.com",
           "domain_status": "configuring",
           "https_status": null,
           "description": null,
           "create_time": 1513152634467,
           "modify_time": 1513152634467,
           "domain_origin_host": {
               "domain_id": "ff80*************************07b",
               "origin_host_type": "customize",
               "customize_domain": "example5.example6.com"
           },
           "disabled": 0,
           "locked": 0
       }
   }
   ```
   若请求失败，则会返回错误码及对应的错误信息说明，详细错误码信息请参见[错误码](https://support.huaweicloud.com/api-cdn/ErrorCode.html)。