检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
eport”,其中{device_id}与注册设备时获取的设备ID保持一致,您可以使用真实设备上报属性。在下方填写上报的属性,单击Publish按钮。具体可参考设备属性上报。 在控制台“设备列表”中找到该设备,单击“查看”,进入设备详情页。在设备详情页看到最新上报的数据。您也可以
设备的服务ID,由创建的产品模型确定。 properties 必选 Object 参数解释: 设备服务的属性列表,具体字段在设备关联的产品模型中定义,可以设置多个字段。 event_time 可选 String 参数解释: 设备采集数据UTC时间(格式可选:秒级别:yyyyMMdd'T'HHmmss'Z',毫秒级别:
设备信息上报 功能描述 设备向平台上报设备信息。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释: 网关设备上报时,子设备
系统格式下发消息字段表 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释: 平台下发时,若为直连设备,不携带该参数。 平台下发时,若为网关子设备,该参数为Topic中设备的子设备Id。 name 可选 String 参数解释: 消息名称,可不填写,做说明用。
下发设备消息 功能介绍 物联网平台可向设备下发消息,应用服务器可调用此接口向指定设备下发消息,以实现对设备的控制。应用将消息下发给平台后,平台返回应用响应结果,平台再将消息发送给设备。平台返回应用响应结果不一定是设备接收结果,建议用户应用通过订阅设备消息状态变更通知,订阅后平台会将设备接收结果推送给订阅的应用。
网关批量属性上报 一次性上报多个子设备的属性,设备侧到应用侧的数据不直接透传。平台会将网关上报多子设备的数据分发到对应的子设备。 网关下关联多个子设备的场景。并且对于子设备数据上报时间不敏感,可以把多个子设备的数据打包后再一起上报。 MQTT 资源受限或者对网络流量有要求的设备,不适合直接构造
设备自注册 概述 自注册模板主要用于设备自动注册的场景,不需要提前在物联网平台进行注册设备。当前物联网平台基于安全考虑,需要将设备的基本信息(例如设备ID、鉴权信息)注册到平台后,设备才能连接上平台。当用户的设备未在平台注册时,可以通过自注册模板在设备首次接入物联网平台时将设备信
冻结设备 功能介绍 应用服务器可调用此接口冻结设备,设备冻结后不能再连接上线,可以通过解冻设备接口解除设备冻结。注意,当前仅支持冻结与平台直连的设备。该接口仅支持冻结单个设备,如需批量冻结设备,请参见 创建批量任务。 调用方法 请参见如何调用API。 URI POST /v5/i
查询设备属性 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的属性,应用服务器可调用此接口向设备发送指令用以查询设备的实时属性, 并由设备将属性查询的结果同步返回给应用服务器。 注意:此接口适用于MQTT设备,暂不支持NB-IoT设备。 调用方法 请参见如何调用API。 URI
图2 设备-注册设备成功 若密钥丢失,可以按照设备认证凭证管理中的步骤更新设备密钥,无法找回注册设备时生成的密钥。 用户可在设备列表删除不再使用的设备。删除设备不支持撤回,请谨慎操作。 相关API参考 查询设备列表 创建设备 查询设备 修改设备 删除设备 重置设备密钥 父主题: 注册设备
设备状态触发:可以将设备的上下线状态作为触发条件,如:设备离线持续时长达到5分钟,上报告警。 选择产品:选择特定产品。 选择设备范围: 全部设备:对选择产品下的全部设备进行条件设置。 指定设备:对选择产品下的指定设备进行条件设置。 选择触发设备状态: 上线:设备由离线状态转变为在线状态。 下线:设备由在线状态转变为离线状态。
删除设备 功能介绍 应用服务器可调用此接口在物联网平台上删除指定设备。若设备下连接了非直连设备,则必须把设备下的非直连设备都删除后,才能删除该设备。该接口仅支持删除单个设备,如需批量删除设备,请参见 创建批量任务。 调用方法 请参见如何调用API。 URI DELETE /v5/
object_device_id 可选 String 参数解释: 网关设备上报时,子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id,否则将请求失败。 直连设备上报时,object_device_id需与Topic中的device_id一致。
String 网关ID,用于标识设备所属的父设备,即父设备的设备ID。当设备是直连设备时,gateway_id与设备的device_id一致。当设备是非直连设备时,gateway_id为设备所关联的父设备的device_id。 device_name String 设备名称。 node_type
网关上报子设备属性时一次最大可上报子设备数量为100个。 使用说明 图2 设备属性上报操作流程 创建产品与设备、设定物模型:创建产品流程、创建设备流程、设定产品模型。 设备鉴权:平台验证设备是否具有接入权限。 设备属性上报:设备通过MQTT/HTTP/LwM2M等协议上报属性数据。 按
List<DeviceProperty> Body 参数解释: 设备数据列表。 取值范围: 长度不超过50。 表1 DeviceProperty 名称 必选 类型 说明 device_id 是 String 参数解释: 子设备的设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。 取值范围:
平台命令下发 功能介绍 用于平台向设备下发设备控制命令。平台下发命令后,需要设备及时将命令的执行结果返回给平台,如果设备没回响应,平台会认为命令执行超时。命令下发和消息下发的区别,请查看消息通信说明。 低配置且资源受限或者对网络流量有要求的设备,不适合直接构造JSON数据与物联网
表3 响应Body参数 参数 参数类型 描述 device_id String 设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。 messages Array of DeviceMessage objects 设备消息列表。 表4 DeviceMessage 参数
请检查设备侧。 Task Conflict 任务冲突 请检查当前设备是否有软件升级、固件升级、日志收集或设备重启的任务正在进行。 Waiting for the device online timeout 等待设备上线超时 请检查设备侧。 Wait for the device to
物联网平台管理您的资源。 平台对接前资源空间需完成设备数据迁移。若未完成,请参考设备发放-策略进行数据迁移。 该功能在北京四、上海一标准版支持,企业版如需要请提交工单联系。 操作步骤 访问设备接入服务,单击“管理控制台”进入设备接入控制台。 选择左侧导航栏的“IoTDA实例”,找