文档首页/ 域名注册服务 Domains/ API参考/ API/ 域名查询/ 查询域名任务
更新时间：2023-06-16 GMT+08:00
查看PDF
分享

查询域名任务

功能介绍

在华为云查询域名任务。

URI

GET /v2/domain-jobs

表1 Query参数

参数

是否必选

参数类型

描述

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

任务列表
表4 DomainTask

参数

参数类型

描述

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
    }
  ]
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 域名查询

相关文档