Tous les produits
Search
Centre de documentation

Domain Names:PollTaskResult

Dernière mise à jour :Aug 09, 2026

Interroge les détails des tâches de nom de domaine terminées, y compris les tâches réussies et celles ayant échoué après le nombre maximal de tentatives.

no heading

Appelez l'opération AcknowledgeTaskResult pour confirmer le résultat d'exécution d'une tâche de nom de domaine. Une fois le résultat confirmé, vous ne pouvez plus interroger les détails de cette tâche via l'opération PollTaskResult.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. Il génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter Type Required Example Description
Action String Yes PollTaskResult

L'action à effectuer. Définissez la valeur sur PollTaskResult.

PageNum Integer Yes 1

Le numéro de page à renvoyer.

PageSize Integer Yes 20

Le nombre d'entrées par page. Valeur maximale : 1000.

TaskResultStatus Integer No 2

Le résultat d'exécution de la tâche. Valeurs possibles :

  • 2 : réussite
  • 3 : échec
InstanceId String No S20181T0WLI85212

L'ID d'instance du nom de domaine.

Le système génère cet ID automatiquement après la création du profil du titulaire. Appelez l'opération QueryRegistrantProfiles pour récupérer l'ID du profil du titulaire.

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

L'ID de la tâche.

DomainName String No example.com

Le nom de domaine.

Lang String No en

La langue du message d'erreur renvoyé par le système. Valeurs possibles :

  • zh : chinois
  • en : anglais

Valeur par défaut : en

UserClientIp String No 127.0.0.1

L'adresse IP du client. Vous pouvez définir la valeur sur 127.0.0.1.

Paramètres de réponse

Parameter Type Example Description
CurrentPageNum Integer 1

Le numéro de la page renvoyée.

Data Array of TaskDetail

La liste des détails des tâches.

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

L'heure de création de la tâche.

DomainName String example.com

Le nom de domaine.

ErrorMsg String The operation is successful.

Le message d'erreur renvoyé en cas d'échec de la tâche.

InstanceId String S201817141000000

L'ID d'instance du nom de domaine.

TaskDetailNo String 15fee9d10d514bada66bd08c5723c583

L'ID des détails de la tâche.

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

L'ID de la tâche.

TaskResult String test

Le résultat d'exécution de la tâche.

TaskStatus String EXECUTE_SUCCESS

L'état de la tâche. Valeurs possibles :

  • WAITING_EXECUTE : en attente d'exécution
  • EXECUTING : en cours d'exécution
  • EXECUTE_SUCCESS : réussite
  • EXECUTE_FAILURE : échec
TaskStatusCode Integer 2

Le code d'état de la tâche. Valeurs possibles :

  • 0 : en attente d'exécution
  • 1 : en cours d'exécution
  • 2 : réussite
  • 3 : échec
TaskType String CHG_DNS

Le type de la tâche.

TaskTypeDescription String Modify the DNS server

La description du type de tâche. Modifiez la valeur du paramètre Lang pour changer la langue de la description.

TryCount Integer 0

Le nombre de tentatives de la tâche.

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

L'heure de la dernière exécution de la tâche.

NextPage Boolean false

Indique s'il existe une page suivante.

PageSize Integer 1

Le nombre d'entrées par page.

PrePage Boolean false

Indique s'il existe une page précédente.

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

L'ID de la requête.

TotalItemNum Integer 10

Le nombre total d'entrées.

TotalPageNum Integer 10

Le nombre total de pages.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

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

Format 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
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.