Queries the details of completed domain name tasks, including successful tasks and tasks that still failed after the maximum number of attempts.

You can call the AcknowledgeTaskResult operation to confirm the execution result of a domain name task. After the execution result of a domain name task is confirmed, the details of this task cannot be queried by calling the PollTaskResult operation.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes PollTaskResult

The operation that you want to perform. Set the value to PollTaskResult.

PageNum Integer Yes 1

The number of the page to return.

PageSize Integer Yes 20

The number of entries to return on each page. Maximum value: 1000.

TaskResultStatus Integer No 2

The execution result of the task. Valid values:

  • 2: successful
  • 3: failed
InstanceId String No S20181T0WLI85212

The instance ID of the domain name.

This ID is automatically generated by the system after the registrant profile is created. You can call the QueryRegistrantProfiles operation to query the ID of the registrant profile.

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

The ID of the task.

DomainName String No example.com

The domain name.

Lang String No en

The language in which the system returns the error message. Valid values:

  • zh: Chinese
  • en: English

Default value: en

UserClientIp String No 127.0.0.1

The IP address of the client. You can set the value to 127.0.0.1.

Response parameters

Parameter Type Example Description
CurrentPageNum Integer 1

The page number of the returned page.

Data Array of TaskDetail

The list of task details.

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

The time when the task was created.

DomainName String example.com

The domain name.

ErrorMsg String The operation is successful.

The error message returned when the task fails.

InstanceId String S201817141000000

The instance ID of the domain name.

TaskDetailNo String 15fee9d10d514bada66bd08c5723c583

The ID of the task details.

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

The ID of the task.

TaskResult String test

The execution result of the task.

TaskStatus String EXECUTE_SUCCESS

The status of the task. Valid values:

  • WAITING_EXECUTE: waiting for execution
  • EXECUTING: being executed
  • EXECUTE_SUCCESS: successful
  • EXECUTE_FAILURE: failed
TaskStatusCode Integer 2

The status code of the task. Valid values:

  • 0: waiting for execution
  • 1: being executed
  • 2: successful
  • 3: failed
TaskType String CHG_DNS

The type of the task.

TaskTypeDescription String Modify the DNS server

The description of the task type. You can change the value of the Lang parameter to change the language of the description.

TryCount Integer 0

The number of times the task was retried.

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

The time when the task was last executed.

NextPage Boolean false

Indicates whether the current page is followed by a page.

PageSize Integer 1

The number of entries returned on each page.

PrePage Boolean false

Indicates whether the current page is preceded by a page.

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

The ID of the request.

TotalItemNum Integer 10

The total number of entries returned.

TotalPageNum Integer 10

The total number of pages returned.

Examples

Sample requests

http(s)://[Endpoint]/?Action=PollTaskResult
&PageNum=1
&PageSize=20
&<Common request parameters>

Sample success responses

XML format

<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>example.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 format

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

Error codes

For a list of error codes, visit the API Error Center.