更新时间:2026-04-07 GMT+08:00

获取Job详情

功能介绍

该API用于获取指定项目下的Job详情。

调用方法

请参见如何调用API。

URI

GET /api/v2/projects/{project_id}/jobs/{job_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID,获取方式请参见如何获取接口URI中参数。

约束限制:

不涉及

取值范围:

账号的项目ID

默认取值:

不涉及

job_id

是

String

参数解释:

任务ID,获取方式请参见如何获取接口URI中参数。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

参数解释:

消息体的类型(格式)

约束限制:

GET方法不做校验

取值范围:

  • application/json

  • application/json;charset=utf-8

  • application/x-pem-file

  • multipart/form-data(注:存在FormData参数时使用)

默认取值:

不涉及

X-Auth-Token

是

String

参数解释:

调用接口的认证方式分为Token和AK/SK两种,如果您使用的Token方式,此参数为必填,请填写Token的值,获取方式请参见获取token。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

kind

String

参数解释:

API类型

约束限制:

不涉及

取值范围:

不涉及

默认取值:

Job

apiVersion

String

参数解释:

API版本

约束限制:

不涉及

取值范围:

不涉及

默认取值:

v2

metadata

V2JobTypeObject object

参数解释:

Job元数据

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

spec

V2JobSpec object

参数解释:

Job信息详情

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

status

V2JobStatus object

参数解释:

Job状态

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表4 V2JobSpec

参数

参数类型

描述

type

String

参数解释:

Job 类型

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

clusteruid

String

参数解释:

集群ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

resourceid

String

参数解释:

资源ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

resourcename

String

参数解释:

资源名称

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

extendparam

Map<String,String>

参数解释:

Job的扩容参数

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

subjobs

Array of V2Job objects

参数解释:

子Job详情列表

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表5 V2Job

参数

参数类型

描述

kind

String

参数解释:

API类型

约束限制:

不涉及

取值范围:

不涉及

默认取值:

Job

apiVersion

String

参数解释:

API版本

约束限制:

不涉及

取值范围:

不涉及

默认取值:

v2

metadata

V2JobTypeObject object

参数解释:

Job元数据

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

spec

V2JobSpec object

参数解释:

Job信息详情

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

status

V2JobStatus object

参数解释:

Job状态

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表6 V2JobTypeObject

参数

参数类型

描述

uid

String

参数解释:

Job UUID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

creationTimestamp

String

参数解释:

Job 创建时间

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

updateTimestamp

String

参数解释:

Job 最后更新时间

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表7 V2JobStatus

参数

参数类型

描述

status

String

参数解释:

Job的状态

约束限制:

不涉及

取值范围:

  • Initializing:未执行

  • Running:执行中

  • Failed:执行失败

  • Success:执行成功

默认取值:

不涉及

reason

String

参数解释:

Job执行失败的原因

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

completionTime

String

参数解释:

Job完成时间

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求示例

无

响应示例

状态码:200

{
  "kind" : "Job",
  "apiVersion" : "v2",
  "metadata" : {
    "uid" : "e43c6f3b-87e6-11f0-be88-0255ac10003f",
    "creationTimestamp" : "2025-09-02 10:23:38.987955 +0000 UTC",
    "updateTimestamp" : "2025-09-02 11:26:03.218087 +0000 UTC"
  },
  "spec" : {
    "type" : "ScaleupCluster",
    "clusteruid" : "7ec8b73d-83db-11f0-8baa-0255ac10003e",
    "resourceid" : "3b4410fa-87e6-11f0-be88-0255ac10003f",
    "resourcename" : "node-iv28j9",
    "extendparam" : {
      "claimrollback" : "true",
      "node.zone" : "cn-north-7c",
      "nodepooluid" : "",
      "orderID" : "CS25090218238EI5V",
      "v3-scaleup" : "true"
    }
  },
  "status" : {
    "status" : "Failed",
    "reason" : "Something bad happened at server, recycle resource",
    "completionTime" : "2025-09-02 11:26:03.218087 +0000 UTC"
  }
}

状态码

状态码

描述

200

错误码

请参见错误码。