更新时间:2025-09-25 GMT+08:00
分享

获取Job详情

功能介绍

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

调用方法

请参见如何调用API

URI

GET /autopilot/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

错误码

请参见错误码

相关文档