银河麒麟服务器迁移运维管理平台(接口文档)

银河麒麟高级服务器操作系统V10 系统管理员手册

---

CVE下发接口

功能描述: CVE 下发接口调用

• 接口 URL: /cve/issue
• 接口类型: POST
• 请求头: API-KEY: your_API_key（内容为 APIKey 值，需要通过登陆平台，在个人信息处获取）
• 参数:

参数名	类型	含义
targetType	字符串	传入类型（二选一）：1.“Batch”代表传入类型是批次，2. "Host"代表主机
targetIds	列表[整数]	根据传入类型，此值代表批次Id 或主机Id
cveIds	列表[整数]	传入的 cveId 的集合。对应获取CVE 接口返回值的 id 字段

输出/返回信息: 父日志信息，例：

{
"id": 118,
"action": "CVE 下发",
"status": "运行中",
"result": "",
"module": "补丁/CVE/CVE 下发",
"rollbackFlag": null,
"detailShort": null,
"createdAt": "2024-07-29 14:31:20",
"updatedAt": "2024-07-29 14:31:20",
"display": true,
"batchName": null,
"canRetry": true,
"requestInfo":
"{\"args\":\"[{\\\"cveIds\\\":[8],\\\"targetIds\\\":[4],\\\"targetType\\\":\\\"Host\\\",\\\"upgradedLatest\\\":false}]\",\"url\":\"http://10.44.72.247:8080/cve/issue?oldLogId=118\"}",
"userId": 1,
"userName": "admin",
"departmentId": 1,
"departmentName": "平台",
"progess": null,
"scriptTemplateId": null,
"scriptParams": null
}

获取CVE接口

功能描述: 获取 CVE 接口调用

• 接口 URL: /cveAllList
• 接口类型: GET
• 请求头: API-KEY: your_API_key（内容为 APIKey 值，需要通过登陆平台，在个人信息处获取）
• 输出/返回信息: CVE 信息，例：

[{
"id": 8,
"erratumId": 5,
"cveId": "CVE-2018-15919",
"arch": null,
"system": null,
"name": null,
"issuedDate": "2021-06-18",
"rebootSuggested": false,
"href": "not None",
"erratumPackages": [{
"id": 174,
"cveId": 8,
"nvrea": "0:openssh-8.2p1-9.p03.ky10.aarch64",
"name": "openssh",
"filename": null,
"label": "kylin_v10_sp1:aarch64",
"userId": 1,
"departmentId": 1
}]

获取主机接口

功能描述: 获取主机接口

• 接口 URL:
• /hosts/hostVersion?paged=false&sortBy=ip&sortOrder=asc&version=&compare=
• 接口类型: GET
• 请求头: API-KEY: your_API_key（内容为 APIKey 值，需要通过登陆平台，在个人信息处获取）
• 输出/返回信息: 主机信息,例：

[{
"id": 3,
"ip": "10.44.45.138",
"agentStatus": "连接",
"operatingSystem": "银河麒麟高级服务器操作系统",
"version": "兼容版(V10 8.8)",
"architecture": "x86_64",
"agentVersion": "2.2.0",
"userName": "admin",
"departmentName": "平台",
"parentName": null,
"createdAt": "2024-05-20 17:45:00",
"heartbeatTime": "2024-07-29 14:58:32",
"installTime": "2024-05-08 17:54:56",
"cpuNum": 4,
"macAddressesList": [{
"id": 97,
"name": "enp1s0",
"ip": "10.44.45.138",
"macAddress": "52:54:00:ec:ab:36",
"hostId": 3
}]
}]

获取批次接口

功能描述: 获取批次接口

• 接口 URL: /batches
• 接口类型: GET
• 请求头: API-KEY: your_API_key（内容为 APIKey 值，需要通过登陆平台，在个人信息处获取）
• 输出/返回信息: 批次信息,例

[{
"id": 5,
"name": "sync_repo_for_SH(admin)",
"userName": "admin",
"locked": false,
"createdAt": "2024-07-25 16:59:00",
"description": "上海同步"
}]

获取父日志接口

• 功能描述: 获取父日志接口
• 接口 URL: /log/{parentId}
• 接口类型: GET
• 请求头:API-KEY: your_API_key（内容为 APIKey 值，需要通过登陆平台，在个人信息处获取）
• 路径参数: {parentId}为父日志的 id
• 输出/返回信息: 父日志信息,例：

[{
"id": 118,
"action": "CVE 下发",
"status": "成功",
"result": "完成",
"module": "补丁/CVE/CVE 下发",
"rollbackFlag": null,
"detailShort": "",
"createdAt": "2024-07-29 14:31:20",
"updatedAt": "2024-07-29 14:31:43",
"display": true,
"batchName": null,
"canRetry": true,
"requestInfo":
"{\"args\":\"[{\\\"cveIds\\\":[8],\\\"targetIds\\\":[4],\\\"targetType\\\":\\\"Host\\\",\\\"upgradedLatest\\\":false}]\",\"url\":\"http://10.44.72.247:8080/cve/issue?oldLogId=118\"}",
"userId": 1,
"userName": "admin",
"departmentId": 1,
"departmentName": "平台",
"progess": "1/1",
"scriptTemplateId": null,
"scriptParams": null
}]

获取子日志接口

• 功能描述: 获取子日志接口
• 接口 URL: /log/{parentId}/sub
• 接口类型: GET
• 请求头: API-KEY: your_API_key（内容为 APIKey 值，需要通过登陆平台，在个人信息处获取）
• 路径参数: {parentId}为父日志的 id
• 输出/返回信息: 子日志信息，例：

[{
"id": 118,
"action": "CVE 下发",
"status": "成功",
"result": "完成",
"module": "补丁/CVE/CVE 下发",
"rollbackFlag": null,
"detailShort": "",
"createdAt": "2024-07-29 14:31:20",
"updatedAt": "2024-07-29 14:31:43",
"display": true,
"batchName": null,
"canRetry": true,
"requestInfo":
"{\"args\":\"[{\\\"cveIds\\\":[8],\\\"targetIds\\\":[4],\\\"targetType\\\":\\\"Host\\\",\\\"upgradedLatest\\\":false}]\",\"url\":\"http://10.44.72.247:8080/cve/issue?oldLogId=118\"}",
"userId": 1,
"userName": "admin",
"departmentId": 1,
"departmentName": "平台",
"progess": "1/1",
"scriptTemplateId": null,
"scriptParams": null
}]

---