检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
创建设备组 典型场景 第三方应用可调用此接口在物联网平台上创建设备组,并把设备归类到不同的设备组内,进行分组管理。一个设备可以归属到多个设备组内。 在对设备进行某些操作时(如升级设备软固件、批量下发命令等),可通过设备组来指定要进行操作的设备。 接口功能 支持第三方应用在物联网平台创建设备组,用于对设备进行分组管理。
使用MQTTS协议接入(联通用户专用) 非联通用户请查看设备接入服务。 MQTTS是安全的基于TLS的加密协议,采用MQTTS协议接入平台的设备,设备与物联网平台之间的通信过程,数据都是加密的,具有一定的安全性。 MQTT主要应用于计算能力有限,且工作在低带宽、不可靠的网络的远程
创建设备命令 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令,第三方应用可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台有两种命令下发机制: 立即下发:平台收到命令后立即下发给设备,保证实时性,不保证串行性。 缓存下发:
创建设备命令 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令,第三方应用可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台有两种命令下发机制: 立即下发:平台收到命令后立即下发给设备,保证实时性,不保证串行性。 缓存下发:
查询批量任务的子任务信息 典型场景 第三方应用通过“创建批量任务”接口创建了设备的批量操作任务后,可调用此接口查询该批量任务中子任务的详情信息,如任务的执行状态、任务内容等。 接口功能 支持第三方应用根据条件查询批量任务中子任务的详情信息,支持查询本应用创建的批量任务信息。 接口描述
查询设备服务能力 典型场景 第三方应用若需要了解设备可上报哪些服务属性数据,以及设备支持下发哪些命令,可调用此接口在物联网平台查询设备的Profile文件中定义的设备服务能力信息。 接口功能 支持第三方应用在物联网平台查询设备的服务属性、设备命令等服务能力信息。 接口描述 1 Q
查询设备服务能力 典型场景 第三方应用若需要了解设备可上报哪些服务属性数据,以及设备支持下发哪些命令,可调用此接口在物联网平台查询设备的Profile文件中定义的设备服务能力信息。 接口功能 支持第三方应用在物联网平台查询设备的服务属性、设备命令等服务能力信息。 接口描述 1 def
设备消息确认通知 接口说明 应用服务器在物联网平台订阅了设备消息确认通知后(订阅的通知类型为messageConfirm),当平台向设备下发命令,并收到设备返回的命令确认消息(如命令已送达、已执行等)时,平台会向应用服务器推送通知消息。 仅适用于使用MQTT协议接入的设备,例如集成了AgentLite
增加设备组成员 接口说明 若需要把新增的设备或已有设备增加到某个设备组中,应用服务器可调用此接口向指定设备组添加设备成员。在向设备组添加设备前,建议通过“查询指定设备组”接口查询该设备组的当前设备数量及最大设备数量限制,确保设备组中还有足够的可添加成员数量。 注意事项 一个设备只能归属一个设备组。
创建设备组 接口说明 应用服务器可调用此接口在物联网平台上创建设备组,并把设备归类到不同的设备组内,进行分组管理。在对设备进行某些操作时(如升级设备软固件、批量下发命令等),可通过设备组来指定要进行操作的设备。 注意事项 一个设备只能归属一个设备组。 URI 请求方法 POST URI
查询批量任务的子任务信息 接口说明 应用服务器通过“创建批量任务”接口创建了设备的批量操作任务后,可调用此接口查询该批量任务中子任务的详情信息,如任务的执行状态、任务内容等。 URI 请求方法 GET URI /iocm/app/batchtask/v1.1.0/taskDetails
创建设备命令 接口说明 设备Profile文件中定义了物联网平台可向设备下发的命令,应用服务器可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台有两种命令下发机制: 立即下发:平台收到命令后立即下发给设备,保证实时性,不保证串行性。 缓存下发:
设备数据变化通知 接口说明 应用服务器在物联网平台订阅了设备属性变化通知后(订阅的资源为device.data,事件为update),当设备上属性数据时,平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时,请务必返回响应码。 URI 请求方法 POST URI
查询设备服务能力 接口说明 应用服务器若需要了解设备可上报哪些服务属性数据,以及设备支持下发哪些命令,可调用此接口在物联网平台查询设备的Profile文件中定义的设备服务能力信息。 URI 请求方法 GET URI /iocm/app/data/v1.1.0/deviceCapabilities
修改设备信息 典型场景 第三方应用在物联网平台注册设备后,若设备的基本信息发生变更,也可调用此接口在物联网平台修改设备的信息。 接口功能 支持第三方应用修改设备的基本信息,包括设备类型、设备模型、厂商信息、接入协议等。 接口描述 1 void modifyDeviceInfo(M
查询单个设备信息 接口说明 已在物联网平台注册的设备,应用服务器若需要查看某个设备的详细信息(如厂商、型号、版本、状态和服务属性等信息),可调用此接口在物联网平台查询获取。 URI 请求方法 GET URI /iocm/app/dm/v1.4.0/devices/{deviceId}
温度过高时自动关闭设备(联通用户专用) 非联通用户请查看设备接入服务。 场景说明 物联网平台支持设备数据上报和设备命令下发,但若要将两者联动起来,一般需要由应用服务器实现对应逻辑。 设备管理服务提供规则引擎功能,平台上简单几步操作即可实现数据上报特定数据时平台自动下发指定命令,减少应用服务器开发工作量。
数据转发至OBS长期储存(联通用户专用) 非联通用户请查看设备接入服务。 场景说明 对于设备上报的数据,即使创建应用时开启了存储数据能力,设备管理服务也只保存7天的历史数据。 若您希望长期保存数据,可以选择让平台将设备上报数据推送给应用服务器,由应用服务器进行保存;还可以选择让平
查询指定批量任务信息 典型场景 第三方应用通过“创建批量任务”接口创建了设备的批量操作任务后,可调用此接口查询该批量任务的信息,包括任务的当前状态、子任务完成情况等。 接口功能 支持第三方应用通过任务ID查询单个批量任务的信息。 接口描述 1 QueryOneTaskOutDTO
查询指定批量任务信息 典型场景 第三方应用通过“创建批量任务”接口创建了设备的批量操作任务后,可调用此接口查询该批量任务的信息,包括任务的当前状态、子任务完成情况等。 接口功能 支持第三方应用通过任务ID查询单个批量任务的信息。 接口描述 1 def queryOneTask(self