检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
添加设备 接口功能 当有新设备接入网关后，通过调用设备添加接口将非直连设备接入物联网平台，并且获得平台分配的唯一设备逻辑ID。 接口描述 1 HW_INT IOTA_HubDeviceAdd(HW_UINT uiCookie, const ST_IOTA_DEVICE_INFO *pstDeviceInfo);
设备服务调用 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令，第三方应用可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令，设备不在线时命令下发失败。下发命令的具体格式需要第三方应用与设
查询设备影子 典型场景 若设备处于离线或异常状态时，第三方应用无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子，当设备重新上线时，设备影子会把配置下发给设备。第三方应用可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 接口功能 支持第三方
String 设备标识码，通常使用IMEI、MAC地址或Serial No作为nodeId。 gateway_id 可选 String 网关ID，用于标识一个网关设备。当设备是直连设备时，gatewayId与设备的deviceId一致。当设备是非直连设备时，gatewayId为设备所关联
body 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 gatewayId 可选 String body 网关ID，用于标识一个网关设备。当设备是直连设备时，gatewayId与设备的deviceId一致。当设备是非直连设备时，gatewayId为设备所关联的直连设备（即网关）的deviceId。
200 100428 The device is not online. 设备不在线。 处理建议：请检查设备与物联网平台的连接是否正常。 200 100431 The serviceType is not exist. 服务类型不存在。 处理建议： 请检查该设备的Profile文件是否已上传到物联网平台。
INACTIVE、ABNORMAL。 设备首次接入平台之前，设备的状态为INACTIVE。 若设备超过25（默认值）小时未向平台上报数据或发送消息，则设备状态为ABNORMAL（默认值）；若设备超过49小时未向平台上报数据或发送消息，则设备状态为OFFLINE。 statusDetail
下发的配置设置到设备影子，当设备重新上线时，设备影子会把配置下发给设备。第三方应用可调用此接口在设备影子上配置要下发给设备的配置信息。 每个设备有且只有一个设备影子，设备影子上有desired和report区。 desired区用于存储对设备服务属性的配置。若设备当前在线，des
String(1-64) 设备命令ID，用于唯一标识一条命令，在下发设备命令时由物联网平台分配获得。 appId String(1-64) 设备命令所属的应用ID。 deviceId String(1-64) 下发命令的设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。
修改设备信息 接口说明 应用服务器在物联网平台注册设备后，若设备的基本信息发生变更，可调用此接口在物联网平台修改设备的基本信息，包括设备类型、设备模型、厂商信息、接入协议等。 URI 请求方法 PUT URI /iocm/app/dm/v1.4.0/devices/{deviceId}
查询设备影子 典型场景 若设备处于离线或异常状态时，第三方应用无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子，当设备重新上线时，设备影子会把配置下发给设备。第三方应用可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 接口功能 支持第三方
修改设备命令 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时第三方应用可调用此接口修改该命令的状态信息。当前仅支持把命令状态修改为CANCELED状态，即撤销命令的执行。 接口功能 支持第三方应用修改指定命令的状
String 设备服务的ID。 cmd 必选 String 命令名称，在设备的产品模型中定义。 paras 必选 ObjectNode 命令参数，具体字段在设备的产品模型中定义。 mid 必选 Integer 命令ID，物联网平台内部分配（范围1-65535），设备响应平台命令时，需要返回该值。
修改设备组 典型场景 若因业务变更需要修改设备组的信息，如设备组名称、设备组的设备数量限制等，第三方应用可调用此接口修改指定设备组的信息。 接口功能 支持第三方应用在物联网平台修改指定设备组的信息。 接口描述 1 ModifyDeviceGroupOutDTO modifyDev
设备接收解绑定命令 接口功能 注册设备解绑定接收广播来接收处理平台下发的直连设备解绑定命令，开发者收到该广播后需要删除直连设备的配置信息并且释放所有资源，下一次重启后需要重新进行绑定。 接口描述 1 IOTA_TOPIC_CMD_UNBIND_RECEIVE; 示例 1 2 3
String(1-64) 设备命令ID，用于唯一标识一条命令，在下发设备命令时由物联网平台分配获得。 appId String(1-64) 设备命令所属的应用ID。 deviceId String(1-64) 下发命令的设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。
设备接收解绑定命令 接口功能 注册设备解绑定接收广播来接收处理平台下发的直连设备解绑定命令，开发者收到该广播后需要删除直连设备的配置信息并且释放所有资源，下一次重启后需要重新进行绑定。 接口描述 1 HubService.TOPIC_UNBINDDEVICE; 接口所属类 HubService。
设备接收解绑定命令 接口功能 被动接收平台下发的解绑定命令，删除直连设备的配置信息并且释放所有资源。(接收到此命令说明设备已经从平台侧删除。) 接口描述 1 HubService.TOPIC_UNBINDDEVICE; 接口所属类 HubService。 示例 调用该接口需要实现Agent
修改设备信息 典型场景 第三方应用在物联网平台注册设备后，若设备的基本信息发生变更，也可调用此接口在物联网平台修改设备的信息。 接口功能 支持第三方应用修改设备的基本信息，包括设备类型、设备模型、厂商信息、接入协议等。 接口描述 1 void modifyDeviceInfo(M
刷新设备密钥 典型场景 已在物联网平台注册的设备，若设备的唯一标识码发生变更（如更换设备等场景），第三方应用需要调用此接口在物联网平台更新设备的唯一标识，并重新绑定设备。 仅当设备处于离线状态时，才能进行刷新设备密钥操作。 接口功能 支持第三方应用在物联网平台更新已注册设备的no
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
