PollTaskResult - Domain Names - Centro de documentación de Alibaba Cloud

Consulta los detalles de las tareas de nombres de dominio completadas, incluidas las tareas exitosas y aquellas que fallaron tras alcanzar el número máximo de intentos.

no heading

Puede llamar a la operación AcknowledgeTaskResult para confirmar el resultado de ejecución de una tarea de nombre de dominio. Una vez confirmado el resultado de ejecución, ya no es posible consultar los detalles de dicha tarea mediante la operación PollTaskResult.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	PollTaskResult	La operación que desea ejecutar. Establezca el valor en PollTaskResult.
PageNum	Integer	Sí	1	El número de página que se devolverá.
PageSize	Integer	Sí	20	El número de entradas que se devolverán en cada página. Valor máximo: 1000.
TaskResultStatus	Integer	No	2	El resultado de ejecución de la tarea. Valores válidos: 2: exitosa 3: con errores
InstanceId	String	No	S20181T0WLI85212	El ID de instancia del nombre de dominio. Este ID lo genera automáticamente el sistema tras crear el perfil del registrante. Puede llamar a la operación QueryRegistrantProfiles para consultar el ID del perfil del registrante.
TaskNo	String	No	75addb07-28a3-450e-b5ec-test	El ID de la tarea.
DomainName	String	No	example.com	El nombre de dominio.
Lang	String	No	en	El idioma en el que el sistema devuelve el mensaje de error. Valores válidos: zh: chino en: inglés Valor predeterminado: en
UserClientIp	String	No	127.0.0.1	La dirección IP del cliente. Puede establecer el valor en 127.0.0.1.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
CurrentPageNum	Integer	1	El número de la página devuelta.
Data	Array of TaskDetail		La lista de detalles de la tarea.
TaskDetail
CreateTime	String	2018-03-26 15:08:20	La hora en que se creó la tarea.
DomainName	String	example.com	El nombre de dominio.
ErrorMsg	String	The operation is successful.	El mensaje de error devuelto cuando la tarea falla.
InstanceId	String	S201817141000000	El ID de instancia del nombre de dominio.
TaskDetailNo	String	15fee9d10d514bada66bd08c5723c583	El ID de los detalles de la tarea.
TaskNo	String	b95bc334-f7d8-4f39-8a62-4c4302a243d8	El ID de la tarea.
TaskResult	String	test	El resultado de ejecución de la tarea.
TaskStatus	String	EXECUTE_SUCCESS	El estado de la tarea. Valores válidos: WAITING_EXECUTE: en espera de ejecución EXECUTING: en ejecución EXECUTE_SUCCESS: exitosa EXECUTE_FAILURE: con errores
TaskStatusCode	Integer	2	El código de estado de la tarea. Valores válidos: 0: en espera de ejecución 1: en ejecución 2: exitosa 3: con errores
TaskType	String	CHG_DNS	El tipo de tarea.
TaskTypeDescription	String	Modify the DNS server	La descripción del tipo de tarea. Puede modificar el valor del parámetro Lang para cambiar el idioma de la descripción.
TryCount	Integer	0	El número de veces que se reintentó la tarea.
UpdateTime	String	2018-03-26 15:22:18	La hora de la última ejecución de la tarea.
NextPage	Boolean	false	Indica si existe una página posterior a la página actual.
PageSize	Integer	1	El número de entradas devueltas en cada página.
PrePage	Boolean	false	Indica si existe una página anterior a la página actual.
RequestId	String	E879DC07-38EE-4408-9F33-73B30CD965CD	El ID de la solicitud.
TotalItemNum	Integer	10	El número total de entradas devueltas.
TotalPageNum	Integer	10	El número total de páginas devueltas.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 error

Para obtener una lista de los códigos de error, visite el Centro de errores de API.