检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备绑定 接口功能 设备第一次接入物联网平台时需要进行绑定操作，上层应用通过调用该接口传入设备序列号或者MAC地址以及设备信息来绑定到物联网平台。 在绑定前需要调用BindConfig.setConfig接口设置物联网平台的IP与端口。 设备绑定是指设备第一次接入物联网平台的过程
String path 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 appId 可选 String query 设备所属的应用ID，当删除授权应用下的设备时才需要填写。 cascade 可选 Boolean query 仅当设备下连接了非直连设备时生效。默认值为true。
删除设备 典型场景 已在物联网平台注册的设备，若不再需要接入平台时，第三方应用可调用此接口在物联网平台删除设备。后续若设备要再次接入平台，第三方应用需要在物联网平台重新注册设备。 接口功能 支持第三方应用在物联网平台删除已注册的设备，使设备无法再接入平台。 接口描述 1 void
删除设备 典型场景 已在物联网平台注册的设备，若不再需要接入平台时，第三方应用可调用此接口在物联网平台删除设备。后续若设备要再次接入平台，第三方应用需要在物联网平台重新注册设备。 接口功能 支持第三方应用在物联网平台删除已注册的设备，使设备无法再接入平台。 接口描述 1 def
INACTIVE、ABNORMAL。 设备首次接入平台之前，设备的状态为INACTIVE。 若设备超过25（默认值）小时未向平台上报数据或发送消息，则设备状态为ABNORMAL（默认值）；若设备超过49小时未向平台上报数据或发送消息，则设备状态为OFFLINE。 statusDetail
设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 gatewayId 可选 String body 网关ID，用于标识一个网关设备。当设备是直连设备时，gatewayId与设备的deviceId一致。当设备是非直连设备时，gatewayId为设备所关联的直连设备（即网关）的deviceId。
删除子设备 若子设备不再需要接入物联网平台，应用服务器可调用此接口解绑网关下的子设备。 此功能通过设备命令下发接口向网关下发命令实现，具体删除子设备命令需网关提前实现（即网关收到什么命令会触发删除子设备的流程），并已在设备的Profile文件中定义。当网关收到平台下发的删除子设备命令时，则启动内部业务流程，删除子设备。
设备服务调用 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令，第三方应用可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令，设备不在线时命令下发失败。下发命令的具体格式需要第三方应用与设
FG_IOCM_PORT。 设备绑定是指设备第一次接入物联网平台的过程，需要开发者先在物联网平台注册直连设备，之后在设备上发起绑定操作，将设备绑定到物联网平台上。如果未在物联网平台注册该设备，则绑定操作会失败，Agent Lite将会等待一段时间继续尝试。 接口描述 1 HW_INT
设备绑定 接口功能 设备第一次接入物联网平台时需要进行绑定操作，上层应用通过调用该接口传入设备序列号或者MAC地址以及设备信息来绑定到物联网平台。 在绑定前需要调用绑定配置接口设置物联网平台的IP与端口。 设备绑定是指设备第一次接入物联网平台的过程，需要开发者先在物联网平台注册直
设备影子状态变更通知 典型场景 第三方应用在物联网平台订阅了设备影子状态变更通知后（订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged），当平台中的设备影子向设备同步数据成功或失败时，平台会向第三方应用推送通知消息。 接口功能 支
设备升级 查询版本包列表 查询指定版本包 删除指定版本包 创建软件升级任务 创建固件升级任务 查询指定任务信息 查询指定任务的子任务详情 查询任务列表 父主题： 应用侧API参考（联通用户专用）
设备升级 查询版本包列表 查询指定版本包 删除指定版本包 创建软件升级任务 创建固件升级任务 查询指定升级任务结果 查询指定升级任务子任务详情 查询升级任务列表 父主题： 应用侧JAVA SDK API参考（联通用户专用）
设备升级 查询版本包列表 查询指定版本包 删除指定版本包 创建软件升级任务 创建固件升级任务 查询指定升级任务结果 查询指定升级任务子任务详情 查询升级任务列表 父主题： 应用侧Python SDK API参考（联通用户专用）
String(1-64) 设备命令ID，用于唯一标识一条命令，在下发设备命令时由物联网平台分配获得。 appId String(1-64) 设备命令所属的应用ID。 deviceId String(1-64) 下发命令的设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。
Lite的连接状态广播。 需要提前实现连接状态通知广播接收处理函数，建议： 对于网关设备，在连接成功的处理函数中需要进行非直连设备状态上报的处理，并且将缓存的所有上报数据进行上报。 在连接断开的处理函数中记录设备断开状态，之后如果有数据上报，需要进行缓存，等到连接成功后再进行上报。 1 2 3
然后等待Agent Lite的连接状态广播。 建议： 在连接成功的处理函数中进行非直连设备状态上报的处理，并且将缓存的上报数据进行上报。 在连接断开的处理函数中记录设备断开状态，之后如果有非直连设备上报数据，需要进行缓存，等到连接成功后再进行上报。 1 2 3 4 5 6
修改设备信息 典型场景 第三方应用在物联网平台注册设备后，若设备的基本信息发生变更，也可调用此接口在物联网平台修改设备的信息。 接口功能 支持第三方应用修改设备的基本信息，包括设备类型、设备模型、厂商信息、接入协议等。 接口描述 1 def modifyDeviceInfo(self
修改设备信息 接口说明 应用服务器在物联网平台注册设备后，若设备的基本信息发生变更，可调用此接口在物联网平台修改设备的基本信息，包括设备类型、设备模型、厂商信息、接入协议等。 URI 请求方法 PUT URI /iocm/app/dm/v1.4.0/devices/{deviceId}
查询设备激活状态 典型场景 第三方应用通过“注册设备”接口在物联网平台注册设备后，在设备首次接入平台之前，设备的激活状态为false；当设备首次接入平台后，设备的激活状态为true（无论设备接入后是处于在线、离线或异常状态）。第三方应用可调用此接口查询设备在物联网平台的激活状态，确定设备是否已接入平台。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
