获取流水线运行实例_云效(Apsara Devops)-阿里云帮助中心

通过 OpenAPI 获取流水线运行实例。

适用版本

企业标准版

服务接入点与授权信息

获取服务接入点，替换 API 请求语法中的 <domain> ：服务接入点（domain）。
获取个人访问令牌，具体操作，请参见获取个人访问令牌。
产品
资源
所需权限
流水线
流水线运行实例
只读

请求语法

GET https://{domain}/oapi/v1/flow/organizations/{organizationId}/pipelines/{pipelineId}/runs/{pipelineRunId}

请求头

参数	类型	是否必填	描述	示例值
x-yunxiao-token	string	是	个人访问令牌。	pt-0fh3**0fbG_35af**0484

请求参数

参数	类型	位置	是否必填	描述	示例值
organizationId	string	path	是	企业 Id。	5ebbc0228123212b59xxxxx
pipelineId	string	path	是	流水线 Id。	36**66
pipelineRunId	string	path	是	流水线运行 Id。	1

请求示例

curl -X 'GET' \
  'https://test.rdc.aliyuncs.com/oapi/v1/flow/organizations/5ebbc0228123212b59xxxxx/pipelines/123/runs/1' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484'

返回参数

参数	类型	描述	示例值
-	object
createTime	integer	开始时间。	1590730400000
creatorAccountId	string	创建人。	1222222222
modifierAccountId	string	更新人。	1222222222
pipelineId	integer	流水线 id。	36**66
pipelineRunId	integer	流水线运行 id。	1
sources	array
-	object
data	object
branch	string	默认分支。	master
cloneDepth	integer	克隆深度。	1
credentialId	integer	服务证书 id。	222
credentialLabel	string	证书显示名称。	企业公钥
credentialType	string	证书类型。	region-ssh
events	array[string]	触发事件。
isBranchMode	boolean	触发过滤条件。	false
isCloneDepth	boolean	是否设置克隆深度。	true
isSubmodule	boolean	是否子模块。	false
isTrigger	boolean	是否开启提交触发。	true
label	string	展示名称。	cdup/ss
namespace	string	github 命名空间。	asasasas
repo	string	仓库地址。	https://codeup.aliyun.com/test.git
serviceConnectionId	integer	服务连接 id。	12
triggerFilter	string	触发过滤条件。	.*
webhook	string	webhook 地址。	https://flow.aliyun/webhook/asassasa
name	string	代码源名称。	示例代码源
sign	string	代码源标识。	assaaaaaasasasa
type	string	代码源类型 aliyunGit 阿里云代码库 customGitlab 自建 git giteeGit 码云 codeup Codeup git 通用 git gitlab gitlab bitbucket bitbucket githubOAuth github。	Codeup
stageGroup	array[string]
stages	array	阶段详情。
-	object
name	string	阶段名称。	Java 构建
stageInfo	object
endTime	integer	结束时间。	1729178040000
jobs	array	任务列表。
-	object
endTime	integer	结束时间。	1729178040000
id	integer	任务 id。	21212
name	string	任务名称。	Java 构建
params	string	运行参数。	{}
startTime	integer	开始时间。	1590730400000
status	string	状态 FAIL 运行失败 SUCCESS 运行成功 RUNNING 运行中。	RUNNING
name	string	阶段名称。	Java 构建
startTime	integer	开始时间。	1590730400000
status	string	状态 FAIL 运行失败 SUCCESS 运行成功 RUNNING 运行中。	RUNNING
status	string	状态 FAIL 运行失败 SUCCESS 运行成功 RUNNING 运行中。	RUNNING
triggerMode	integer	触发模式 1人工触发 2定时触发 3代码提交触发 5流水线触发6WEBHOOK 触发。	1
updateTime	integer	更新时间。	1590730400000

返回示例

{
    "createTime": 1590730400000,
    "creatorAccountId": "1222222222",
    "modifierAccountId": "1222222222",
    "pipelineId": 36**66,
    "pipelineRunId": 1,
    "sources": [
        {
            "data": {
                "branch": "master",
                "cloneDepth": 1,
                "credentialId": 222,
                "credentialLabel": "企业公钥",
                "credentialType": "region-ssh",
                "events": [
                    
                ],
                "isBranchMode": false,
                "isCloneDepth": true,
                "isSubmodule": false,
                "isTrigger": true,
                "label": "cdup/ss",
                "namespace": "asasasas",
                "repo": "https://codeup.aliyun.com/test.git",
                "serviceConnectionId": 12,
                "triggerFilter": ".*",
                "webhook": "https://flow.aliyun/webhook/asassasa"
            },
            "name": "示例代码源",
            "sign": "assaaaaaasasasa",
            "type": "Codeup"
        }
    ],
    "stageGroup": [
        
    ],
    "stages": [
        {
            "name": "Java构建",
            "stageInfo": {
                "endTime": 1729178040000,
                "jobs": [
                    {
                        "endTime": 1729178040000,
                        "id": 21212,
                        "name": "Java构建",
                        "params": "{}",
                        "startTime": 1729178040000,
                        "status": "RUNNING"
                    }
                ],
                "name": "Java构建",
                "startTime": 1729178040000,
                "status": "RUNNING"
            }
        }
    ],
    "status": "RUNNING",
    "triggerMode": 1,
    "updateTime": 1590730400000
}

错误码

访问错误码中心查看 API 相关错误码。

产品	资源	所需权限
流水线	流水线运行实例	只读