文档首页/ 代码托管 CodeArts Repo/ API参考/ API/ V4/ Pipeline/ 获取流水线的关联的最新任务
更新时间：2025-07-24 GMT+08:00
查看PDF
分享

获取流水线的关联的最新任务

功能介绍

获取流水线的关联的最新任务

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v4/repositories/{repository_id}/pipelines/{pipeline_id}/latest-jobs

表1 路径参数

参数

是否必选

参数类型

描述

repository_id

是

Integer

参数解释：

仓库的ID，通过查询用户所有仓库接口查询项目列表获取。

约束限制：

不涉及。

取值范围：

1-2147483647

pipeline_id

是

Integer

参数解释：

流水线 id。

取值范围：

1-2147483647

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

约束限制：

必传。

取值范围：

字符串长度不少于1，不超过10万。

默认取值：

不涉及。

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

id

Integer

流水线ID

取值范围：

1-2147483647

status

String

流水线状态，pending为排队，running为运行中，success为成功，failed为失败，canceled为取消，skipped为跳过，timedout为超时

枚举值：

  • pending

  • running

  • success

  • failed

  • canceled

  • skipped

  • timedout

stages

Array of PipelineStageJobDto objects

流水线阶段带任务
表4 PipelineStageJobDto

参数

参数类型

描述

id

Integer

阶段ID

取值范围：

1-2147483647

name

String

阶段名称

sort_id

Integer

阶段顺序ID

取值范围：

1-2147483647

status

String

阶段状态, pending为排队，running为运行中，success为成功，failed为失败，canceled为取消，skipped为跳过，timedout为超时

枚举值：

  • pending

  • running

  • success

  • failed

  • canceled

  • skipped

  • timedout

jobs

Array of BaseJobDto objects

任务详情
表5 BaseJobDto

参数

参数类型

描述

id

Integer

任务ID

取值范围：

1-2147483647

sha

String

提交ID

ref

String

分支

status

String

阶段状态, pending为排队，running为运行中，success为成功，failed为失败，canceled为取消，skipped为跳过，timedout为超时

枚举值：

  • pending

  • running

  • success

  • failed

  • canceled

  • skipped

  • timedout

name

String

任务名称

target_url

String

任务链接

created_at

String

创建时间

updated_at

String

更新时间

started_at

String

开始时间

finished_at

String

结束时间

third_build_id

String

任务在构建系统中的ID

状态码：401

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

error_msg

String

参数解释：

错误信息。

状态码：404

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

error_msg

String

参数解释：

错误信息。

请求示例

GET https://{endpoint}/v4/repositories/2111976239/pipelines/6/latest-jobs

响应示例

状态码：200

OK

{
  "id" : 6,
  "status" : "success",
  "stages" : [ {
    "id" : 8125,
    "name" : "external",
    "status" : "success",
    "sort_id" : null,
    "jobs" : [ {
      "id" : 31930,
      "sha" : "1c46c505c84853887efe2ea9ea02a1333bae2237",
      "ref" : "dev",
      "status" : "success",
      "name" : "任务1",
      "target_url" : "https://example.com/cicd/project/72271b5446614062a01b8be944c9f372/pipeline/detail/724cb378007d4303b91f85161f67d6b0/c9cfdc8b918e44c09ad1cdd8c6b13c78\"",
      "created_at" : "2025-05-17T11:02:25.000+08:00",
      "started_at" : "2025-05-17T11:02:25.000+08:00",
      "finished_at" : "2025-05-17T11:02:56.000+08:00",
      "updated_at" : "2025-05-17T11:02:56.000+08:00",
      "third_build_id" : "0ede266890ddd33cff76da30090b9780"
    } ]
  } ]
}

状态码：401

Unauthorized

{
  "error_code" : "CH.00000002",
  "error_msg" : "认证信息无法识别"
}

状态码：404

Not Found

{
  "error_code" : "CH.00402000",
  "error_msg" : "该仓库不存在,请检查后重试。"
}

状态码

状态码

描述

200

OK

401

Unauthorized

404

Not Found

错误码

请参见错误码。

父主题： Pipeline

相关文档