PollTaskResult - Domain Names: Central de Documentação do Alibaba Cloud

no heading

Use a operação AcknowledgeTaskResult para confirmar o resultado da execução de uma tarefa de nome de domínio. Após a confirmação do resultado, não é mais possível consultar os detalhes dessa tarefa pela operação PollTaskResult.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	PollTaskResult	Operação a ser executada. Defina o valor como PollTaskResult.
PageNum	Integer	Sim	1	Número da página a retornar.
PageSize	Integer	Sim	20	Quantidade de entradas a retornar por página. Valor máximo: 1000.
TaskResultStatus	Integer	Não	2	Resultado da execução da tarefa. Valores válidos: 2: bem-sucedida 3: falha
InstanceId	String	Não	S20181T0WLI85212	ID da instância do nome de domínio. O sistema gera este ID automaticamente após a criação do perfil do registrante. Chame a operação QueryRegistrantProfiles para consultar o ID do perfil do registrante.
TaskNo	String	Não	75addb07-28a3-450e-b5ec-test	ID da tarefa.
DomainName	String	Não	example.com	Nome de domínio.
Lang	String	Não	en	Idioma da mensagem de erro retornada pelo sistema. 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. Você pode definir o valor como 127.0.0.1.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
CurrentPageNum	Integer	1	Número da página retornada.
Data	Array of TaskDetail		Lista de detalhes da tarefa.
TaskDetail
CreateTime	String	2018-03-26 15:08:20	Hora de criação da tarefa.
DomainName	String	example.com	Nome de domínio.
ErrorMsg	String	The operation is successful.	Mensagem de erro retornada em caso de falha na tarefa.
InstanceId	String	S201817141000000	ID da instância do nome de domínio.
TaskDetailNo	String	15fee9d10d514bada66bd08c5723c583	ID dos detalhes da tarefa.
TaskNo	String	b95bc334-f7d8-4f39-8a62-4c4302a243d8	ID da tarefa.
TaskResult	String	test	Resultado da execução da tarefa.
TaskStatus	String	EXECUTE_SUCCESS	Status da tarefa. Valores válidos: WAITING_EXECUTE: aguardando execução EXECUTING: em execução EXECUTE_SUCCESS: bem-sucedida EXECUTE_FAILURE: falha
TaskStatusCode	Integer	2	Código de status da tarefa. Valores válidos: 0: aguardando execução 1: em execução 2: bem-sucedida 3: falha
TaskType	String	CHG_DNS	Tipo da tarefa.
TaskTypeDescription	String	Modify the DNS server	Descrição do tipo de tarefa. Altere o valor do parâmetro Lang para modifique o idioma desta descrição.
TryCount	Integer	0	Número de tentativas de repetição da tarefa.
UpdateTime	String	2018-03-26 15:22:18	Hora da última execução da tarefa.
NextPage	Boolean	false	Indica se há uma próxima página após a página atual.
PageSize	Integer	1	Número de entradas retornadas por página.
PrePage	Boolean	false	Indica se há uma página anterior à página atual.
RequestId	String	E879DC07-38EE-4408-9F33-73B30CD965CD	ID da solicitação.
TotalItemNum	Integer	10	Total de entradas retornadas.
TotalPageNum	Integer	10	Total de páginas retornadas.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

Formato 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>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>

Formato JSON

{
    "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
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.