调用PollTaskResult获取已经执行完成(包括执行成功和执行失败并超过重试次数)的域名任务详情列表。

该接口需要配合AcknowledgeTaskResult确认任务结果。任务结果确认后,对应任务记录将无法从该接口查询到。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String PollTaskResult

系统规定参数。取值:PollTaskResult

PageNum Integer 1

页码。

PageSize Integer 20

分页大小。

DomainName String test.com

域名。

InstanceId String S20181T0WLI85212

业务编号。

Lang String en

接口返回错误信息语言。取值:

  • zh:中文;
  • en:英文。

默认为en

TaskNo String 75addb07-28a3-450e-b5ec-test

任务编号。

TaskResultStatus Integer 2

任务结果类型,取值:

  • 2:成功;
  • 3:失败。
UserClientIp String 127.0.0.1

用户IP。

返回数据

名称 类型 示例值 描述
CurrentPageNum Integer 1

当前页码。

Data

任务详情列表。

CreateTime String 2018-03-26 15:08:20

任务创建时间。

DomainName String test.com

域名。

ErrorMsg String The operation is successful.

任务执行失败消息。

InstanceId String S201817141000000

域名实例编号。

TaskDetailNo String 15fee9d10d514bada66bd08c5723c583

任务详情编号。

TaskNo String b95bc334-f7d8-4f39-8a62-4c4302a243d8

任务编号。

TaskResult String test

任务结果。

TaskStatus String EXECUTE_SUCCESS

任务状态。可能值:

  • WAITING_EXECUTE:等待执行;
  • EXECUTING:执行中;
  • EXECUTE_SUCCESS:执行成功;
  • EXECUTE_FAILURE:执行失败。
TaskStatusCode Integer 2

任务状态码。可能值:

  • 0:等待执行;
  • 1:执行中;
  • 2:执行成功;
  • 3:执行失败。
TaskType String CHG_DNS

任务类型。

TaskTypeDescription String 修改DNS

任务类型描述,切换Lang参数,该字段会切换语言。

TryCount Integer 0

任务详情重试次数。

UpdateTime String 2018-03-26 15:22:18

最近一次任务详情执行时间。

NextPage Boolean false

是否有下一页。

PageSize Integer 1

分页大小。

PrePage Boolean false

是否有上一页。

RequestId String E879DC07-38EE-4408-9F33-73B30CD965CD

唯一请求识别码。

TotalItemNum Integer 10

总条数。

TotalPageNum Integer 10

总页数。

示例

请求示例


http(s)://[Endpoint]/?Action=PollTaskResult
&PageNum=1
&PageSize=20
&<公共请求参数>

正常返回示例

XML 格式

<PollTaskResultResponse>
    <Data>
        <TaskDetail>
            <TryCount>0</TryCount>
            <TaskDetailNo>15fee9d10d514bada66bd08c5723c583</TaskDetailNo>
            <TaskNo>b95bc334-f7d8-4f39-8a62-4c4302a243d8</TaskNo>
            <CreateTime>2018-03-26 15:08:20</CreateTime>
            <InstanceId>S201817141000000</InstanceId>
            <UpdateTime>2018-03-26 15:22:18</UpdateTime>
            <TaskStatus>EXECUTE_SUCCESS</TaskStatus>
            <DomainName>test.com</DomainName>
            <TaskTypeDescription>DNS Modification</TaskTypeDescription>
            <TaskStatusCode>2</TaskStatusCode>
            <ErrorMsg>The operation is successful.</ErrorMsg>
            <TaskType>CHG_DNS</TaskType>
        </TaskDetail>
    </Data>
    <TotalItemNum>10</TotalItemNum>
    <PageSize>1</PageSize>
    <CurrentPageNum>1</CurrentPageNum>
    <RequestId>C2CB6161-7971-4EB6-BC16-92A2BA3816D9</RequestId>
    <TotalPageNum>10</TotalPageNum>
</PollTaskResultResponse>

JSON 格式

{
	"Data":{
		"TaskDetail":[
			{
				"TryCount":0,
				"TaskNo":"b95bc334-f7d8-4f39-8a62-4c4302a243d8",
				"TaskDetailNo":"15fee9d10d514bada66bd08c5723c583",
				"InstanceId":"S201817141000000",
				"CreateTime":"2018-03-26 15:08:20",
				"UpdateTime":"2018-03-26 15:22:18",
				"TaskStatus":"EXECUTE_SUCCESS",
				"DomainName":"test.com",
				"TaskTypeDescription":"DNS Modification",
				"TaskStatusCode":2,
				"ErrorMsg":"The operation is successful.",
				"TaskType":"CHG_DNS"
			}
		]
	},
	"TotalItemNum":10,
	"PageSize":1,
	"CurrentPageNum":1,
	"RequestId":"E879DC07-38EE-4408-9F33-73B30CD965CD",
	"TotalPageNum":10
}

错误码

访问错误中心查看更多错误码。