检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备联动 设备触发告警并邮件或短信通知（联通用户专用） 温度过高时自动关闭设备（联通用户专用）
开发者需要在设备添加成功后注册该设备的命令接收广播，广播主题为 “IOTA_TOPIC_SERVICE_CMD_RECEIVE/设备ID”，Agent Lite收到平台发往给设备的命令后会直接广播给该设备注册的广播处理函数。如果开发者不需要按设备进行分发，直接使用主题名即可，即“ IOTA_TOPIC_SERVICE_CMD_RECEIVE”。
设备升级 查询版本包列表 查询指定版本包 删除指定版本包 创建软件升级任务 创建固件升级任务 查询指定升级任务结果 查询指定升级任务子任务详情 查询升级任务列表 父主题： 应用侧JAVA SDK API参考（联通用户专用）
设备升级 查询版本包列表 查询指定版本包 删除指定版本包 创建软件升级任务 创建固件升级任务 查询指定升级任务结果 查询指定升级任务子任务详情 查询升级任务列表 父主题： 应用侧Python SDK API参考（联通用户专用）
上报设备数据 接口功能 当直连设备（网关）有数据需要上报或者非直连设备上报数据到网关时，网关需要调用设备服务数据上报接口将数据上报到物联网平台。 上报设备数据接口的deviceId，requstId和serviceId由SDK组装为消息的header；servicePropert
DATATRANS_IE_DEVICEID 设备逻辑ID，在设备添加时由平台分配。 DATATRANS_IE_SERVICEID 服务ID。 DATATRANS_IE_METHOD 服务方法。 DATATRANS_IE_CMDCONTENT 命令内容。 示例 开发者注册广播接收器对设备命令接收结果进行相应的处理。
修改设备信息 典型场景 第三方应用在物联网平台注册设备后，若设备的基本信息发生变更，也可调用此接口在物联网平台修改设备的信息。 接口功能 支持第三方应用修改设备的基本信息，包括设备类型、设备模型、厂商信息、接入协议等。 接口描述 1 def modifyDeviceInfo(self
HUB_RESULT_DEVICE_EXIST 1 NA 设备已存在。 HUB_RESULT_DEVICE_NOTEXIST 2 NA 设备不存在。 HUB_RESULT_DEVICE_FAILED 255 NA 执行失败。 示例 1 2 //开发者调用该接口进行设备添加 HubService
添加设备 接口功能 当有新设备接入网关后，通过调用设备添加接口将非直连设备接入物联网平台，并且获得平台分配的唯一设备逻辑ID。 接口描述 1 HW_INT IOTA_HubDeviceAdd(HW_UINT uiCookie, const ST_IOTA_DEVICE_INFO *pstDeviceInfo);
接收设备命令 接口功能 调用设备命令接收接口来处理平台下发的控制命令。 接口描述 1 DataTransService.TOPIC_COMMAND_RECEIVE; 接口所属类 DataTransService 示例 开发者需要实现Agent Lite提供的观察者接口。 1
更新设备状态 接口功能 通过该接口更新设备的状态信息，包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。 直连设备状态通过设备的登录状态进行管理，当直连设备连接断开则表示设备离线，当直连设备连接或重连成功，则表示设备上线，无需通过该接口进行刷新。故建
更新设备状态 接口功能 通过该接口更新设备的状态信息，包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。 直连设备状态通过设备的登录状态进行管理，当直连设备连接断开则表示设备离线，当直连设备连接或重连成功，则表示设备上线，无需通过该接口进行刷新。故建
设备响应命令 接口说明 设备对物联网平台控制命令的应答。 应用服务器要需要调用“订阅平台业务数据”API订阅“commandRsp”类型的通知后，才能接收到设备对控制命令的应答。 Topic Topic /huawei/v1/devices/{deviceId}/data/{codecMode}
选择“设备 > 所有设备”，在设备列表中，单击具体的设备进入到设备的详情页面，即可查看设备注册和接入时的基本信息，比如设备标识码，设备ID，接入协议等。如下图所示，点击“编辑”按钮，可以对部分信息进行修改。 用户也可通过调用修改设备信息接口修改设备的基本信息。 查看设备状态 在
设备服务调用 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令，第三方应用可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令，设备不在线时命令下发失败。下发命令的具体格式需要第三方应用与设
修改设备信息 接口说明 应用服务器在物联网平台注册设备后，若设备的基本信息发生变更，可调用此接口在物联网平台修改设备的基本信息，包括设备类型、设备模型、厂商信息、接入协议等。 URI 请求方法 PUT URI /iocm/app/dm/v1.4.0/devices/{deviceId}
String 设备服务的ID。 cmd 必选 String 命令名称，在设备的产品模型中定义。 paras 必选 ObjectNode 命令参数，具体字段在设备的产品模型中定义。 mid 必选 Integer 命令ID，物联网平台内部分配（范围1-65535），设备响应平台命令时，需要返回该值。
设备接入服务如何获取设备数据？ 设备接入服务获取设备数据，需要通过规则引擎，将数据转发至其他服务获取。例如转发至OBS存储，转发至DIS或DMS后再发送至应用服务器。 需要注意的是设备接入服务不解析数据，若设备采用二进制上报数据，则平台进行码流base64封装后再转发。 父主题：
上报设备数据 接口功能 当直连设备（网关）有数据需要上报或者非直连设备上报数据到网关时，网关需要调用设备服务数据上报接口将数据上报到物联网平台。 上报设备数据接口的pcDeviceId、pcRequstId和pcServiceId由SDK组装为消息的header；pcServic
body 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 gatewayId 可选 String body 网关ID，用于标识一个网关设备。当设备是直连设备时，gatewayId与设备的deviceId一致。当设备是非直连设备时，gatewayId为设备所关联的直连设备（即网关）的deviceId。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
