文档首页/ 微服务引擎 CSE/ API参考/ CSE API/ 引擎管理/ 查询引擎任务列表
更新时间：2025-05-13 GMT+08:00
查看PDF
分享

查询引擎任务列表

功能介绍

查询引擎任务列表

URI

GET /v2/{project_id}/enginemgr/engines/{engine_id}/jobs

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户子项目的唯一标识。字符长度为1~64。

engine_id

是

String

微服务引擎ID。
表2 Query参数

参数

是否必选

参数类型

描述

offset

否

String

分页的页码。

limit

否

String

每页显示的条目数量。

from-time

否

String

查询日期范围的起始时间。

to-time

否

String

查询日期范围的结束时间。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

X-Enterprise-Project-ID

否

String

如果不带则默认企业项目为"default"，ID为"0"。

缺省值：0

Content-Type

是

String

该字段内容填为 "application/json;charset=UTF-8"。

Accept

是

String

该字段内容填为 "application/json"

响应参数

状态码： 200
表4 响应Body参数

参数

参数类型

描述

total

Integer

引擎任务总数。

data

Array of Job objects

任务列表
表5 Job

参数

参数类型

描述

id

Integer

任务ID。

engineId

String

任务所属引擎ID。

type

String

任务类型。

枚举值：

  • Create
  • Delete
  • Update
  • Upgrade
  • Configure
  • Modify

description

String

任务描述。

status

String

任务状态。

枚举值：

  • PreInit
  • Init
  • Executing
  • Error
  • Timeout
  • Finished

scheduling

Integer

任务是否正在执行，0表示不在执行，1表示执行中。

createUser

String

任务创建者。

startTime

Long

任务开始时间。

endTime

Long

任务结束时间。

context

String

任务执行上下文。

tasks

Array of Task objects

任务包含的处理阶段。
表6 Task

参数

参数类型

描述

jobId

Integer

子任务所属任务ID。

id

Long

子任务ID，使用uuid。

type

String

子任务的类型。

枚举值：

  • Create
  • Delete
  • Update
  • Upgrade
  • Configure
  • Modify

assigned

String

子任务的执行者。

taskName

String

子任务名称。

engineName

String

子任务所属引擎名称。

taskOrder

Integer

子任务执行的顺序，从小到大。

status

String

子任务状态。

枚举值：

  • PreInit
  • Init
  • Executing
  • Error
  • Timeout
  • Finished

startTime

Long

子任务开始时间。

endTime

Long

子任务结束时间。

createTime

Long

子任务创建时间。

updateTime

Long

子任务更新时间。

timeout

Integer

子任务是否超时。

log

String

子任务详细信息，执行过程中产生的辅助信息。

output

String

子任务输出信息。

缺省值：{}

taskExecutorBrief

TaskExecutorBrief object

任务元数据。
表7 TaskExecutorBrief

参数

参数类型

描述

duration

Long

子任务持续时长。

description

String

子任务描述。
状态码： 400
表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误信息。

detail

String

详细定位信息。
状态码： 500
表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误信息。

detail

String

详细定位信息。

请求示例

GET https://{endpoint}/v2/{project_id}/enginemgr/engines/{engine_id}/jobs

响应示例

状态码： 200

success

{
  "total": 100,
  "data": [
    {
      "id": 12339,
      "engineId": "ad76972c-a743-4770-859c-c98a680f4d98",
      "type": "Create",
      "description": "",
      "status": "Finished",
      "scheduling": 0,
      "createUser": "test",
      "startTime": 1636540095901,
      "endTime": 1636540460230,
      "context": "string",
      "tasks": [
        {
          "jobId": 12339,
          "id": 89117,
          "type": "Create",
          "assigned": "string",
          "taskName": "TenantTaskExecutor",
          "engineName": "test",
          "taskOrder": 0,
          "status": "Init",
          "startTime": 1636540100216,
          "endTime": 1636540110215,
          "createTime": 1636540095910,
          "updateTime": 1636540110230,
          "timeout": -1,
          "log": "string",
          "output": "{}",
          "taskExecutorBrief": {
            "duration": 6000,
            "description": "租户处理"
          }
        }
      ]
    }
  ]
}

状态码

状态码

描述

200

success

400

错误的请求。

500

服务器内部错误。

错误码

请参见CSE错误码。

父主题： 引擎管理