检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
回调地址可以使用域名吗？ 可以，IP和域名都支持。 使用域名时，如果域名绑定多个IP，需要做好DNS解析，确保DNS解析后的IP地址可达。这种情况下，推荐使用IP地址作为回调地址。 父主题： 订阅推送（联通用户专用）
如何获取证书？ 请按照以下途径获取： 设备侧Agent Lite的证书 应用服务器加载的平台证书 应用服务器订阅平台数据时，制作调测证书或购买证书。 父主题： 订阅推送（联通用户专用）
物联网平台采用HTTPS协议向应用服务器进行消息推送时，物联网平台需要校验应用服务器的真实性，需要在物联网平台上加载CA证书，该证书由应用服务器侧提供（调测时可自行制作调测证书，商用时建议更换为商用证书，否则会带来安全风险）。 推送机制：物联网平台向应用服务器推送消息后，如果应用服务器接收消息成功，会向物联网平台返回200
如何获取证书？ 请按照以下途径获取： 设备侧Agent Lite的证书 应用服务器加载的平台证书 应用服务器订阅平台数据时，制作调测证书或购买证书。 父主题： 应用集成（联通用户专用）
设备状态变化结果通知 接口说明 应用服务器在物联网平台订阅设备状态变化通知事件后（资源为device.status，事件为update），当物联网平台中的设备状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法
据，以及应用服务器对服务属性的配置（服务属性为设备Profile文件中定义的service属性）。若设备处于离线或异常状态时，应用服务器无法通过命令下发的方式向设备下发配置，此时可把要下发的配置设置到设备影子，当设备重新上线时，设备影子会把配置下发给设备。应用服务器可调用此接口在设备影子上修改要下发给设备的配置信息。
设备消息确认通知 接口说明 应用服务器在物联网平台订阅了设备消息确认通知后（订阅的通知类型为messageConfirm），当平台向设备下发命令，并收到设备返回的命令确认消息（如命令已送达、已执行等）时，平台会向应用服务器推送通知消息。 仅适用于使用MQTT协议接入的设备，例如集成了AgentLite
接口说明 应用服务器在物联网平台订阅了软件升级结果通知后（订阅的通知类型为swUpgradeResultNotify），当设备的软件升级任务执行完成时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
接口说明 应用服务器在物联网平台订阅了固件升级结果通知后（订阅的通知类型为fwUpgradeResultNotify），当设备的固件升级任务执行完成时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
批量删除订阅 接口说明 应用服务器若不再需要接收物联网平台推送的订阅通知消息，或者不再需要接收某类订阅通知消息，可调用此接口批量删除订阅配置，取消订阅，可删除全部订阅，或删除指定订阅类型的所有订阅，或删除指定回调URL地址的所有订阅。 URI 请求方法 DELETE URI /iocm/app/sub/v1
接口说明 应用服务器在物联网平台订阅了设备数据变化通知后（订阅的通知类型为deviceDataChanged），当设备上报单个服务属性数据时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址，回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口 2. 应用通过继承PushMessageReceiver类并重写回调接口接收推送消息的内容 3. 如果回调地址不是应用服务器本身的地址，则第三方应用需要自己实现原始
设备影子状态变更通知 接口说明 应用服务器在物联网平台订阅了设备影子状态变更通知后（订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged），当平台中的设备影子向设备同步数据成功或失败时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
查询设备影子历史数据 接口说明 应用服务器通过“修改设备影子”接口修改设备影子的配置时，物联网平台会保存修改记录。当应用服务器需要查看设备影子的历史配置记录时，可调用此接口查询获取。 URI 请求方法 GET URI /iocm/app/shadow/v1.5.0/deviceDesiredHistory
应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址，回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口。 应用通过PushMessageReceiver类并重写回调接口接收推送消息的内容。 如果回调地址不是应用服务器本身的地址，则第三方应用需要自己实现原始回调接
NS解析，确保DNS解析后的IP地址可达。 如果订阅地址是HTTPS地址，还有可能是服务端的证书制作有问题或者服务端证书对应的CA证书未上传至物联网平台。 调测时，请先确保证书制作过程无误，然后进行证书上传。 商用时，推荐向证书机构申请证书，然后参考设备管理平台上传证书进行证书上传。
接口说明 应用服务器在物联网平台订阅了设备数据批量变化通知后（订阅的通知类型为deviceDatasChanged），当设备同时上报多个服务属性数据时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
查询订阅列表 接口说明 应用服务器可调用此接口查询物联网平台中的订阅配置信息列表。 URI 请求方法 GET URI /v5/iot/{project_id}/subscriptions 传输协议 HTTPS 请求参数 名称 必选/可选 类型 位置 说明 X-Auth-Token
修改设备命令 接口说明 应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时应用服务器可调用此接口修改该命令的状态信息。仅能修改还处于PENDING状态的命令，且当前仅支持把命令状态修改为CANCELED状态，即撤销命令的执行。
创建设备命令撤销任务 接口说明 应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（PENDING状态），此时应用服务器可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 URI 请求方法 POST URI /iocm/app/cmd/v1
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
