You can call this operation to query the historical domain name tasks under your account by page.

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 QueryTaskInfoHistory

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

PageSize Integer Yes 2

The number of entries to return on each page.

BeginCreateTime Long No 1522080000000

The beginning of the time range to query. This value is a UNIX timestamp representing the number of milliseconds that have elapsed since the epoch time January 1, 1970, 00:00:00 UTC. Currently, only query by day is supported.

CreateTimeCursor Long No 1522080000000

Specifies whether to create a date cursor.

EndCreateTime Long No 1522080000000

The end of the time range to query. This value is a UNIX timestamp representing the number of milliseconds that have elapsed since the epoch time January 1, 1970, 00:00:00 UTC. Currently, only query by day is supported.

Lang String No en

The language of the error message to return. Valid values:

  • zh: Chinese
  • en: English

Default value: en

TaskNoCursor String No aa634d3f-927e-4d17-9d2c-test

The task ID that you enter at the cursor of the corresponding page when you turn pages.

UserClientIp String No 127.0.0.1

The IP address of the client that you use to initiate the query.

Response parameters

Parameter Type Example Description
CurrentPageCursor

The cursor of the current page.

Clientip String 127.0.0.1

The IP address of the client that was used to initiate the query.

CreateTime String 2017-11-01 17:22:51

The time when the task was created.

CreateTimeLong Long 1509528171000

The creation time of the task. This value is a UNIX timestamp.

TaskNo String aa634d3f-927e-4d17-9d2c-test

The ID of the task that was queried.

TaskNum Integer 1

The number of domain names involved in the task.

TaskStatus String COMPLETE

The status of the task that was queried. Valid values:

  • WAITING_EXECUTE: To be executed
  • EXECUTING: Executing
  • COMPLETE: Completed
TaskStatusCode Integer 3

The status code of the task. Valid values:

  • 1: To be executed
  • 2: Executing
  • 3: Completed
TaskType String CHG_DNS

The type of the task. Valid values:

  • CHG_HOLDER: Modify the registrant information.
  • CHG_DNS: Change DNS.
  • SET_WHOIS_PROTECT: Enable WHOIS privacy protection.
  • UPDATE_ADMIN_CONTACT: Update the administrator information.
  • UPDATE_BILLING_CONTACT: Update the payer information.
  • UPDATE_TECH_CONTACT: Update the technician information.
  • SET_UPDATE_PROHIBITED: Enable the update prohibition lock for the domain name.
  • SET_TRANSFER_PROHIBITED: Enable the transfer prohibition lock for the domain name.
  • ORDER_ACTIVATE: Create a registration order.
  • ORDER_RENEW: Create a renewal order.
  • ORDER_REDEEM: Create a redemption order.
  • CREATE_DNSHOST: Create a DNS host.
  • UPDATE_DNSHOST: Update the DNS host.
  • UPDATE_REGISTRANT_CONTACT: Update the contact corresponding to the registration.
  • DELETE_DOMAIN: Delete the domain name.
  • SYNC_DNSHOST: Synchronize the DNS host.
TaskTypeDescription String Change DNS

The description of the task type.

NextPageCursor

The cursor of the next page.

Clientip String 127.0.0.1

The IP address of the client that was used to initiate the query.

CreateTime String 2017-10-27 13:07:07

The time when the task was created.

CreateTimeLong Long 1509080827000

The creation time of the task. This value is a UNIX timestamp.

TaskNo String 8f112aa1-98be-48c3-82f8-test

The ID of the task that was queried.

TaskNum Integer 15

The number of domain names involved in the task.

TaskStatus String COMPLETE

The status of the task that was queried. Valid values:

  • WAITING_EXECUTE: To be executed
  • EXECUTING: Executing
  • COMPLETE: Completed
TaskStatusCode Integer 3

The status code of the task. Valid values:

  • 1: To be executed
  • 2: Executing
  • 3: Completed
TaskType String CHG_DNS

