🐝
蜂巢OPENAPI
  • 蜂巢TNest
  • 产品介绍
    • 产品概述
    • 产品功能
    • 产品优势
    • 应用场景
  • 快速入门
    • 入门概述
    • 部署
    • 快速接入
    • 应用开发及编译
    • 应用部署
  • API
    • 接口规范
    • 终端数据查询
      • 系统基本信息上报
      • 系统运行数据上报
        • 采样频率、上报频率设置
        • CPU温度定时上报
        • CPU使用率定时上报
        • 内存使用率定时上报
        • 磁盘使用率定时上报
        • 4G模组信息定时上报
        • 有线网卡流量信息定时上报
      • 容器数据上报
      • 微应用数据上报
      • 进程数据上报
      • 服务数据上报
      • 网络端口数据上报
      • 终端在线状态
      • 链路跟踪
    • 终端告警
      • 告警规则下发
      • CPU使用率告警
      • 内存使用率告警
      • 磁盘使用率告警
      • CPU温度告警
      • 证书过期告警
      • 证书修改告警
      • 插入网线告警
      • 网线拔出告警
      • 网络链路时延告警
      • 网络链路中断告警
      • 网络链路丢包率告警
    • 运行诊断
      • 网络诊断
      • 工况诊断
      • 系统诊断
      • 进程诊断
    • 容器管理
      • 下载容器
      • 安装容器
      • 启动容器
      • 停止容器
      • 替换容器
      • 卸载容器
      • 克隆容器
    • 应用管理
      • 下载微应用
      • 安装微应用
      • 启动微应用
      • 停止微应用
      • 卸载微应用
      • 使能微应用
      • 去使能微应用
      • 微应用升级
    • 设备管理
      • 物理接口管理
        • 网口管理
      • 终端校时
      • 终端重启
      • 命令行
      • 网络访问黑名单
      • 网络访问白名单
      • 网络接口封堵
    • 连接管理
      • 网络访问黑名单
      • 网络访问白名单
    • 系统更新
      • 下载固件
      • 固件升级
      • 下载补丁包
      • 安装补丁包
      • 下载配置文件
      • 部署配置文件
    • 日志管理
      • 日志提取
      • 日志监控
        • 监控规则下发
        • 监控日志上报
        • 系统操作日志上报(审计日志)
  • 用户指南
    • 蜂巢部署
    • 安全接入
    • 可观测性
      • 系统基本信息上报
      • 运行数据监控
      • 终端告警
      • 运行诊断
    • 设备管理
      • 网络接口封堵
      • 终端校时
      • 终端重启
      • 命令行
    • 日志管理
      • 日志提取
      • 监控日志上报
      • 系统操作日志审计
    • 连接管理
      • 访问黑名单
      • 访问白名单
    • 容器管理
      • 容器下载
      • 容器安装/卸载
      • 容器启动/停止
      • 容器替换
      • 容器克隆
    • 应用管理
      • 应用下载
      • 应用安装/卸载
      • 应用使能/去使能
      • 应用启动/停止
      • 应用升级
    • 系统更新
      • 固件升级
      • 补丁包安装
      • 配置更新
  • 常见问题
    • 蜂巢部署相关问题
    • 设备注册相关问题
    • API调用相关问题
    • 应用编译相关问题
由 GitBook 提供支持
在本页
  • 1. 请求消息
  • 1.1 topic
  • 1.2 请求消息payload
  • 2. 应答消息
  • 2.1 Topic
  • 2.2  应答消息payload
  1. API
  2. 系统更新

安装补丁包

1. 请求消息

1.1 topic

Topic
/v1/devices/{DeviceSn}/system/command

消息发送方

物联网平台

消息接收方

网关设备

1.2 请求消息payload

数据域
数据类型
是否必选
描述

mid

stirng

是

消息ID,推荐使用uuid, 请求和应答匹配,用来匹配请求和应答消息和去重

msgTime

string

是

消息发送时间戳,RFC3339标准,例如:1985-04-12T23:20:50.52Z

zone

string

否

设备部署的区域,例如ZONE3

node

string

否

设备部署的节点,例如440000

requestId

string

否

微服务链路追踪用的标识

deviceSn

string

是

设备ESN码,用于唯一标识设备

deviceId

string

否

统一物联网平台分配的设备id,据说可能会重复,不能唯一标识设备

service

string

是

服务名称。这里固定为:deviceManageService

cmd

string

是

具体操作方法,这里固定为:actionPatchInstall

params

object

否

[可选]对象内容

params结构体说明

字段
必选/可选
类型
描述

patchId

必选

String

补丁包唯一id

patchName

必选

String

补丁包名称

patchVersion

必选

String

补丁包的版本号

fileId

必选

String

补丁包文件唯一id

patchLocated

必选

String

补丁包安装的位置,枚举类型,取值如下:

  • docker:Docker容器

  • linux-lxc:LXC容器

  • host:直接安装在宿主机

containerId

可选

String

补丁包所要安装的容器唯一id。直接安装在宿主机上时不需要。

containerName

可选

string

容器名称。字符串形式,区分大小写,仅支持数字、字母、下划线和横线,首字符需为数字或者大小写字母,长度范围是2~64。直接安装到宿主机时不需要该字段


2. 应答消息

2.1 Topic

Topic
/v1/devices/system/response

消息发送方

网关设备

消息接收方

物联网平台

2.2  应答消息payload

数据域
数据类型
是否必选
描述

mid

string

是

消息ID,用于消息去重。

replyId

string

是

表示响应的是哪条请求指令,为该指令的mid,用来匹配请求和应答

msgTime

string

是

消息发送时间戳,采用RFC3339标准,例如:1985-04-12T23:20:50.52Z。

zone

string

否

设备部署的区域,例如ZONE3

node

string

否

设备部署的节点,例如440000

requestId

string

否

微服务链路追踪用的标识

deviceSn

string

是

设备ESN码,用于唯一标识设备

deviceId

string

否

统一物联网平台分配的设备id,据说可能会重复,不能唯一标识设备

code

uint16

是

标识应答的返回码

批处理请求时,如果所有处理都成功,返回200

如果有部分失败,返回400。

取值如下:

•100:指令接收成功,等待执行完成。

•200:请求成功。

•400:请求消息错误,例如消息格式错误等。

•404:不支持该操作。

•429:请求太多。

•500:服务端内部错误,由应用定义。

body

object

否

(可选)对象内容。

上一页下载补丁包下一页下载配置文件

最后更新于1年前