检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
通过网关接入的子设备,平台如何识别是哪一个设备? 网关信息请在“设备信息”中查看,子设备信息请在“子设备”中查看。点击了解更多网关和子设备介绍。 父主题: 设备集成(联通用户专用)
传输请求的协议,当前所有API均采用HTTPS协议。 Endpoint 承载REST服务端点的服务器地址,为“host:port”格式,host为服务器的访问域名或IP,port为服务器的访问端口,您可以参考平台对接信息获取应用的接入地址和端口信息。 例如设备管理服务在“华北-北京四”区域的应用对接地址为“iot-api
IoT设备如何激活? 在物联网平台中,激活就是将真实设备在平台进行注册后,和平台进行连接或者上报数据。更多请查看设备监控。 开发中心没有未激活状态,设备在线,您可认为设备就已激活。 父主题: 设备集成(联通用户专用)
如何设置设备名称? 在开发中心注册设备时,支持设置设备名称。 在设备接入和设备管理的控制台中注册设备时,不支持设置设备名称,您可在设备注册成功后,进入设备详情中新增/修改设备名称。 使用API注册/创建设备时,设备接入、设备管理和开发中心都支持在注册/创建设备时设置设备名称。 父主题:
条件 设备行为:单击“添加”,可以选择设置条件的设备,支持对某一设备或者某一类设备进行设置。 条件类型: 设备:表示满足条件的数据是由单个设备上报到平台。 设备类型:表示满足条件的数据是由选择的某一设备类型的设备上报到平台。 设备群组:表示满足条件的数据是由所选设备群组的设备上报到平台。
刷新设备密钥 接口说明 已在物联网平台注册的设备,若设备的唯一标识码发生变更(如更换设备等场景),应用服务器需要调用此接口在物联网平台更新设备的唯一标识,并重新绑定设备。 注意事项 仅当设备处于离线状态时,才能进行刷新设备密钥操作。 URI 请求方法 PUT URI /iocm/app/reg/v1
删除指定版本包 接口说明 对于不需要继续使用和保留的设备版本包,应用服务器可调用此接口在物联网平台上删除指定的版本包,可根据版本包ID删除指定的版本包文件,在调用该接口前需要通过“查询版本包列表”接口查询获得要删除的版本包ID。 URI 请求方法 DELETE URI /iodm/northbound/v1
批量查询设备信息 接口说明 已在物联网平台注册的设备,应用服务器若需要根据条件查看多个设备的详细信息(如厂商、型号、版本、状态和服务属性等信息),可调用此接口在物联网平台查询获取。 URI 请求方法 GET URI /iocm/app/dm/v1.4.0/devices 传输协议
创建固件升级任务 接口说明 若需要对设备进行固件版本升级,应用服务器可调用此接口为多个设备创建固件升级任务,升级前请确保目标版本包已上传到物联网平台。 注意事项 仅支持对使用LWM2M协议接入的设备进行固件升级。 URI 请求方法 POST URI /iodm/northbound/v1
查询任务列表 接口说明 应用服务器可调用此接口查询已创建的升级任务列表信息,以了解当前已有的升级任务信息及各个任务的执行情况,可根据条件查询满足要求的升级任务信息。 URI 请求方法 GET URI /iodm/northbound/v1.5.0/operations 传输协议 HTTPS
String(256) 设备ID,用于唯一标识一个设备。 gatewayId String(256) 网关ID,用于标识一个网关设备。当设备是直连设备时,gatewayId与设备的deviceId一致。当设备是非直连设备时,gatewayId为设备所关联的直连设备(即网关)的deviceId。
swUpgradeState 必选 String body 软件升级状态。 downloading:设备正在下载软件包 downloaded:设备下载软件包完成 updating:设备正在进行升级 idle:设备处于空闲状态 响应参数 Status Code: 200 OK 请求示例 Method:
swUpgradeState 必选 String body 软件升级状态。 “downloading”:设备正在下载软件包 “downloaded”:设备下载软件包完成 “updating”:设备正在进行升级 “idle”:设备处于空闲状态 响应参数 Status Code: 200 OK 请求示例 Method:
通知类型,取值:fwUpgradeResultNotify。 deviceId 必选 String body 设备ID,用于唯一标识一个设备。 appId 必选 String body 设备所属应用的应用ID。 operationId 必选 String body 固件升级任务ID。 subOperationId
消息结构体说明 转发设备上报的属性 根据定义的产品模型,上报设备属性至平台。结构体描述如下: 表1 属性上报规则转发结构体 参数名称 类型 描述 device_id String 设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。 services services[]
上报设备数据 接口功能 当直连设备(网关)有数据需要上报或者非直连设备上报数据到网关时,网关需要调用设备服务数据上报接口将数据上报到物联网平台。 上报设备数据接口的pcDeviceId、pcRequstId和pcServiceId由SDK组装为消息的header;pcServic
注册设备(密码方式) 接口说明 在设备接入物联网平台前,应用服务器需要调用此接口在物联网平台注册设备,获取设备ID和密码。在设备接入物联网平台时携带设备ID和密码,完成设备的接入认证。 此注册设备接口适用于使用MQTT协议接入的设备。 URI 请求方法 POST URI /iocm/app/reg/v2
查询设备命令 接口说明 应用服务器向设备下发命令后,可调用此接口在物联网平台查询下发命令的状态及内容信息,以了解命令的执行情况,可查询指定时间段内本应用下的所有下发命令,或者指定设备的所有下发命令。 URI 请求方法 GET URI /iocm/app/cmd/v1.4.0/deviceCommands
创建软件升级任务 接口说明 若需要对设备进行软件版本升级,应用服务器可调用此接口为多个设备创建软件升级任务,升级前请确保目标版本包已上传到物联网平台。 注意事项 仅支持对使用LWM2M协议接入的设备进行软件升级。 URI 请求方法 POST URI /iodm/northbound/v1
查询单个设备信息 接口说明 已在物联网平台注册的设备,应用服务器若需要查看某个设备的详细信息(如厂商、型号、版本、状态和服务属性等信息),可调用此接口在物联网平台查询获取。 URI 请求方法 GET URI /iocm/app/dm/v1.4.0/devices/{deviceId}