
# 续费域名
#### 功能介绍
在华为云创建一个域名续费任务。
#### URI
POST /v2/domains/actions/renew
#### 请求参数
表1请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述          |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户IAM-Token |
   
表2请求Body参数 
| 参数          | 是否必选 | 参数类型    | 描述                                                                          |
|:---|:---|:---|:---|
| domain_name | 是    | String  | 域名名称，只允许输入1个域名，且包括前缀和后缀。 取值范围：4\~253个字符。 |
| duration    | 是    | Integer | 续费周期，单位为年。 取值范围：1\~10                      |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数       | 参数类型   | 描述   |
|:---|:---|:---|
| job_id   | String | 任务编号 |
| order_id | String | 订单编号 |
   
#### 请求示例
在华为云创建一个续费一年的域名续费任务
```
POST https://{endpoint}/v2/domains/actions/renew
{
   "domain_name":"202201131503.top",
   "duration": 1
}
```
#### 响应示例
```
{
   "job_id": "8abf6fb67e42e419017e52923fb410a7",
   "order_id": "CS2201131633EA1OS"
}
```
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-domain/domain_api_50001.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-domain/domain_api_50002.html)。
