检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
callbackUrl 必选 String(1024) body 订阅的回调地址，用于接收对应类型的通知消息。 可使用HTTPS或HTTP回调地址，建议使用HTTPS。回调地址支持IP地址或域名格式，同时回调地址中必须指定回调地址的端口。例如：https://XXX.XXX.XXX.XXX:443/callbackurltest
subject Subject Object 订阅的主题信息，即订阅的资源变化事件。 callbackurl String 订阅的回调地址，用于接收对应资源事件的通知消息。 channel String 物联网平台推送通知消息时使用的协议通道。使用“http”填充，表示该订阅推送协议通道为http(s)协议。
接口说明 应用服务器在物联网平台订阅了注册设备通知后（订阅的通知类型为deviceAdded），当应用服务器通过“注册设备”接口在平台注册设备时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
如何获取证书？ 请按照以下途径获取： 设备侧Agent Lite的证书 应用服务器加载的平台证书 应用服务器订阅平台数据时，制作调测证书或购买证书。 父主题： 订阅推送（联通用户专用）
接口说明 应用服务器在物联网平台订阅了设备属性变化通知后（订阅的资源为device.data，事件为update），当设备上属性数据时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅设备属性变化通知的callbackUrl决定
如何获取证书？ 请按照以下途径获取： 设备侧Agent Lite的证书 应用服务器加载的平台证书 应用服务器订阅平台数据时，制作调测证书或购买证书。 父主题： 应用集成（联通用户专用）
设备状态变化结果通知 接口说明 应用服务器在物联网平台订阅设备状态变化通知事件后（资源为device.status，事件为update），当物联网平台中的设备状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法
gatewayId为设备所关联的直连设备（即网关）的deviceId。 appId String(256) 设备所属的应用ID。 desired JsonObject 要向设备下发的配置信息。 timestamp String(256) 数据配置的UTC时间，时间格式：yyyyM
回调地址可以修改吗？ 可以。如果回调地址的IP和端口号需要更换，需要调用“批量删除订阅”接口，删除之前的回调地址后，并上传新的CA证书，再重新订阅。 父主题： 订阅推送（联通用户专用）
批量查询订阅 接口说明 应用服务器可在物联网平台上创建多个订阅，以订阅不同类型的设备变更通知。应用服务器若需要查看本应用下所有订阅配置，或者查看某种订阅类型下的所有订阅配置，可调用此接口进行查询。 URI 请求方法 GET URI /iocm/app/sub/v1.2.0/subscriptions
物联网平台支持创建设备的“影子”。设备影子用于存储设备最新上报的服务属性数据，以及应用服务器对服务属性的配置（服务属性为设备Profile文件中定义的service属性）。若设备处于离线或异常状态时，应用服务器无法通过命令下发的方式向设备下发配置，此时可把要下发的配置设置到设备影子，
创建设备命令撤销任务 接口说明 应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（PENDING状态），此时应用服务器可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 URI 请求方法 POST URI /iocm/app/cmd/v1
接口说明 应用服务器在物联网平台订阅了删除设备通知后（订阅的通知类型为deviceDeleted），当设备在物联网平台中被删除后，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
接口说明 应用服务器在物联网平台订阅了软件升级结果通知后（订阅的通知类型为swUpgradeResultNotify），当设备的软件升级任务执行完成时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
接口说明 应用服务器在物联网平台订阅了固件升级结果通知后（订阅的通知类型为fwUpgradeResultNotify），当设备的固件升级任务执行完成时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
修改设备命令 接口说明 应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时应用服务器可调用此接口修改该命令的状态信息。仅能修改还处于PENDING状态的命令，且当前仅支持把命令状态修改为CANCELED状态，即撤销命令的执行。 URI 请求方法
软件升级状态变更通知 接口说明 应用服务器在物联网平台订阅了软件升级状态变更通知后（订阅的通知类型为swUpgradeStateChangeNotify），当设备进行软件升级，升级任务的状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
订阅的主题信息，即订阅的资源变化事件。 callbackurl String 订阅的回调地址，用于接收对应资源事件的通知消息。 channel String 物联网平台推送通知消息时使用的协议通道。使用“http”填充，表示该订阅推送协议通道为http(s)协议。 表2 Subject 名称 类型
设备发起的请求：/devices/{deviceId} 设备服务发起的请求：/devices/{deviceId}/services/{serviceId} to 必选 String(1-128) body 表示消息接收者的地址，To就是订阅请求中的From，如应用服务器的userId。 status 必选 String(1-32)
String body 访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。此处填写授权应用的appId。 deviceType 必选 String body 设备的类型。 manufacturerName 必选 String body 设备模型的厂商名称。 manufacturerId
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
