可以获取流水线实例分组的状态。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String GetPipelineInstanceGroupStatus

系统规定参数。取值:GetPipelineInstanceGroupStatus。

FlowInstanceId Long 123

流水线运行实例ID,ExecutePipeline 返回值

OrgId String 5ebbc0228123212b59xxxxx

企业标识,也称企业id,字符串形式,可在云效访问链接中获取,如

https://devops.aliyun.com/organization/【OrgId】

PipelineId Long 123

流水线ID,可在流水线链接中获取,如

https://flow.aliyun.com/pipelines/【PipelineId】/current

UserPk String 1234354314543321

用户pk,非必填,只有调用接口使用的ak和用户pk不一致时,才需要

返回数据

名称 类型 示例值 描述
ErrorCode String ""

错误码

ErrorMessage String ""

错误信息

Object Struct

实例信息

Groups Array of group

分组

Name String JAVA构建

分组名称

Stages Array of stage

阶段

Components Array of component

任务

JobId String 1234

任务ID

Name String java构建

任务名称

Status String SUCCESS

FINISH 运行完成

RUNNING 运行中

CANCELED 已取消

WAITING 等待中

INIT 未开始

SUCCESS 成功

Sign String Group1-Stage1

阶段标识

Status String SUCCESS

FINISH 运行完成

RUNNING 运行中

CANCELED 已取消

WAITING 等待中

INIT 未开始

SUCCESS 成功

Status String SUCCESS

状态 FAIL 运行失败 SUCCESS 运行成功 RUNNING 运行中

Status String SUCCESS

状态 FAIL 运行失败 SUCCESS 运行成功 RUNNING 运行中

RequestId String ASSDS-ASSASX-XSAXSA-XSAXSAXS

请求ID,每次请求都是唯一值,便于后续排查问题

Success Boolean true

true 接口调用成功,false 接口调用失败

示例

请求示例

http(s)://[Endpoint]/?Action=GetPipelineInstanceGroupStatus
&FlowInstanceId=123
&OrgId=5ebbc0228123212b59xxxxx
&PipelineId=123
&<公共请求参数>

正常返回示例

JSON格式

{"RequestId":"ASSDS-ASSASX-XSAXSA-XSAXSAXS","Object":{"Status":"SUCCESS","Groups":[{"Status":"SUCCESS","Name":"JAVA构建","Stages":[{"Status":"SUCCESS","Sign":"Group1-Stage1","Components":[{"Status":"SUCCESS","JobId":"1234","Name":"java构建"}]}]}]},"ErrorCode":"\"\"","ErrorMessage":"\"\"","Success":"true"}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidPipeline.NotFound The specified pipeline does not exist. 未找到流水线
404 InvalidUser.NotFound The specified user does not exist. 用户数据有误,未找到该用户
400 InvalidUser.UserNotInCurrentOrganization The user does not belong to the specified organization. 当前用户不属于该企业
500 SystemError.UnKnownError An error occurred while processing your request. 系统未知异常
404 InvalidOrganization.NotFound The specified organization doe not exist. 企业信息有误,未找到该企业

访问错误中心查看更多错误码。