文档首页/ 应用管理与运维平台 ServiceStage/ API参考/ 应用管理API（v3版本）/ 发布管理/ 新版发布管理/ 根据发布单ID创建触发策略
更新时间：2025-06-30 GMT+08:00
查看PDF
分享

根据发布单ID创建触发策略

功能介绍

此API用来根据发布单ID创建发布单触发策略。

URI

POST /v3/{project_id}/pipeline/pipelines/{pipeline_id}/hooks

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户项目ID。获取方法，请参考获取项目ID。

pipeline_id

是

String

发布单ID。获取方法，请参考获取发布单列表。

请求消息

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

消息体的类型（格式），默认取值为“application/json;charset=utf8”。

X-Auth-Token

是

String

调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考认证鉴权。
表3 请求Body参数

参数

是否必选

参数类型

描述

selected_tasks

否

List of object

需要执行的任务，若不传或传null表示全部执行，请参考表4。

strategy_type

是

Integer

触发策略。

  • 0，手动触发。
  • 1，定时触发。

hooks

否

List of object

定时策略，当“strategy_type”为1时必填，请参考表5。
表4 selected_tasks

参数

是否必选

参数类型

描述

stage_name

是

String

阶段名称。

tasks

是

List of string

需要执行的任务名称。
表5 hooks

参数

是否必选

参数类型

描述

schedule

是

String

定时正则表达式。

timezone_operator

是

String

相对于UTC（协调世界时）的小时偏移量。

timezone_hour

是

Integer

表示偏移量的方向，即时间是提前（+）还是延后（-）。

请求示例

创建发布单定时触发策略。

{
    "selected_tasks": [
        {
            "stage_name": "75foki",
            "tasks": [
                "bkdi55"
            ]
        }
    ],
    "strategy_type": 1,
    "hooks": [
        {
            "schedule": "0 00-59/10 00-00 ? * MON *",
            "timezone_operator": "+",
            "timezone_hour": 8
        }
    ]
}

响应示例

无

状态码

状态码

描述

200

操作成功。

400

错误的请求。

404

请求对象不存在。

500

内部错误。

错误码

请参考ServiceStage错误码。

父主题： 新版发布管理

相关文档