# 查询域名任务
#### 功能介绍
在华为云查询域名任务。
#### URI
GET /v2/domain-jobs
表1Query参数 
| 参数     | 是否必选 | 参数类型    | 描述                                                                                                    |
|:---|:---|:---|:---|
| offset | 否    | Integer | 分页偏移量。 取值范围：0\~1000000 默认值为0。 |
| limit  | 否    | Integer | 每页数量。 取值范围：1\~200 默认值为10。          |
| job_id | 否    | String  | 任务编号，长度不超过64个字符。                                                                                      |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述          |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户IAM-Token |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数           | 参数类型                                                           | 描述   |
|:---|:---|:---|
| total        | Integer                                                        | 任务总数 |
| domain_tasks | Array of [表4] objects | 任务列表 |
   
 表4DomainTask 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|
| job_id     | String | 任务编号                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| job_type   | String | 任务类型。 取值范围： - REGISTER_JOB：注册类型  - RENEW_JOB：续费类型                                                                                                                                                                               |
| status     | String | 任务状态。 取值范围： - PENDING：等待执行  - RUNNING：执行中  - SUCCESS：任务执行成功  - FAILED：任务执行失败   |
| begin_time | String | 开始时间，时间戳格式，eg:1642063839104                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| end_time   | String | 结束时间，时间戳格式，eg:1642063845625                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| error_code | String | Job执行失败时的错误原因。 Job执行成功后，该值为null。                                                                                                                                                                                                                                                                                                                                                                                                                    |
   
#### 请求示例
在华为云查询域名注册任务结果
```
GET https://{endpoint}/v2/domain-jobs?limit=1&offset=0
```
#### 响应示例
```
{
  "total": 905,
  "domain_tasks": [
    {
      "status": "SUCCESS",
      "job_id": "8abf6fb17e42e05a017e52a1bf811128",
      "job_type": "REGISTER_JOB",
      "begin_time": 1642063839104,
      "end_time": 1642063845625,
      "error_code": null
    }
  ]
}
```
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-domain/domain_api_50001.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-domain/domain_api_50002.html)。