The type of the task. Valid values:

  • CHG_HOLDER: Modify the registrant information.
  • CHG_DNS: Change DNS.
  • SET_WHOIS_PROTECT: Enable WHOIS privacy protection.
  • UPDATE_ADMIN_CONTACT: Update the administrator information.
  • UPDATE_BILLING_CONTACT: Update the payer information.
  • UPDATE_TECH_CONTACT: Update the technician information.
  • SET_UPDATE_PROHIBITED: Enable the update prohibition lock for the domain name.
  • SET_TRANSFER_PROHIBITED: Enable the transfer prohibition lock for the domain name.
  • ORDER_ACTIVATE: Create a registration order.
  • ORDER_RENEW: Create a renewal order.
  • ORDER_REDEEM: Create a redemption order.
  • CREATE_DNSHOST: Create a DNS host.
  • UPDATE_DNSHOST: Update the DNS host.
  • UPDATE_REGISTRANT_CONTACT: Update the contact corresponding to the registration.
  • DELETE_DOMAIN: Delete the domain name.
  • SYNC_DNSHOST: Synchronize the DNS host.
TaskTypeDescription String Change DNS

The description of the task type.

Objects

The description of the task.

Clientip String 127.0.0.1

The IP address of the client that was used to initiate the query.

CreateTime String 2017-11-01 17:22:51

The time when the task was created.

CreateTimeLong Long 1509528171000

The creation time of the task. This value is a UNIX timestamp.

TaskNo String aa634d3f-927e-4d17-9d2c-test

The ID of the task that was queried.

TaskNum Integer 1

The number of domain names involved in the task.

TaskStatus String COMPLETE

The status of the task that was queried. Valid values:

  • WAITING_EXECUTE: To be executed
  • EXECUTING: Executing
  • COMPLETE: Completed
TaskStatusCode Integer 3

The status code of the task. Valid values:

  • 1: To be executed
  • 2: Executing
  • 3: Completed
TaskType String CHG_DNS

The type of the task. Valid values:

  • CHG_HOLDER: Modify the registrant information.
  • CHG_DNS: Change DNS.
  • SET_WHOIS_PROTECT: Enable WHOIS privacy protection.
  • UPDATE_ADMIN_CONTACT: Update the administrator information.
  • UPDATE_BILLING_CONTACT: Update the payer information.
  • UPDATE_TECH_CONTACT: Update the technician information.
  • SET_UPDATE_PROHIBITED: Enable the update prohibition lock for the domain name.
  • SET_TRANSFER_PROHIBITED: Enable the transfer prohibition lock for the domain name.
  • ORDER_ACTIVATE: Create a registration order.
  • ORDER_RENEW: Create a renewal order.
  • ORDER_REDEEM: Create a redemption order.
  • CREATE_DNSHOST: Create a DNS host.
  • UPDATE_DNSHOST: Update the DNS host.
  • UPDATE_REGISTRANT_CONTACT: Update the contact corresponding to the registration.
  • DELETE_DOMAIN: Delete the domain name.
  • SYNC_DNSHOST: Synchronize the DNS host.
TaskTypeDescription String Change DNS

The description of the task type.

PageSize Integer 2

The number of entries returned per page.

PrePageCursor

The cursor of the previous page.

Clientip String 127.0.0.1

The IP address of the client that was used to initiate the query.

CreateTime String 2017-11-01 17:19:47

The time when the task was created.

CreateTimeLong Long 1509527987000

The creation time of the task. This value is a UNIX timestamp.

TaskNo String f9baa3d5-33b9-4c81-8847-test

The ID of the task that was queried.

TaskNum Integer 15

The number of domain names involved in the task.

TaskStatus String COMPLETE

The status of the task that was queried. Valid values:

  • WAITING_EXECUTE: To be executed
  • EXECUTING: Executing
  • COMPLETE: Completed
TaskStatusCode Integer 3

The status code of the task. Valid values:

  • 1: To be executed
  • 2: Executing
  • 3: Completed
TaskType String CHG_DNS

The type of the task. Valid values:

  • CHG_HOLDER: Modify the registrant information.
  • CHG_DNS: Change DNS.
  • SET_WHOIS_PROTECT: Enable WHOIS privacy protection.
  • UPDATE_ADMIN_CONTACT: Update the administrator information.
  • UPDATE_BILLING_CONTACT: Update the payer information.
  • UPDATE_TECH_CONTACT: Update the technician information.
  • SET_UPDATE_PROHIBITED: Enable the update prohibition lock for the domain name.
  • SET_TRANSFER_PROHIBITED: Enable the transfer prohibition lock for the domain name.
  • ORDER_ACTIVATE: Create a registration order.
  • ORDER_RENEW: Create a renewal order.
  • ORDER_REDEEM: Create a redemption order.
  • CREATE_DNSHOST: Create a DNS host.
  • UPDATE_DNSHOST: Update the DNS host.
  • UPDATE_REGISTRANT_CONTACT: Update the contact corresponding to the registration.
  • DELETE_DOMAIN: Delete the domain name.
  • SYNC_DNSHOST: Synchronize the DNS host.
