检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备请求引导消息 接口功能 设备向发放服务请求对应设备接入实例的引导信息。 Topic 表1 上报Topic说明 Topic $oc/devices/{device_id}/sys/bootstrap/up 消息发送方 设备 消息接收方 设备发放平台 示例 设备向发放服务发送的payload为空。
建设备组时由物联网平台分配。 name String 设备组名称,单个资源空间下不可重复。 description String 设备组描述。 super_group_id String 父设备组ID,该设备组的父设备组ID。 group_type String 参数说明:设备组
iotda:devices:publish:设备使用MQTT协议发布消息。 iotda:devices:subscribe:设备使用MQTT协议订阅消息。 resources 是 Array of strings 用于指定允许或拒绝对其执行操作的资源。格式为:资源类型:资源名称。如设备订阅的资源为:topic:/v1/${devices
删除设备代理 功能介绍 应用服务器可调用此接口在物联网平台上删除指定设备代理。 调用方法 请参见如何调用API。 URI DELETE /v5/iot/{project_id}/device-proxies/{proxy_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
携带的设备证书指纹。 使用设备证书接入平台。 图1 设备连接参数 进入设备接入控制台,左侧导航栏选择“设备 > 设备证书”,选择“设备证书”查看设备证书列表与详情。 图2 设备证书-证书列表 图3 设备证书-证书详情 进入设备接入控制台,左侧导航栏选择“设备 > 所有设备”,选择
资源空间,获取方式参考获取资源空间 device_name 设备名称,可以同node_id一致。 secret 设备密钥,性能测试时可以固定填写一个密钥。 在“批量注册设备窗口”单击“添加文件”上传写好的批量注册文件模板,单击“确定”创建任务。 图1 设备-批量注册设备 批量注册执行成功后,保存好设备ID和密钥。
上传设备CA证书 功能介绍 应用服务器可调用此接口在物联网平台上传设备CA证书 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/certificates 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
网关更新子设备状态响应 功能介绍 平台将该网关更新子设备状态结果以列表返回,平台收到网关更新子设备状态请求后会在30秒内通过此接口返回响应消息。网关与子设备关系,请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down
添加静态跨region策略 注册设备 在设备发放控制台,注册MQTT设备,其中安全模式选择密钥模式(如果需要下发初始化配置,那么对应在初始设备配置选项中填写对应的JSON字符串,设备发放不理解该字段,只是透传该JSON字符串,由设备理解解析。如果不需要下发该字段则不填)。 图6 注册设备 图7 创建密钥模式静态策略设备
发放区域 发放到指定区域后,设备将接入对应区域的设备接入服务。 所选区域未开通设备接入服务时,如果确定添加实例,系统将自动为您开通设备接入服务。不同区域设备接入服务价格不同,收费详情请参考价格说明。 发放应用 选择对应设备接入服务区域已创建的应用。在物联网平台中,设备由应用统一管理。 如
$oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释: 网关设备上报时,子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id,否则将请求失败。
必选 String 参数解释: 日志类型。 取值范围: DEVICE_STATUS :设备状态。 DEVICE_PROPERTY :设备属性。 DEVICE_MESSAGE :设备消息。 DEVICE_COMMAND:设备命令。 content 必选 String 参数解释: 日志内容。
查询设备组设备列表 功能介绍 应用服务器可调用此接口查询指定设备组下的设备列表。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/device-group/{group_id}/devices 表1 路径参数 参数 是否必选 参数类型 描述
iotda:devices:publish:设备使用MQTT协议发布消息。 iotda:devices:subscribe:设备使用MQTT协议订阅消息。 resources Array of strings 用于指定允许或拒绝对其执行操作的资源。格式为:资源类型:资源名称。如设备订阅的资源为:topic:/v1/${devices
设备与其接入服务器之间已有通信网络,您希望在不修改设备和协议的情况下,将设备接入IoT平台。 由于设备硬件资源或者网络限制,设备无法直接接入IoT平台。 方案架构 方案总体架构框图如下: 图1 总体架构图 各种不同协议类型的设备,通过泛协议插件,最终以MQTT协议和华为云物联网平台进行链接。泛协议插
平台下发隧道信息 功能介绍 物联网平台向设备侧下发安全隧道信息。设备侧在接收到信息后,可以使用该安全隧道信息建立与物联网平台的WebSocket连接,用户可以在应用端远程登录使用基于安全隧道建链的设备(远程SSH登录服务),进行设备的更新配置、排查诊断、运维变更等操作。 Topic
支持创建设备的“影子”。设备影子是一个JSON文件,用于存储设备的在线状态、设备最近一次上报的设备属性值、应用服务器期望下发的配置。每个设备有且只有一个设备影子,设备可以获取和设置设备影子以此来同步设备属性值,这个同步可以是影子同步给设备,也可以是设备同步给影子。 设备影子上有desired区和reported区。
辅密钥与主密钥有相同的效力;辅密钥对coap协议接入的设备不生效。 响应参数 状态码: 200 表5 响应Body参数 参数 参数类型 描述 device_id String 设备ID,用于唯一标识一个设备。在注册设备时直接指定,或者由物联网平台分配获得。由物联网平台分配时,生成规则为"product_id"
X.509认证设备。 图3 注册设备 图4 注册云证书设备 下载设备证书 设备注册成功后,单击设备进入设备详情页面,单击“下载”按钮下载设备证书,并烧录到设备。 图5 下载云证书设备证书 连接鉴权 MQTT.fx 是目前主流的MQTT桌面客户端,它支持 Windows, Mac,
MQTT(S)协议-密钥鉴权 概述 MQTT(S)协议-密钥鉴权是指设备在接入物联网平台时,携带设备ID和密钥以完成设备的接入鉴权。对于使用MQTTS协议接入的设备,需要在设备侧预置CA证书;对于使用MQTT非安全协议接入的设备,无需在设备侧预置CA证书。 使用MQTT(S)协议-密钥接入的鉴权流程