Todos os produtos
Search
Central de documentação

Domain Names:QueryTaskList

Última atualização: Jun 27, 2026

Use esta operação para consultar as tarefas de nome de domínio da sua conta de forma paginada.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta operação no OpenAPI Explorer, que também gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros de solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim QueryTaskList

Operação a ser executada. Defina o valor como QueryTaskList.

PageNum Integer Sim 1

Número da página a retornar.

PageSize Integer Sim 2

Quantidade de entradas a retornar por página.

BeginCreateTime Long Não 1522080000000

Início do intervalo de tempo para consulta da data de expiração. O horário é expresso em milissegundos desde a época (epoch) e exibido em UTC. Atualmente, apenas consultas por dia são suportadas.

EndCreateTime Long Não 1522080000000

Fim do intervalo de tempo para consulta da data de expiração. O horário é expresso em milissegundos desde a época (epoch) e exibido em UTC. Atualmente, apenas consultas por dia são suportadas.

Lang String Não en

Idioma da mensagem de erro retornada. Valores válidos:

  • zh: Chinês
  • en: Inglês

Valor padrão: en

UserClientIp String Não 127.0.0.1

Endereço IP do cliente usado para iniciar a consulta.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
CurrentPageNum Integer 1

Número da página atual.

Data

Lista de tarefas retornadas.

TaskInfo

Detalhes da tarefa retornada.

Clientip String 127.0.0.1

Endereço IP do cliente usado para iniciar a consulta.

CreateTime String Dec 26,2017 11:00:54

Horário de criação da tarefa.

TaskCancelStatus String INIT

Status de cancelamento da tarefa. Valores válidos:

  • INIT: Não cancelada
  • CANCELLING: Cancelamento em andamento
  • COMPLETE: Cancelada
TaskCancelStatusCode Integer 0

Código do status de cancelamento da tarefa. Valores válidos:

  • 0: Não cancelada
  • 1: Cancelamento em andamento
  • 2: Cancelada
TaskNo String 8b1cd755-4928-4b02-adee-e5d41d7b1939

ID da tarefa consultada.

TaskNum Integer 1

Quantidade de nomes de domínio na tarefa.

TaskStatus String COMPLETE

Status da tarefa. Valores válidos:

  • WAITING_EXECUTE: Aguardando execução
  • EXECUTING: Em execução
  • COMPLETE: Executada
TaskStatusCode Integer 1

Código de status da tarefa. Valores válidos:

  • 1: Aguardando execução
  • 2: Em execução
  • 3: Executada
TaskType String CREATE_DNSHOST

Tipo da tarefa. Valores válidos:

  • CHG_HOLDER: Modifique informações do registrante.
  • CHG_DNS: Modifique DNS.
  • SET_WHOIS_PROTECT: Defina proteção de privacidade.
  • UPDATE_ADMIN_CONTACT: Atualize informações do administrador.
  • UPDATE_BILLING_CONTACT: Atualize informações do pagador.
  • UPDATE_TECH_CONTACT: Atualize informações do técnico.
  • SET_UPDATE_PROHIBITED: Defina bloqueio de segurança para o nome de domínio.
  • SET_TRANSFER_PROHIBITED: Defina bloqueio de transferência para o nome de domínio.
  • ORDER_ACTIVATE: Crie pedido de registro.
  • ORDER_RENEW: Crie pedido de renovação.
  • ORDER_REDEEM: Crie pedido de resgate.
  • CREATE_DNSHOST: Crie host DNS.
  • UPDATE_DNSHOST: Atualize host DNS.
  • SYNC_DNSHOST: Sincronizar host DNS.
TaskTypeDescription String Create a DNS host

Descrição do tipo de tarefa.

NextPage Boolean true

Indica se há uma próxima página.

PageSize Integer 2

Quantidade de entradas retornadas por página.

PrePage Boolean false

Indica se há uma página anterior.

RequestId String 8D7D294A-8E99-481F-B64C-017EFC793059

ID da solicitação.

TotalItemNum Integer 43

Total de entradas retornadas.

TotalPageNum Integer 22

Total de páginas retornadas.

Exemplos

Solicitações de exemplo


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

Respostas de sucesso de exemplo

Formato XML

<QueryTaskListResponse>
      <Data>
            <TaskInfo>
                  <Clientip>127.0.0.1</Clientip>
                  <TaskNo>8b1cd755-4928-4b02-adee-e5d41d7b1939</TaskNo>
                  <CreateTime>Dec 26,2017 11:00:54</CreateTime>
                  <TaskStatus>COMPLETE</TaskStatus>
                  <TaskNum>1</TaskNum>
                  <TaskType>CREATE_DNSHOST</TaskType>
            </TaskInfo>
            <TaskInfo>
                  <Clientip>127.0.0.1</Clientip>
                  <TaskNo>b0069db5-db21-4e57-842a-260c370a37e2</TaskNo>
                  <CreateTime>Dec 26,2017 11:00:54</CreateTime>
                  <TaskStatus>COMPLETE</TaskStatus>
                  <TaskNum>2</TaskNum>
                  <TaskType>CHG_DNS</TaskType>
            </TaskInfo>
      </Data>
      <TotalItemNum>43</TotalItemNum>
      <PageSize>2</PageSize>
      <CurrentPageNum>1</CurrentPageNum>
      <RequestId>8D7D294A-8E99-481F-B64C-017EFC793059</RequestId>
      <TotalPageNum>22</TotalPageNum>
</QueryTaskListResponse>

Formato JSON

{
	"Data":{
		"TaskInfo":[
			{
				"Clientip":"127.0.0.1",
				"TaskNo":"8b1cd755-4928-4b02-adee-e5d41d7b1939",
				"CreateTime":"Dec 26,2017 11:00:54",
				"TaskStatus":"COMPLETE",
				"TaskNum":1,
				"TaskType":"CREATE_DNSHOST"
			},
			{
				"Clientip":"127.0.0.1",
				"TaskNo":"b0069db5-db21-4e57-842a-260c370a37e2",
				"CreateTime":"Dec 26,2017 11:00:54",
				"TaskStatus":"COMPLETE",
				"TaskNum":2,
				"TaskType":"CHG_DNS"
			}
		]
	},
	"TotalItemNum":43,
	"PageSize":2,
	"CurrentPageNum":1,
	"RequestId":"85C735DC-872F-423B-A728-C20C2924D3C6",
	"TotalPageNum":22
}

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros da API.