TaskTypeDescription String Change DNS

The description of the task type.

RequestId String EB3FCCBA-CA1F-4D31-9F34-test

The ID of the request.

Examples

Sample requests


http(s)://[Endpoint]/? Action=QueryTaskInfoHistory
&PageSize=2
&<Common request parameters>

Sample success responses

XML format

<QueryTaskInfoHistoryResponse>
      <Objects>
            <TaskInfoHistory>
                  <Clientip>127.0.0.1</Clientip>
                  <TaskNo>aa634d3f-927e-4d17-9d2c-test</TaskNo>
                  <CreateTime>2017-11-01 17:22:51</CreateTime>
                  <TaskStatus>COMPLETE</TaskStatus>
                  <TaskNum>1</TaskNum>
                  <TaskStatusCode>3</TaskStatusCode>
                  <TaskType>CHG_DNS</TaskType>
                  <CreateTimeLong>1509528171000</CreateTimeLong>
            </TaskInfoHistory>
            <TaskInfoHistory>
                  <Clientip>127.0.0.1</Clientip>
                  <TaskNo>f9baa3d5-33b9-4c81-8847-test</TaskNo>
                  <CreateTime>2017-11-01 17:19:47</CreateTime>
                  <TaskStatus>COMPLETE</TaskStatus>
                  <TaskNum>15</TaskNum>
                  <TaskStatusCode>3</TaskStatusCode>
                  <TaskType>CHG_DNS</TaskType>
                  <CreateTimeLong>1509527987000</CreateTimeLong>
            </TaskInfoHistory>
      </Objects>
      <PageSize>2</PageSize>
      <NextPageCursor>
            <TaskNo>8f112aa1-98be-48c3-82f8-test</TaskNo>
            <CreateTime>2017-10-27 13:07:07</CreateTime>
            <CreateTimeLong>1509080827000</CreateTimeLong>
      </NextPageCursor>
      <RequestId>EB3FCCBA-CA1F-4D31-9F34-test</RequestId>
      <CurrentPageCursor>
            <Clientip>127.0.0.1</Clientip>
            <TaskNo>aa634d3f-927e-4d17-9d2c-test</TaskNo>
            <CreateTime>2017-11-01 17:22:51</CreateTime>
            <TaskStatus>COMPLETE</TaskStatus>
            <TaskNum>1</TaskNum>
            <TaskStatusCode>3</TaskStatusCode>
            <TaskType>CHG_DNS</TaskType>
            <CreateTimeLong>1509528171000</CreateTimeLong>
      </CurrentPageCursor>
</QueryTaskInfoHistoryResponse>

JSON format

{
	"prePageCursor":{},
	"requestId":"6EB5D9B8-AD99-4423-9D02-test",
	"currentPageCursor":{
		"createTime":"2017-11-01 17:22:51",
		"createTimeLong":1509528171000,
		"taskStatus":"COMPLETE",
		"clientip":"127.0.0.1",
		"taskType":"CHG_DNS",
		"taskNo":"aa634d3f-927e-4d17-9d2c-test",
		"taskStatusCode":3,
		"taskNum":1
	},
	"pageSize":2,
	"nextPageCursor":{
		"createTime":"2017-10-27 13:07:07",
		"createTimeLong":1509080827000,
		"taskNo":"8f112aa1-98be-48c3-82f8-test"
	},
	"objects":[
		{
			"createTime":"2017-11-01 17:22:51",
			"createTimeLong":1509528171000,
			"taskStatus":"COMPLETE",
			"clientip":"127.0.0.1",
			"taskType":"CHG_DNS",
			"taskNo":"aa634d3f-927e-4d17-9d2c-test",
			"taskStatusCode":3,
			"taskNum":1
		},
		{
			"createTime":"2017-11-01 17:19:47",
			"createTimeLong":1509527987000,
			"taskStatus":"COMPLETE",
			"clientip":"127.0.0.1",
			"taskType":"CHG_DNS",
			"taskNo":"f9baa3d5-33b9-4c81-8847-test",
			"taskStatusCode":3,
			"taskNum":15
		}
	]
}

Error codes

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