检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
删除设备通知 接口说明 应用服务器在物联网平台订阅了删除设备通知后(订阅的通知类型为deviceDeleted),当设备在物联网平台中被删除后,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
据,以及应用服务器对服务属性的配置(服务属性为设备Profile文件中定义的service属性)。若设备处于离线或异常状态时,应用服务器无法通过命令下发的方式向设备下发配置,此时可把要下发的配置设置到设备影子,当设备重新上线时,设备影子会把配置下发给设备。应用服务器可调用此接口在设备影子上修改要下发给设备的配置信息。
订阅推送(联通用户专用) 调用订阅接口时,回调地址如何获取? 应用服务器如何收到命令状态变化的通知? 如何获取证书? 回调地址可以使用域名吗? 订阅后消息推送失败,例如提示503如何处理? 应用服务器收到数据,但是平台显示推送失败? 应用服务器只有内网地址,能否订阅成功? 调用订阅接口时,提示回调地址不合法?
PLAIN:SASL/PLAIN模式。需要填写对应的用户名密码信息。 表14 NetAddress 名称 必选/可选 类型 说明 ip 可选 String 服务的对应IP port 可选 Integer(<=65535) 服务对应端口 domain 可选 String 服务对应的域名 响应参数
设备服务能力增加通知 接口说明 应用服务器在物联网平台订阅了设备服务能力增加通知后(订阅的通知类型为deviceCapabilitiesAdded),在物联网平台上新增设备Profile文件时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI
设备服务能力删除通知 接口说明 应用服务器在物联网平台订阅了设备服务能力删除通知后(订阅的通知类型为deviceCapabilitiesDeleted),在物联网平台上删除设备Profile文件时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI
设备服务能力变化通知 接口说明 应用服务器在物联网平台订阅了设备服务能力变化通知后(订阅的通知类型为deviceCapabilitiesChanged),在物联网平台上设备Profile文件中的服务和属性被修改时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。
设备消息确认通知 接口说明 应用服务器在物联网平台订阅了设备消息确认通知后(订阅的通知类型为messageConfirm),当平台向设备下发命令,并收到设备返回的命令确认消息(如命令已送达、已执行等)时,平台会向应用服务器推送通知消息。 仅适用于使用MQTT协议接入的设备,例如集成了AgentLite
推送通知 应用服务器向物联网平台订阅设备信息,当设备信息发生变更时,物联网平台向应用服务器推送此消息,应用服务器根据通知类型对消息分派处理。需要配合订阅管理接口使用。 注册设备通知 绑定设备通知 设备信息变化通知 设备数据变化通知 设备数据批量变化通知 设备服务能力变化通知 设备服务能力增加通知
pem)、应用服务器证书(server.cer/server.crt/server.pem)和私钥文件(server_private.key)。其中CA证书用于加载到物联网平台,应用服务器证书和私钥文件用于加载到应用服务器。 加载证书 物联网平台采用HTTPS协议向应用服务器推送消息时
PAAS:非SASL鉴权。 PLAIN:SASL/PLAIN模式。需要填写对应的用户名密码信息。 表15 NetAddress 名称 类型 说明 ip String 服务的对应IP port Integer(<=65535) 服务对应端口 domain String 服务对应的域名 请求示例 GET h
接口说明 应用服务器通过物联网平台创建设备命令时,如果设置了callbackurl回调地址,当命令状态变化时(执行失败,执行成功,超时,发送,已送达),平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器下发命
绑定设备通知 接口说明 应用服务器在物联网平台订阅了绑定设备通知后(订阅的通知类型为bindDevice),当设备接入并绑定物联网平台时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
物联网平台对接入平台的设备进行鉴权认证。待真实设备上电后,设备可以上报数据到物联网平台,物联网平台根据应用服务器的订阅消息类型,把消息推送给应用服务器。 订阅推送 订阅:是指应用服务器通过调用物联网平台的API接口,向平台获取发生变更的设备业务信息(如设备注册、设备数据上报、设备状态等)和管理信息(软固件升级状态和升级结果)。
订阅管理-V3 物联网平台支持应用服务器对设备数据的订阅,若订阅的设备信息有变更,平台会推送给应用服务器。消息订阅接口需要与推送通知接口配合使用。 订阅平台业务数据 订阅平台管理数据 查询单个订阅 批量查询订阅 删除单个订阅 批量删除订阅 推送通知 父主题: 应用侧API参考(联通用户专用)
PAAS:非SASL鉴权。 PLAIN:SASL/PLAIN模式。需要填写对应的用户名密码信息。 表14 NetAddress 名称 类型 说明 ip String 服务的对应IP port Integer(<=65535) 服务对应端口 domain String 服务对应的域名 请求示例 GET h
删除单个订阅 接口说明 应用服务器若不再需要接收物联网平台推送的某个订阅通知消息时,可调用此接口删除指定的订阅配置,取消订阅。 URI 请求方法 DELETE URI /iocm/app/sub/v1.2.0/subscriptions/{subscriptionId} 传输协议 HTTPS
设备信息变化通知 接口说明 应用服务器在物联网平台订阅了设备信息变化通知后(订阅的通知类型为deviceInfoChanged),当设备的配置或状态信息(如设备厂商信息、位置信息、版本信息、在线状态信息等)发生变化时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。
实例ID。物理多租下各实例的唯一标识,一般华为云租户无需携带该参数,仅在物理多租场景下从管理面访问API时需要携带该参数。 project_id 必选 String Path 项目ID。获取方法请参见 获取项目ID。 name 必选 String(1-128) Body 规则名称。 description 可选
删除设备组 接口说明 若因分组变更,应用服务器不再需要使用某个设备组,且不想在物联网平台上继续保存该设备组信息时,可调用此接口在物联网平台删除指定设备组。 URI 请求方法 DELETE URI /iocm/app/devgroup/v1.3.0/devGroups/{devGroupId}