GetHotfixTask - 获取热补丁任务状态

更新时间:
复制 MD 格式

查询 CVE 热补丁异步任务状态

接口说明

热补丁任务的流程是异步的,因此调用本接口时,任务可能还在执行没有结束,可以通过返回数据中 data.status 字段进行判断,当 data.status == Success 时,表示任务成功,可以从 data.result 中读取到任务的结果。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

GET /api/v1/hotfix_manager/task/get HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

taskId

string

是

异步任务 ID

hotfix-da3dcc0b-5019-4b59-b12f-2e500da9083c

返回参数

名称

类型

描述

示例值

object

Schema of Response

code

string

状态码

  • code == Success 则代表授权成功;

  • 其它状态码代表授权失败,授权失败时查看 message 字段获取详细的错误信息;

Success

data

object

返回数据。

createdAt

string

任务创建时间

2026-10-13T08:14:40

cveId

string

CVE ID

CVE-2026-31431

finishedAt

string

任务完成时间

2026-10-13T08:14:40

jobs

array<object>

实例任务列表

object

子任务详情

errorCode

string

统一错误码

INSTANCE_NOT_EXISTS

errorMessage

string

错误信息

指定的实例不存在

hotfixStatus

string

热补丁状态

CONFLICT

instance

string

实例 ID

i-2zehme0rs1tc090fdl3n

region

string

地域 ID

cn-hangzhou

status

string

实例任务状态

Running

operation

string

任务操作类型

Install

status

string

任务状态

Running

taskId

string

异步任务 ID

hotfix-da3dcc0b-5019-4b59-b12f-2e500da9083c

message

string

错误信息

  • 如果 code == Success,则本字段为空;

  • 否则本字段包含请求错误信息。

success

requestId

string

请求 ID。

2D693121-C925-5154-8DF6-C09A8B369822

示例

正常返回示例

JSON格式

{
  "code": "Success",
  "data": {
    "createdAt": "2026-10-13T08:14:40",
    "cveId": "CVE-2026-31431",
    "finishedAt": "2026-10-13T08:14:40",
    "jobs": [
      {
        "errorCode": "INSTANCE_NOT_EXISTS",
        "errorMessage": "指定的实例不存在",
        "hotfixStatus": "CONFLICT",
        "instance": "i-2zehme0rs1tc090fdl3n",
        "region": "cn-hangzhou",
        "status": "Running"
      }
    ],
    "operation": "Install",
    "status": "Running",
    "taskId": "hotfix-da3dcc0b-5019-4b59-b12f-2e500da9083c"
  },
  "message": "success",
  "requestId": "2D693121-C925-5154-8DF6-C09A8B369822\n"
}

错误码

HTTP status code

错误码

错误信息

描述

400 SysomOpenAPI.InvalidParameter Invalid parameters passed when calling the interface. 调用接口时传递了无效参数
400 SysomOpenAPI.MissingParameter Missing parameters. 参数缺失
400 SysomOpenAPI.HotfixTaskNotFound The specified hotfix task was not found.
400 SysomOpenAPI.NotOwnHotfixTask The hotfix task does not belong to the current account.
400 SysomOpenAPI.ServerError Server error, please correct the code according to the error message. 服务端错误,请根据错误提示信息修正代码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。