更新时间：2025-05-26 GMT+08:00
平台下发隧道信息
功能介绍
物联网平台向设备侧下发安全隧道信息。设备侧在接收到信息后，可以使用该安全隧道信息建立与物联网平台的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
}
}]
}
