CancelOTATaskByDevice - Annuler les tâches de mise à jour OTA des appareils - IoT Platform

Annule les tâches de mise à jour des appareils qui se trouvent dans l'état En attente de confirmation, À pousser, Poussé ou En cours de mise à niveau pour un package de mise à jour OTA.

Notes d'utilisation

Cette opération annule uniquement les tâches de mise à jour des appareils se trouvant dans l'état En attente de confirmation, À pousser, Poussé ou En cours de mise à niveau.

Limites de QPS

Chaque compte peut appeler cette opération jusqu'à 10 fois par seconde.

Remarque

Les utilisateurs RAM partagent le quota du compte Alibaba Cloud.

Débogage

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

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	CancelOTATaskByDevice	L'opération que vous souhaitez effectuer. Définissez la valeur sur `CancelOTATaskByDevice`.
ProductKey	String	Oui	a1V4kde****	La ProductKey du produit auquel appartient l'appareil.
FirmwareId	String	Oui	T0F5b5tpFnHQrgfk****030100	L'ID unique du package de mise à jour OTA. L'opération CreateOTAFirmware renvoie cet ID lorsque vous créez un package de mise à jour. Vous pouvez également appeler ListOTAFirmware pour interroger les ID des packages de mise à jour.
DeviceName.N	RepeatList	Oui	device1	Les noms des appareils pour lesquels annuler les mises à jour. Chaque nom d'appareil doit être unique. Maximum : 200 noms d'appareils.
JobId	String	Non	wahVIzGkCMuAUE2gDERM02****	L'ID du lot de mise à jour. S'il est spécifié, seules les tâches de ce lot sont annulées. Renvoyé par CreateOTAVerifyJob, CreateOTAStaticUpgradeJob ou CreateOTADynamicUpgradeJob en tant que paramètre JobId. Vous pouvez également trouver l'ID du lot sur la page Détails du package de mise à jour dans la console IoT Platform.
IotInstanceId	String	Non	iot_instc_pu*_c-v64	L'ID de l'instance. Visible sur la page Overview de la console IoT Platform. Important Obligatoire si votre instance possède un ID. Sinon, l'appel échoue. Non requis si votre instance ne dispose pas d'une page Overview ou d'un ID. Overview.

Cette opération nécessite également des paramètres de requête communs.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Code	String	iot.system.SystemException	Le code d'erreur renvoyé en cas d'échec de l'appel. Codes d'erreur.
ErrorMessage	String	Une exception système s'est produite.	Le message d'erreur. Renvoyé uniquement si l'appel échoue.
RequestId	String	A01829CE-75A1-4920-B775-921146A1AB79	L'ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. Valeurs possibles : true : L'appel a réussi. false : L'appel a échoué.

Exemples

Exemples de requêtes

https://iot.cn-shanghai.aliyuncs.com/?Action=CancelOTATaskByDevice
&FirmwareId=T0F5b5tpFnHQrgfk****030100
&ProductKey=a1V4kde****
&DeviceName.1=deviceName1
&DeviceName.2=deviceName2
&<Common request parameters>

Exemples de réponses réussies

XML format

<CancelOTATaskByDeviceResponse>
    <RequestId>A01829CE-75A1-4920-B775-921146A1AB79</RequestId>
    <Success>true</Success>
</CancelOTATaskByDeviceResponse>

JSON format

{
  "RequestId": "A01829CE-75A1-4920-B775-921146A1AB79",
  "Success": true
}

Codes d'erreur

Codes d'erreur de service.