获取Job列表 - ListAutopilotJobs

功能介绍

该API用于获取指定项目下的所有jobs。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，当前API调用无需身份策略权限。

URI

GET /autopilot/v2/projects/{project_id}/jobs

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID，获取方式请参见如何获取接口URI中参数。约束限制：不涉及取值范围：账号的项目ID 默认取值：不涉及

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
Content-Type	是	String	参数解释：消息体的类型（格式），默认为application/json，有其他取值时会在具体接口中专门说明。约束限制： GET方法不做校验默认取值：不涉及
X-Auth-Token	是	String	参数解释：调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值，获取方式请参见获取token。约束限制：不涉及取值范围：不涉及默认取值：不涉及

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
[数组元素]	Array of V2Job objects	参数解释： Job详情列表约束限制：不涉及取值范围：不涉及默认取值：不涉及

表4 V2Job
参数	参数类型	描述
kind	String	参数解释： API类型约束限制：不涉及取值范围：不涉及默认取值： Job
apiVersion	String	参数解释： API版本约束限制：不涉及取值范围：不涉及默认取值： v2
metadata	V2JobTypeObject object	参数解释： Job元数据约束限制：不涉及取值范围：不涉及默认取值：不涉及
spec	V2JobSpec object	参数解释： Job信息详情约束限制：不涉及取值范围：不涉及默认取值：不涉及
status	V2JobStatus object	参数解释： Job状态约束限制：不涉及取值范围：不涉及默认取值：不涉及

表5 V2JobTypeObject
参数	参数类型	描述
uid	String	参数解释： Job UUID 约束限制：不涉及取值范围：不涉及默认取值：不涉及
creationTimestamp	String	参数解释： Job 创建时间约束限制：不涉及取值范围：不涉及默认取值：不涉及
updateTimestamp	String	参数解释： Job 最后更新时间约束限制：不涉及取值范围：不涉及默认取值：不涉及

表6 V2JobSpec
参数	参数类型	描述
type	String	参数解释： Job 类型约束限制：不涉及取值范围：不涉及默认取值：不涉及
clusteruid	String	参数解释：集群ID 约束限制：不涉及取值范围：不涉及默认取值：不涉及
resourceid	String	参数解释：资源ID 约束限制：不涉及取值范围：不涉及默认取值：不涉及
resourcename	String	参数解释：资源名称约束限制：不涉及取值范围：不涉及默认取值：不涉及
extendparam	Map<String,String>	参数解释： Job的扩容参数约束限制：不涉及取值范围：不涉及默认取值：不涉及
subjobs	Array of V2Job objects	参数解释：子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"
  }
} ]