更新工作流模版
更新时间:2026-09-04
描述
更新一个已有的工作流模版(Pipeline)。Body 中所有字段均为可选,仅透传调用方实际提供的字段(未传字段保持原值不变)。
请求结构
Bash
1POST /?action=UpdatePipeline&pipelineId=xxxx
2Host:aihc.bj.baidubce.com
3Authorization:authorization string
4ContentType: application/json; charset=utf-8
5Version: v2
请求头域
除公共头域外,无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 说明 |
|---|---|---|---|---|
| pipelineId | String | 是 | Query参数 | 待更新的 Pipeline ID |
| name | String | 否 | Body参数 | Pipeline 名称,1~255 字符 |
| description | String | 否 | Body参数 | 描述 |
| manifest | String | 否 | Body参数 | Pipeline 定义的 Base64 字符串 |
| pipelineType | String | 否 | Body参数 | Pipeline 类型,支持 normal、cron |
| cronExpression | String | 否 | Body参数 | 五段式 Cron 表达式 |
| disabled | String | 否 | Body参数 | 是否禁用,取值 true/false |
| resourcePoolId | String | 否 | Body参数 | 资源池 ID |
| concurrencyPolicy | String | 否 | Body参数 | 并发策略,支持 Allow、Forbid、Replace |
返回头域
除公共头域,无其它特殊头域。
返回参数
更新后的 Pipeline 对象扁平输出,并附加 requestId。
| 参数名称 | 类型 | 说明 |
|---|---|---|
| requestId | String | 请求 ID |
| pipelineId | String | Pipeline ID |
| name | String | Pipeline 名称 |
| pipelineType | String | Pipeline 类型 |
| status | String | 状态 |
| createdAt | String | 创建时间 |
| updatedAt | String | 更新时间 |
返回体透传后端返回的全部 Pipeline 字段,上表为主要字段示例。
请求示例
JSON
1{
2 "name": "syf-test-openapi-pipeline",
3 "manifest": "version: v1\nkind: PipelineTemplate\ntaskTemplates:\n - name: custom-task-template\n type: CustomTask\n inputs:\n - name: queue_id\n type: string\n hint: 队列ID\n - name: command\n type: string\n hint: 执行命令\n - name: image_url\n type: string\n hint: 镜像地址\n - name: cpu\n type: int\n hint: CPU申请配额(核)\n defaultValue: 1\n - name: memory\n type: int\n hint: 内存申请配额(GB)\n defaultValue: 2\n spec:\n queue: '{{inputs.parameters.queue_id}}'\n jobType: PyTorchJob\n command: '{{inputs.parameters.command}}'\n jobSpec:\n replicas: 1\n image: '{{inputs.parameters.image_url}}'\n resources:\n - name: cpu\n quantity: '{{inputs.parameters.cpu}}'\n - name: memory\n quantity: '{{inputs.parameters.memory}}'\n datasources: []\ntasks:\n - name: first_workflow_task_demo\n taskTemplateName: custom-task-template\n inputs:\n - name: queue_id\n value: aihcq-a7gfnn99lplg\n - name: command\n value: echo \"This is your first workflow task.\"\n - name: image_url\n value: registry.baidubce.com/aihc-aiak/aiak-megatron:ubuntu20.04-cu11.8-torch1.14.0-py38_v1.2.7.12_release\n - name: cpu\n value: 0.5\n - name: memory\n value: 1",
4 "description": "示例 Pipeline",
5 "pipelineType": "cron",
6 "disabled": "false",
7 "cronExpression": "0 0 * * *",
8 "resourcePoolId": "aihc-g9qm0av79z06",
9 "concurrencyPolicy": "Allow"
10}
返回示例
JSON
1{
2 "$schema": "https://10.209.54.223:8789/api/aihc/workflow-service/v1/schemas/Pipeline.json",
3 "cceClusterId": "cce-gklhjnq8",
4 "concurrencyPolicy": "Allow",
5 "createdAt": "2026-08-19T10:17:38Z",
6 "cronExpression": "0 0 * * *",
7 "description": "示例 Pipeline",
8 "disabled": "false",
9 "id": 679,
10 "manifest": "dmVyc2lvbjogdjEKa2luZDogUGlwZWxpbmVUZW1wbGF0ZQp0YXNrVGVtcGxhdGVzOgogIC0gbmFtZTogY3VzdG9tLXRhc2stdGVtcGxhdGUKICAgIHR5cGU6IEN1c3RvbVRhc2sKICAgIGlucHV0czoKICAgICAgLSBuYW1lOiBxdWV1ZV9pZAogICAgICAgIHR5cGU6IHN0cmluZwogICAgICAgIGhpbnQ6IOmYn+WIl0lECiAgICAgIC0gbmFtZTogY29tbWFuZAogICAgICAgIHR5cGU6IHN0cmluZwogICAgICAgIGhpbnQ6IOaJp+ihjOWRveS7pAogICAgICAtIG5hbWU6IGltYWdlX3VybAogICAgICAgIHR5cGU6IHN0cmluZwogICAgICAgIGhpbnQ6IOmVnOWDj+WcsOWdgAogICAgICAtIG5hbWU6IGNwdQogICAgICAgIHR5cGU6IGludAogICAgICAgIGhpbnQ6IENQVeeUs+ivt+mFjeminSjmoLjvvIkKICAgICAgICBkZWZhdWx0VmFsdWU6IDEKICAgICAgLSBuYW1lOiBtZW1vcnkKICAgICAgICB0eXBlOiBpbnQKICAgICAgICBoaW50OiDlhoXlrZjnlLPor7fphY3pop0oR0IpCiAgICAgICAgZGVmYXVsdFZhbHVlOiAyCiAgICBzcGVjOgogICAgICBxdWV1ZTogJ3t7aW5wdXRzLnBhcmFtZXRlcnMucXVldWVfaWR9fScKICAgICAgam9iVHlwZTogUHlUb3JjaEpvYgogICAgICBjb21tYW5kOiAne3tpbnB1dHMucGFyYW1ldGVycy5jb21tYW5kfX0nCiAgICAgIGpvYlNwZWM6CiAgICAgICAgcmVwbGljYXM6IDEKICAgICAgICBpbWFnZTogJ3t7aW5wdXRzLnBhcmFtZXRlcnMuaW1hZ2VfdXJsfX0nCiAgICAgICAgcmVzb3VyY2VzOgogICAgICAgICAgLSBuYW1lOiBjcHUKICAgICAgICAgICAgcXVhbnRpdHk6ICd7e2lucHV0cy5wYXJhbWV0ZXJzLmNwdX19JwogICAgICAgICAgLSBuYW1lOiBtZW1vcnkKICAgICAgICAgICAgcXVhbnRpdHk6ICd7e2lucHV0cy5wYXJhbWV0ZXJzLm1lbW9yeX19JwogICAgICBkYXRhc291cmNlczogW10KdGFza3M6CiAgLSBuYW1lOiBmaXJzdF93b3JrZmxvd190YXNrX2RlbW8KICAgIHRhc2tUZW1wbGF0ZU5hbWU6IGN1c3RvbS10YXNrLXRlbXBsYXRlCiAgICBpbnB1dHM6CiAgICAgIC0gbmFtZTogcXVldWVfaWQKICAgICAgICB2YWx1ZTogYWloY3EtYTdnZm5uOTlscGxnCiAgICAgIC0gbmFtZTogY29tbWFuZAogICAgICAgIHZhbHVlOiBlY2hvICJUaGlzIGlzIHlvdXIgZmlyc3Qgd29ya2Zsb3cgdGFzay4iCiAgICAgIC0gbmFtZTogaW1hZ2VfdXJsCiAgICAgICAgdmFsdWU6IHJlZ2lzdHJ5LmJhaWR1YmNlLmNvbS9haWhjLWFpYWsvYWlhay1tZWdhdHJvbjp1YnVudHUyMC4wNC1jdTExLjgtdG9yY2gxLjE0LjAtcHkzOF92MS4yLjcuMTJfcmVsZWFzZQogICAgICAtIG5hbWU6IGNwdQogICAgICAgIHZhbHVlOiAwLjUKICAgICAgLSBuYW1lOiBtZW1vcnkKICAgICAgICB2YWx1ZTogMQ==",
11 "name": "syf-test-openapi-pipeline",
12 "pipelineId": "pipe-b3twd8",
13 "pipelineType": "cron",
14 "region": "bj",
15 "requestId": "4b474be9-4859-46b1-992e-cd7186fcfbf0",
16 "resourcePoolId": "aihc-g9qm0av79z06",
17 "status": "running",
18 "updatedAt": "2026-08-24T08:50:23Z",
19 "userId": "bea4cf865bc94bc183ecc43a70b4f910",
20 "userName": "v_suiyufei",
21 "version": 0
22}
评价此篇文章
