文档

GetPipelineRun - 获取工作流任务信息

更新时间:

获取工作流任务详情信息。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求语法

GET /api/v1/pipelineruns/{PipelineRunId}

请求参数

名称类型必填描述示例值
PipelineRunIdstring

工作流任务ID。如何获取工作流任务ID,请参见ListPipelineRuns

run-rbvg**********ks92
Verboseboolean

是否返回详细信息,取值如下。

  • 关闭开关:不显示详细信息。
  • 打开开关:显示详细信息,目前详细信息包含Manifest字段。
false
ManifestTypestring

具体返回哪种类型的Manifest信息,取值如下。

  • Raw(默认):用户提交的原始Manifest。
  • Frozen:针对每个Pipeline生成唯一Uuid,将其版本固化下来。即使遇到子Pipeline定义三元组不变进行升级,依然会使用一开始的版本(Uuid),不受影响;即可基于该Manifest进行重跑。
  • Rendered:将相关信息进行注入和渲染,包括:补全运行环境信息并优化等。
Raw

返回参数

名称类型描述示例值
object

返回结构体。

RequestIdstring

请求ID。

DA869D1B-035A-43B2-ACC1-C56681BD9FAA
PipelineRunIdstring

工作流任务ID。

flow-j94y**********lf7a
Namestring

工作流任务名字。

testName
Statusstring

工作流任务状态,可能值如下:

  • Initialized
  • Running
  • Succeeded
  • Failed
  • Suspended
  • Terminated
  • Unknown
  • Skipped
  • Terminating
Succeeded
Manifeststring

工作流任务的定义。

{"ApiVersion":"core/v1","Metadata":{"NodeId":"node-n06d**********fc53","Provider":"155**********904","Name":"flow-j94y**********lf7a","Version":"v1","Identifier":"9fe11111-****-****-****-****ec811861","Namespace":null,"DisplayName":"name","NodeType":"Dag"},"Spec":{}}
Argumentsstring

工作流任务的参数。

{"arguments":{"parameters":[{"name":"execution","value":{"endpoint":"http://service.******","odpsProject":"******","spec":{"endpoint":"http://service.******","odpsProject":"*****"},"resourceType":"MaxCompute"}}]}}
UserIdstring

创建用户ID。

155**********904
ParentUserIdstring

创建用户阿里云账号的ID。

155**********904
StartedAtstring

工作流任务的开始UTC时间,格式ISO8601。

2021-01-30T12:51:33.028Z
FinishedAtstring

工作流任务的结束UTC时间,格式ISO8601。

2021-01-30T12:52:33.028Z
NodeIdstring

工作流任务的节点ID。

node-n06d**********fc53
Durationlong

工作流任务的运行时长,单位为秒。

60
WorkspaceIdstring

所属工作空间ID。

15945
Messagestring

工作流任务失败提示信息。

error message
SourceTypestring

工作流任务来源类型,可能值:

  • UNKNOWN(默认):未指定来源类型时的默认值。
  • SDK:通过SDK创建的工作流任务。
  • DESIGNER:通过Designer创建的工作流任务。
  • M6:通过其他网站创建的工作流任务。
UNKNOWN
SourceIdstring

工作流任务的来源ID。

abcd*********hxfu
Optionsstring

工作流任务选项,格式为JSON。

{"mlflow":{"experimentId":"exp-**********"}}
GmtCreateTimestring

创建UTC时间,格式ISO8601。

2021-01-30T12:51:33.028Z
GmtModifiedTimestring

最近修改UTC时间,格式ISO8601。

2021-01-30T12:51:33.028Z
PipelineIdstring

工作流ID。

pipeline-j94y**********lf7a
Accessibilitystring

工作流任务的可见性,目前支持:

  • PUBLIC
  • PRIVATE
PUBLIC
PipelineRunUristring

工作流任务详情URL。

https://pai.console.aliyun.com/?regionId=cn-shanghai&workspaceId=24****#/studio/task/detail/flow-dsfbjt4k07lvp1****

示例

正常返回示例

JSON格式

{
  "RequestId": "DA869D1B-035A-43B2-ACC1-C56681BD9FAA\n",
  "PipelineRunId": "flow-j94y**********lf7a\n",
  "Name": "testName",
  "Status": "Succeeded",
  "Manifest": "{\"ApiVersion\":\"core/v1\",\"Metadata\":{\"NodeId\":\"node-n06d**********fc53\",\"Provider\":\"155**********904\",\"Name\":\"flow-j94y**********lf7a\",\"Version\":\"v1\",\"Identifier\":\"9fe11111-****-****-****-****ec811861\",\"Namespace\":null,\"DisplayName\":\"name\",\"NodeType\":\"Dag\"},\"Spec\":{}}",
  "Arguments": "{\"arguments\":{\"parameters\":[{\"name\":\"execution\",\"value\":{\"endpoint\":\"http://service.******\",\"odpsProject\":\"******\",\"spec\":{\"endpoint\":\"http://service.******\",\"odpsProject\":\"*****\"},\"resourceType\":\"MaxCompute\"}}]}}",
  "UserId": "155**********904\n",
  "ParentUserId": "155**********904\n",
  "StartedAt": "2021-01-30T12:51:33.028Z\n",
  "FinishedAt": "2021-01-30T12:52:33.028Z\n",
  "NodeId": "node-n06d**********fc53\n",
  "Duration": 60,
  "WorkspaceId": "15945",
  "Message": "error message\n",
  "SourceType": "UNKNOWN",
  "SourceId": "abcd*********hxfu\n",
  "Options": "{\"mlflow\":{\"experimentId\":\"exp-**********\"}}\n",
  "GmtCreateTime": "2021-01-30T12:51:33.028Z\n",
  "GmtModifiedTime": "2021-01-30T12:51:33.028Z\n",
  "PipelineId": "pipeline-j94y**********lf7a\n",
  "Accessibility": "PUBLIC",
  "PipelineRunUri": "https://pai.console.aliyun.com/?regionId=cn-shanghai&workspaceId=24****#/studio/task/detail/flow-dsfbjt4k07lvp1****"
}

错误码

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

变更历史

变更时间变更内容概要操作
2022-12-15OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更
2022-06-14新增 OpenAPI看变更集
  • 本页导读 (1)
文档反馈