替换流水线执行状态。
接口说明
API 提供了乐观锁机制,在不设置强制更新的场景下,需要基于最新的流水线触发器配置修改后提交,否则将触发提交冲突异常。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
 - 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
 - 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用前面加 * 表示。
 - 对于不支持资源级授权的操作,用
全部资源表示。 
 - 条件关键字:是指云产品自身定义的条件关键字。
 - 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
 
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 | 
|---|---|---|---|---|
| devs:PutPipelineStatus | update | *全部资源 * | 
  | 无 | 
请求语法
PUT /2023-07-14/pipelines/{name}/status HTTP/1.1
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 | 
|---|---|---|---|---|
| name | string | 否 | 对象名称  | demo-name | 
| body | Pipeline | 否 | 流水线执行  | |
| force | boolean | 否 | 强制更新  | false | 
返回参数
示例
正常返回示例
JSON格式
{
  "spec": {
    "templateName": "my-pipeline-template",
    "context": {
      "data": {
        "test": "test",
        "test2": 1
      }
    },
    "templateSpec": {
      "context": {
        "data": {
          "test": "test",
          "test2": 1
        }
      },
      "tasks": [
        {
          "name": "task-1",
          "context": {
            "data": {
              "test": "test",
              "test2": 1
            }
          },
          "taskTemplate": "serverless-runner",
          "runAfters": [
            {
              "name": "task-1"
            }
          ]
        }
      ],
      "contextSchema": {
        "test": "test",
        "test2": 1
      }
    }
  },
  "status": {
    "phase": "Success",
    "latestExecError": {
      "title": "权限不足错误",
      "message": "部署服务[_appcenter-xxx]失败,权限不足",
      "code": "AccessDenied",
      "requestId": "1-26d1287xxxxx",
      "extraInfo": "部署辅助函数权限不足,需要添加额外的权限以解决问题"
    }
  },
  "uid": "1455541096***548",
  "generation": 1,
  "description": "Pipeline example.",
  "kind": "Pipeline",
  "createdTime": "2021-11-19T09:34:38Z",
  "name": "my-pipeline",
  "labels": {
    "key": "value to the label key."
  },
  "resourceVersion": 1
}错误码
访问错误中心查看更多错误码。
