# 根据发布单ID创建触发策略 - CreateTriggerPolicyBasedOnTheReleaseTaskID
#### 功能介绍
此API用来根据发布单ID创建发布单触发策略。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-servicestage/servicestage_06_0183.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                          | 访问级别  | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | servicestage:pipeline:create | write | pipeline \* | -   | -  | -      |
     
  
 
#### URI
POST /v3/{project_id}/pipeline/pipelines/{pipeline_id}/hooks
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| project_id  | 是    | String | **参数解释：** 租户项目ID。获取方法，请参考[获取项目ID](https://support.huaweicloud.com/api-servicestage/servicestage_06_0164.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| pipeline_id | 是    | String | **参数解释：** 发布单ID。获取方法，请参考[获取发布单列表 - ObtainReleaseTaskList](https://support.huaweicloud.com/api-servicestage/servicestage_06_0246.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                              |
   
#### 请求消息
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| Content-Type | 是    | String | **参数解释：** 消息体的类型（格式）。 **约束限制：** 不涉及 **取值范围：** application/json;charset=utf8 **默认取值：** 不涉及                                                                                                                              |
| X-Auth-Token | 是    | String | **参数解释：** 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考[认证鉴权](https://support.huaweicloud.com/api-servicestage/servicestage_06_0010.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
   
表3请求Body参数 
| 参数             | 是否必选 | 参数类型             | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| selected_tasks | 否    | Array of objects | 需要执行的任务，若不传或传null表示全部执行，请参考[表4]。                                                                                                                                                                                                                                                                                                                                         |
| strategy_type  | 是    | Integer          | 触发策略。 - 0，手动触发。  - 1，定时触发。   |
| hooks          | 否    | Array of objects | 定时策略，当"strategy_type"为1时必填，请参考[表5]。                                                                                                                                                                                                                                                                                                                                         |
   
 表4selected_tasks 
| 参数         | 是否必选 | 参数类型             | 描述         |
|:---|:---|:---|:---|
| stage_name | 是    | String           | 阶段名称。      |
| tasks      | 是    | Array of strings | 需要执行的任务名称。 |
   
 表5hooks 
| 参数                | 是否必选 | 参数类型    | 描述                         |
|:---|:---|:---|:---|
| schedule          | 是    | String  | 定时正则表达式。                   |
| timezone_operator | 是    | String  | 表示偏移量的方向，即时间是提前（+）还是延后（-）。 |
| timezone_hour     | 是    | Integer | 相对于UTC（协调世界时）的小时偏移量。       |
   
#### 请求示例
创建发布单定时触发策略。
```
{
    "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错误码](https://support.huaweicloud.com/api-servicestage/servicestage_06_0162.html)。