system.upgrade.failed (Upgrade failed)
system.upgrade.failed: Upgrade failed
system.upgrade.failed · device scope · message query permission Alarm
What it does
Reported when upgrade fails. After subscribing to capabilityEvent, see Receive device messages and setMessageCallback; Event catalog · Overview and common payload. compose merges multiple idents; outputData may be {} or omit errCode.
Reported fields
Fields inside outputData. Platform fields: Overview and common payload.
| Name | Description | Type | Required | Values |
|---|---|---|---|---|
errCode | Error code. 0 upgrade failed, 1 battery too low. | enum | no | 0 upgrade failed; 1 battery too low |
Example
{
"msgType": "system.upgrade.failed",
"deviceId": "TESTIPC000012345",
"productId": "56WGTET2",
"outputData": {
"errCode": "0"
},
"time": 1673406989,
"localTime": "20230111T111629",
"alarmId": "116257862023505xxxx"
}
Minimum permission
The administrator does not need an extra permission on a device they bound. A shared device needs the alarm message permission. A bound sub-user does not. When a sub-account queries messages for this event, each message is checked against the capability row share/sub codes (system.upgrade is usually Config). list / search filters out events without permission. Upgrade.