文档首页 > > API参考> 应用侧JAVA SDK API参考> 消息推送> 软件升级结果变更通知

软件升级结果变更通知

分享
更新时间: 2019/11/12 GMT+08:00

典型场景

第三方应用在物联网平台订阅了软件升级结果通知后(订阅的通知类型为swUpgradeResultNotify),当设备的软件升级任务执行完成时,平台会向第三方应用推送通知消息。

接口功能

支持物联网平台向订阅了软件升级结果通知的第三方应用推送通知消息。

注意事项

1. 应用在订阅平台管理数据时需要订阅接口描述中的指定回调地址,回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口

2. 应用通过继承PushMessageReceiver类并重写回调接口接收推送消息的内容

3. 如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回调接口,接口内容请参考物联网平台API参考中的消息推送章节。

接口描述

回调地址

https://server:port/v1.0.0/messageReceiver

回调接口

void handleSwUpgradeResult(NotifySwUpgradeResultDTO body)

接口所属类

PushMessageReceiver

参数说明

NotifySwUpgradeResultDTO

参数

必选/可选

类型

位置

描述

notifyType

必选

String

body

通知类型,取值:swUpgradeResultNotify。

deviceId

必选

String

body

设备ID,用于唯一标识一个设备。

appId

必选

String

body

设备所属应用的应用ID。

operationId

必选

String

body

软件升级任务ID。

subOperationId

必选

String

body

软件升级子任务ID。

curVersion

必选

String

body

设备当前的软件版本。

targetVersion

必选

String

body

设备要升级的目标软件版本。

sourceVersion

必选

String

body

设备的源软件版本。

swUpgradeResult

必选

String

body

软件升级结果。

  • SUCCESS:设备升级成功
  • FAIL:设备升级失败

upgradeTime

必选

String

body

升级时长。

resultDesc

必选

String

body

升级结果描述。

errorCode

必选

String

body

设备上报的状态错误码。

description

必选

String

body

错误原因描述。

响应参数

Status Code: 200 OK

请求示例

Method: POST
request: {callbackUrl}
Header:
Content-Type:application/json
Body:
{
    "notifyType":"swUpgradeResultNotify",
    "deviceId":"******",
    "appId":"***********",
    "operationId":"***********",
    "subOperationId":"***********",
    "curVersion":"1.3",
    "targetVersion":"1.5",
    "sourceVersion":"1.0",
    "swUpgradeResult":"SUCCESS",
    "upgradeTime":"***",
    "resultDesc":"***",
    "errorCode":"***",
    "description":"***"
}

响应示例

response:
Status Code: 200 OK
分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区