首批通过分布式安全可靠测评,为关键业务系统打造
上传软件包
更新时间:2023-08-10 11:45:58
功能说明
将本地的软件包上传到 OCP 服务器,可以通过软件包名称关键字、类型、版本、操作系统、架构信息过滤软件包列表,也可以通过上传时间针对列表进行排序。
调用说明
接口约束
调用者需要具备 PACKAGE_MANAGER 权限。
请求路径
POST /api/v2/software-packages
请求类型
multipart/form-data
请求参数
| 参数 | 类型 | 必选 | 示例值 | 描述 |
|---|---|---|---|---|
| file | Binary | 是 | 文件信息 | 需要上传到服务器的文件 |
返回结果
| 参数 | 类型 | 说明 |
|---|---|---|
| data | Object | SoftwarePackageMeta 对象 |
| successful | Boolean | 请求是否成功 |
| timestamp | Datetime | 服务端完成请求的时间戳 |
| duration | Integer | 服务端处理请求的时间(毫秒) |
| status | Integer | 符合 HTTP Status 规范的编码 |
| traceId | String | 请求的 Trace ID,用于排查问题 |
| server | String | 响应请求的应用服务的地址 |
SoftwarePackageMeta 的数据结构
| 参数 | 类型 | 说明 |
|---|---|---|
| id | Integer | 软件包 ID |
| name | String | 软件包名称 |
| fileName | String | 软件包的文件全名 |
| extension | String | 软件包扩展名 |
| size | Integer | 软件包大小,单位字节 |
| sha1 | String | 软件包的 SHA1 |
| downloadUrl | String | 软件包下载地址 |
| type | String | 软件包类型 * OB_SERVER_INSTALL_PACKAGE:OceanBase 安装包 * OCP_AGENT_INSTALL_PACKAGE:OCP Agent 安装包 * OBPROXY_INSTALL_PACKAGE:OBProxy 安装包 * OB_BACKUP_AGENT_INSTALL_PACKAGE:备份恢复软件安装包 |
| version | String | 软件包版本 |
| buildNumber | String | 软件包编译好 |
| operatingSystem | String | 软件包支持的操作系统 |
| architecture | String | 软件包架构 |
示例
请求示例
POST /api/v2/software-packages?file=t-oceanbase-ocp-agent-3.1.2-20210812221.rpm
返回示例
{
"data": {
"architecture": "x86_64",
"buildNumber": "20210812221645",
"downloadUrl": "http://localhost:8080/api/v2/files/sys-package/t-oceanbase-ocp-agent-3.1.2-20210812221645.alios7.x86_64.rpm",
"extension": "rpm",
"fileName": "t-oceanbase-ocp-agent-3.1.2-20210812221645.alios7.x86_64.rpm",
"id": 26,
"name": "t-oceanbase-ocp-agent",
"operatingSystem": "alios7",
"sha1": "4e5ac896c41c7aa9eda09f4a9b72cbe6f7fc78bc",
"size": 38400132,
"type": "OCP_AGENT_INSTALL_PACKAGE",
"version": "3.1.2"
},
"duration": 6765,
"server": "a83ad33525",
"status": 200,
"successful": true,
"timestamp": "2021-08-24T21:40:09.952+08:00",
"traceId": "baffb6be55b0473a"
}