检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询设备激活状态 接口说明 应用服务器通过“注册设备”接口在物联网平台注册设备后，在设备首次接入平台之前，设备的激活状态为false；当设备首次接入平台后，设备的激活状态为true（无论设备接入后是处于在线、离线或异常状态）。应用服务器可调用此接口查询设备在物联网平台的激活状态，确定设备是否已接入平台。
应用服务器如何获取设备的IMEI号？ 订阅bindDevice（绑定设备通知）后，真实设备接入时，物联网平台会推送IMEI号、deviceId等信息到应用服务器。详见API参考订阅平台业务数据接口。 父主题： 应用集成（联通用户专用）
创建设备命令撤销任务 接口说明 应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（PENDING状态），此时应用服务器可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 URI 请求方法 POST URI /iocm/app/cmd/v1
body 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 gatewayId 必选 String body 网关ID，用于标识一个网关设备。当设备是直连设备时，gatewayId与设备的deviceId一致。当设备是非直连设备时，gatewayId为设备所关联的直连设备（即网关）的deviceId。
查询指定设备组成员 接口说明 应用服务器若需要查看某个设备组中的设备成员分布情况，可调用此接口查询指定设备组的设备成员列表信息。 URI 请求方法 GET URI /iocm/app/dm/v1.2.0/devices/ids 传输协议 HTTPS 请求参数 参数 必选/可选 类型
设备事件通知 典型场景 第三方应用在物联网平台订阅了设备事件通知后（订阅的通知类型为deviceEvent），当平台收到设备上报的事件消息时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备事件通知的第三方应用推送通知消息。 注意事项 1. 应用在订阅平台业
设备事件通知 典型场景 第三方应用在物联网平台订阅了设备事件通知后（订阅的通知类型为deviceEvent），当平台收到设备上报的事件消息时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备事件通知的第三方应用推送通知消息。 注意事项 应用在订阅平台业务数据
订阅推送（联通用户专用） 非联通用户请查看设备接入服务。 概述 订阅：是指应用服务器通过调用物联网平台的“订阅平台业务数据”和“订阅平台管理数据”接口，向平台获取发生变更的设备业务信息（如设备注册、设备数据上报、设备状态等）和管理信息（软固件升级状态和升级结果）。 推送：是指订阅
注册设备（密码方式） 接口说明 在设备接入物联网平台前，应用服务器需要调用此接口在物联网平台注册设备，获取设备ID和密码。在设备接入物联网平台时携带设备ID和密码，完成设备的接入认证。 此注册设备接口适用于使用MQTT协议接入的设备。 URI 请求方法 POST URI /iocm/app/reg/v2
String(50) 设备组所属的应用ID。 maxDevNum Integer(>=0) 设备组设备最大数量限制，当值为0时，表示对设备数量不做限制。 curDevNum Integer 当前设备组内的设备数量。 creator String(1-50) 创建设备组的用户名称。 请求示例
String(1-64) 设备命令ID，用于唯一标识一条命令，在下发设备命令时由物联网平台分配获得。 appId String(1-64) 设备命令所属的应用ID。 deviceId String(1-64) 下发命令的设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。
应用服务器如何收到命令状态变化的通知？ 应用服务器调用创建设备命令接口时，配置callbackUrl参数（该参数的IP和端口需要和订阅回调地址的IP和端口一致），每次命令状态发生变化时，物联网平台将会向该地址推送消息。 父主题： 订阅推送（联通用户专用）
应用服务器如何获取设备上报到物联网平台的数据？ 有以下几种方式： 应用服务器调用查询设备历史数据接口，主动从物联网平台获取设备上报的数据。 应用服务器调用订阅平台业务数据接口，使物联网平台在设备上报数据时，主动将数据推送给应用服务器。 通过规则引擎数据转发规则，通过DIS或者DMS转发至应用服务器。
应用服务器如何获取物联网平台推送消息时使用的地址？ 应用服务器设置防火墙策略时，可向物联网平台支撑人员获取平台推送消息的地址。 父主题： 订阅推送（联通用户专用）
List<String> 设备组名称列表，最多支持256个设备组。 与指定设备列表方式二选一。 deviceType String 设备类型。 指定设备组时，此字段必选。 model String 设备型号。 指定设备组时，此字段必选。 manufacturerName String 设备厂商名称。
网关ID，用于标识一个网关设备。当设备是直连设备时，gatewayId与设备的deviceId一致。当设备是非直连设备时，gatewayId为设备所关联的直连设备（即网关）的deviceId。 appId 可选 String query 设备所属的应用ID，当查询授权应用下设备的服务能力时才需要填写。
删除子设备 若子设备不再需要接入物联网平台，应用服务器可调用此接口解绑网关下的子设备。 此功能通过设备命令下发接口向网关下发命令实现，具体删除子设备命令需网关提前实现（即网关收到什么命令会触发删除子设备的流程），并已在设备的Profile文件中定义。当网关收到平台下发的删除子设备命令时，则启动内部业务流程，删除子设备。
应用服务器下发命令失败，收到403的错误，提示回调地址冲突？ 通过开发中心的“订阅调试”界面或者调用“批量查询订阅”接口查看订阅地址。 同一个应用下，各订阅类型的回调地址的IP和端口号需要一致。 查看应用侧调用创建设备命令接口带的参数callbackurl，与订阅回调地址的IP和
List<String> body 设备组名称列表，最多支持256个设备组。 与指定设备列表方式二选一。 deviceType 可选 String(256) body 设备类型。 指定设备组时，此字段必选。 model 可选 String(256) body 设备型号。 指定设备组时，此字段必选。
List<String> body 设备组名称列表，最多支持256个设备组。 与指定设备列表方式二选一。 deviceType 可选 String(256) body 设备类型。 指定设备组时，此字段必选。 model 可选 String(256) body 设备型号。 指定设备组时，此字段必选。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
