检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
支持SNI 默认不勾选,如果接收推送消息的服务器存在多个服务器使用同一个“IP+端口”,则需要勾选支持SNI,“CNNAME”填写需要接收消息的服务器的域名地址,以便服务器根据指定的域名携带对应的设备证书。 使用设备证书 保持默认值:关闭 常见问题 订阅推送业务热点咨询问题如下,更多咨询问题请点击查看更多。
如何获取证书? 请按照以下途径获取: 设备侧Agent Lite的证书 应用服务器加载的平台证书 应用服务器订阅平台数据时,制作调测证书或购买证书。 父主题: 应用集成(联通用户专用)
如何获取证书? 请按照以下途径获取: 设备侧Agent Lite的证书 应用服务器加载的平台证书 应用服务器订阅平台数据时,制作调测证书或购买证书。 父主题: 订阅推送(联通用户专用)
设备状态变化结果通知 接口说明 应用服务器在物联网平台订阅设备状态变化通知事件后(资源为device.status,事件为update),当物联网平台中的设备状态发生变化时,平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时,请务必返回响应码。 URI 请求方法
批量删除订阅 接口说明 应用服务器若不再需要接收物联网平台推送的订阅通知消息,或者不再需要接收某类订阅通知消息,可调用此接口批量删除订阅配置,取消订阅,可删除全部订阅,或删除指定订阅类型的所有订阅,或删除指定回调URL地址的所有订阅。 URI 请求方法 DELETE URI /iocm/app/sub/v1
修改设备命令 接口说明 应用服务器向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行,此时应用服务器可调用此接口修改该命令的状态信息。仅能修改还处于PENDING状态的命令,且当前仅支持把命令状态修改为CANCELED状态,即撤销命令的执行。 URI 请求方法
创建设备命令撤销任务 接口说明 应用服务器向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行(PENDING状态),此时应用服务器可调用此接口撤销指定设备的所有未下发的命令,对于已下发成功的命令不可撤销。 URI 请求方法 POST URI /iocm/app/cmd/v1
若设备处于离线或异常状态时,应用服务器无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子,当设备重新上线时,设备影子会把配置下发给设备。应用服务器可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 注意事项 当前仅使用LWM2M协议的设备支持设备影子功能
批量查询订阅 接口说明 应用服务器可在物联网平台上创建多个订阅,以订阅不同类型的设备变更通知。应用服务器若需要查看本应用下所有订阅配置,或者查看某种订阅类型下的所有订阅配置,可调用此接口进行查询。 URI 请求方法 GET URI /iocm/app/sub/v1.2.0/subscriptions
er与port为应用服务器公网地址与服务器配置中指定的端口。 应用通过PushMessageReceiver类并重写回调接口接收推送消息的内容。 如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回调接口,接口内容请参考物联网平台API参考中的消息推送章节。 接口描述
的回调地址,回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口 2. 应用通过继承PushMessageReceiver类并重写回调接口接收推送消息的内容 3. 如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回调接口。 接口描述 回调地址
gatewayId为设备所关联的直连设备(即网关)的deviceId。 appId String(256) 设备所属的应用ID。 desired JsonObject 要向设备下发的配置信息。 timestamp String(256) 数据配置的UTC时间,时间格式:yyyyM
设备发起的请求:/devices/{deviceId} 设备服务发起的请求:/devices/{deviceId}/services/{serviceId} to 必选 String(1-128) body 表示消息接收者的地址,To就是订阅请求中的From,如应用服务器的userId。 status 必选 String(1-32)
订阅的主题信息,即订阅的资源变化事件。 callbackurl String 订阅的回调地址,用于接收对应资源事件的通知消息。 channel String 物联网平台推送通知消息时使用的协议通道。使用“http”填充,表示该订阅推送协议通道为http(s)协议。 表2 Subject 名称 类型
接口说明 应用服务器在物联网平台订阅了绑定设备通知后(订阅的通知类型为bindDevice),当设备接入并绑定物联网平台时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
subject Subject Object 订阅的主题信息,即订阅的资源变化事件。 callbackurl String 订阅的回调地址,用于接收对应资源事件的通知消息。 channel String 物联网平台推送通知消息时使用的协议通道。使用“http”填充,表示该订阅推送协议通道为http(s)协议。
设备发起的请求:/devices/{deviceId} 设备服务发起的请求:/devices/{deviceId}/services/{serviceId} to 必选 String(1-128) body 表示消息接收者的地址,To就是订阅请求中的From,如应用服务器的userId。 deviceId 必选
批量创建设备命令 应用服务器若需要向多个设备下发相同的设备命令时,可调用此接口向批量设备下发命令。 此功能通过创建批量任务接口向设备下发批量任务实现,“taskType”参数设置为“DeviceCmd”时,为向批量设备下发命令。 父主题: 命令下发
NB-IoT设备、集成Agent Lite SDK的设备:设备通过注册时填写的“设备标识码”和“预置密钥”接入平台。 无真实设备时可随意填写英文字母和数字的组合字符串。 预置密钥 NB-IoT设备、集成Agent Lite SDK的设备接入时,用于设备和物联网平台之间的传输通道安全加密。 原生MQTT设备接入时,暂无作用,可随意填写。
应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址,回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口。 应用通过PushMessageReceiver类并重写回调接口接收推送消息的内容。 如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回