文档首页/ 设备接入 IoTDA/ API参考/ 设备侧MQTT/MQTTS接口参考/ 设备隧道管理/ 平台下发隧道信息
更新时间：2024-09-24 GMT+08:00
查看PDF
分享

平台下发隧道信息

功能介绍

物联网平台向设备侧下发安全隧道信息。设备侧在接收到信息后，可以使用该安全隧道信息建立与物联网平台的WebSocket连接，用户可以在应用端远程登录使用基于安全隧道建链的设备（远程SSH登录服务），进行设备的更新配置、排查诊断、运维变更等操作。

Topic

下行：$oc/devices/{device_id}/sys/events/down

参数说明

字段名

必选/可选

类型

参数描述

services

可选

List<ServiceEvent>

参数解释：

事件服务列表。

ServiceEvent定义表

字段名

必选/可选

类型

参数描述

service_id

必选

String

参数解释：

系统字段。

取值范围：

固定为："$tunnel_manager"。

event_type

必选

String

参数解释：

系统字段。

取值范围：

固定为："tunnel_notify"。

event_time

可选

String

参数解释：

事件时间。UTC时间，格式：yyyyMMdd'T'HHmmss'Z'。

paras

必选

Object

参数解释：

事件参数JSON对象。

paras参数列表

字段名

必选/可选

类型

参数描述

tunnel_uri

必选

String

参数解释：

隧道连接地址。

tunnel_access_token

必选

String

参数解释：

隧道接入token。

expires_in

必选

Integer

参数解释：

token有效期。

示例

Topic: $oc/devices/{device_id}/sys/events/down
数据格式：
{ 
    "services": [{ 
        "service_id": "$tunnel_manager", 
        "event_type": "tunnel_notify", 
        "event_time": "20151212T121212Z",
         "paras": { 
              "tunnel_uri": "wss://xxx/v5/iot/tunnels/{tunnel_id}/device-connect",
              "tunnel_access_token": "xxxx",
              "expires_in":86400
         } 
    }] 
}
父主题： 设备隧道管理