检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询订阅 接口说明 应用服务器可调用此接口查询物联网平台中指定订阅的配置信息。 URI 请求方法 GET URI /v5/iot/{project_id}/subscriptions/{subscription_id} 传输协议 HTTPS 请求参数 名称 必选/可选 类型 位置
查询订阅列表 接口说明 应用服务器可调用此接口查询物联网平台中的订阅配置信息列表。 URI 请求方法 GET URI /v5/iot/{project_id}/subscriptions 传输协议 HTTPS 请求参数 名称 必选/可选 类型 位置 说明 X-Auth-Token
创建批量任务 接口说明 应用服务器若需要对多个设备进行批量操作时，可调用此接口创建设备的批量操作任务，当前仅支持给批量设备下发缓存命令。 URI 请求方法 POST URI /iocm/app/batchtask/v1.1.0/tasks 传输协议 HTTPS 请求参数 参数 必选/可选
查询设备激活状态 接口说明 应用服务器通过“注册设备”接口在物联网平台注册设备后，在设备首次接入平台之前，设备的激活状态为false；当设备首次接入平台后，设备的激活状态为true（无论设备接入后是处于在线、离线或异常状态）。应用服务器可调用此接口查询设备在物联网平台的激活状态，确定设备是否已接入平台。
绑定设备通知 接口说明 应用服务器在物联网平台订阅了绑定设备通知后（订阅的通知类型为bindDevice），当设备接入并绑定物联网平台时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
批量删除订阅 接口说明 应用服务器若不再需要接收物联网平台推送的订阅通知消息，或者不再需要接收某类订阅通知消息，可调用此接口批量删除订阅配置，取消订阅，可删除全部订阅，或删除指定订阅类型的所有订阅，或删除指定回调URL地址的所有订阅。 URI 请求方法 DELETE URI /iocm/app/sub/v1
设备信息变化通知 接口说明 应用服务器在物联网平台订阅了设备信息变化通知后（订阅的通知类型为deviceInfoChanged），当设备的配置或状态信息（如设备厂商信息、位置信息、版本信息、在线状态信息等）发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
设备消息确认通知 接口说明 应用服务器在物联网平台订阅了设备消息确认通知后（订阅的通知类型为messageConfirm），当平台向设备下发命令，并收到设备返回的命令确认消息（如命令已送达、已执行等）时，平台会向应用服务器推送通知消息。 仅适用于使用MQTT协议接入的设备，例如集成了AgentLite
订阅推送（联通用户专用） 调用订阅接口时，回调地址如何获取？ 应用服务器如何收到命令状态变化的通知？ 如何获取证书？ 回调地址可以使用域名吗？ 订阅后消息推送失败，例如提示503如何处理？ 应用服务器收到数据，但是平台显示推送失败？ 应用服务器只有内网地址，能否订阅成功？ 调用订阅接口时，提示回调地址不合法？
删除单个订阅 接口说明 应用服务器若不再需要接收物联网平台推送的某个订阅通知消息时，可调用此接口删除指定的订阅配置，取消订阅。 URI 请求方法 DELETE URI /iocm/app/sub/v1.2.0/subscriptions/{subscriptionId} 传输协议
查询设备影子历史数据 典型场景 第三方应用通过“修改设备影子”接口修改设备影子的配置时，物联网平台会保存修改记录。当第三方应用需要查看设备影子的历史配置记录时，可调用此接口查询获取。 接口功能 支持第三方应用根据设备ID，在物联网平台查询指定设备影子的历史配置数据。 接口描述 1
设备命令响应通知 接口说明 应用服务器在物联网平台订阅了设备命令响应通知后（订阅的通知类型为commandRsp），当平台向设备下发命令，并收到设备返回的命令响应消息（如命令执行成功或者执行失败，设备要向平台返回指定内容响应）时，平台会向应用服务器推送通知消息。 仅适用于使用MQ
查询版本包列表 接口说明 在进行设备版本升级前，应用服务器可调用此接口查询已经上传到物联网平台的版本升级包列表信息，确保设备要升级的版本包已上传到平台，可根据条件查询满足要求的版本包。 URI 请求方法 GET URI /iodm/northbound/v1.5.0/category
查询设备影子历史数据 典型场景 第三方应用通过“修改设备影子”接口修改设备影子的配置时，物联网平台会保存修改记录。当第三方应用需要查看设备影子的历史配置记录时，可调用此接口查询获取。 接口功能 支持第三方应用根据设备ID，在物联网平台查询指定设备影子的历史配置数据。 接口描述 1
值，由于设备可能长时间处于离线状态，修改设备属性值的操作不能及时下发给设备。在这种情况下，物联网平台可以将修改设备的属性信息存储在设备影子中，待设备上线后，将修改的设备属性值同步给设备，从而完成设备属性值的修改。 业务流程 修改设备属性值 修改desired属性值，如果设备在线，
对于设备上报的数据，即使创建应用时开启了存储数据能力，设备管理服务也只保存7天的历史数据。 若您希望长期保存数据，可以选择让平台将设备上报数据推送给应用服务器，由应用服务器进行保存；还可以选择让平台将设备上报数据转发给对象存储服务（OBS），由OBS进行存储。 本示例为将所有设备上报的数据转发至OBS存储。
查询指定设备组成员 接口说明 应用服务器若需要查看某个设备组中的设备成员分布情况，可调用此接口查询指定设备组的设备成员列表信息。 URI 请求方法 GET URI /iocm/app/dm/v1.2.0/devices/ids 传输协议 HTTPS 请求参数 参数 必选/可选 类型
物联网平台支持设备数据上报和设备命令下发，但若要将两者联动起来，一般需要由应用服务器实现对应逻辑。 设备管理服务提供规则引擎功能，平台上简单几步操作即可实现数据上报特定数据时平台自动下发指定命令，减少应用服务器开发工作量。 本示例为设备自带的温度传感器上报的温度大于80度时，平台自动下发命令关闭设备。
查询指定设备组 接口说明 应用服务器若需要查看某个设备组的信息，以了解该设备组的使用情况，可调用此接口查询指定设备组的信息。 URI 请求方法 GET URI /iocm/app/devgroup/v1.3.0/devGroups/{devGroupId} 传输协议 HTTPS 请求参数
设备响应命令 接口说明 设备对物联网平台控制命令的应答。 应用服务器要需要调用“订阅平台业务数据”API订阅“commandRsp”类型的通知后，才能接收到设备对控制命令的应答。 Topic Topic /huawei/v1/devices/{deviceId}/data/{codecMode}
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
