Cancele las tareas de actualización de dispositivos en estado Pending Confirmation, To Be Pushed, Pushed o In Upgrade para un paquete de actualización OTA.
Notas de uso
Esta operación solo cancela las tareas de actualización de dispositivos en estado Pending Confirmation, To Be Pushed, Pushed o In Upgrade.
Límites de QPS
Cada cuenta puede invocar esta operación hasta 10 veces por segundo.
Los usuarios de RAM comparten la cuota de la cuenta de Alibaba Cloud.
Depuración
Parámetros de solicitud
|
Parámetro |
Tipo |
Obligatorio |
Ejemplo |
Descripción |
|
Action |
String |
Sí |
CancelOTATaskByDevice |
La operación que desea ejecutar. Establezca el valor en |
|
ProductKey |
String |
Sí |
a1V4kde**** |
El ProductKey del producto al que pertenece el dispositivo. |
|
FirmwareId |
String |
Sí |
T0F5b5tpFnHQrgfk****030100 |
El ID único del paquete de actualización OTA. La operación CreateOTAFirmware devuelve este ID al crear un paquete de actualización. También puede llamar a ListOTAFirmware para consultar los ID de los paquetes de actualización. |
|
DeviceName.N |
RepeatList |
Sí |
device1 |
Los nombres de los dispositivos cuyas actualizaciones se cancelarán. Cada nombre de dispositivo debe ser único. Máximo: 200 nombres de dispositivo. |
|
JobId |
String |
No |
wahVIzGkCMuAUE2gDERM02**** |
El ID del lote de actualización. Si se especifica, solo se cancelan las tareas de dicho lote. Devuelto por CreateOTAVerifyJob, CreateOTAStaticUpgradeJob o CreateOTADynamicUpgradeJob como parámetro JobId. También puede encontrar el ID del lote en la página Update Package Details de la consola de IoT Platform. |
|
IotInstanceId |
String |
No |
iot_instc_pu**_c-v64* |
El ID de la instancia. Puede consultarlo en la página Overview de la consola de IoT Platform. Importante
|
Esta operación también requiere los parámetros de solicitud comunes.
Parámetros de respuesta
|
Parámetro |
Tipo |
Ejemplo |
Descripción |
|
Code |
String |
iot.system.SystemException |
El código de error devuelto si la llamada falla. Códigos de error. |
|
ErrorMessage |
String |
A system exception occurred. |
El mensaje de error. Se devuelve únicamente si la llamada falla. |
|
RequestId |
String |
A01829CE-75A1-4920-B775-921146A1AB79 |
El ID de la solicitud. |
|
Success |
Boolean |
true |
Indica si la llamada se ejecutó correctamente. Valores válidos:
|
Ejemplos
Solicitudes de ejemplo
https://iot.cn-shanghai.aliyuncs.com/?Action=CancelOTATaskByDevice
&FirmwareId=T0F5b5tpFnHQrgfk****030100
&ProductKey=a1V4kde****
&DeviceName.1=deviceName1
&DeviceName.2=deviceName2
&<Common request parameters>Respuestas exitosas de ejemplo
Formato XML
<CancelOTATaskByDeviceResponse>
<RequestId>A01829CE-75A1-4920-B775-921146A1AB79</RequestId>
<Success>true</Success>
</CancelOTATaskByDeviceResponse>Formato JSON
{
"RequestId": "A01829CE-75A1-4920-B775-921146A1AB79",
"Success": true
}