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 :
|
| 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 :
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 :
|
| TaskStatusCode | Integer | 2 | Le code d'état de la tâche. Valeurs possibles :
|
| 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.