触发器接口
更新时间：2025-05-26
使用前提
- 已成功创建企业版实例。
获取触发器策略列表
接口描述
获取触发器策略列表。
请求结构
Plain Text
1GET /v1/instances/{instanceId}/triggers/policies?policyName={policyName}&pageNo={pageNo}&pageSize={pageSize} HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | 实例ID |
| policyName | String | 否 | Query参数 | 触发器策略名称，支持模糊查询 |
| pageNo | Integer | 否 | Query参数 | 当前页，默认为1 |
| pageSize | Integer | 否 | Query参数 | 每页记录数，默认为10 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| total | Integer | 触发器策略总数 |
| pageNo | Integer | 当前页 |
| pageSize | Integer | 每页记录数 |
| policies | List<TriggerPolicy> | 触发器策略对象列表 |
请求示例
Plain Text
1GET /v1/instances/ccr-test/triggers/policies?policyName=trigger-test&pageNo=1&pageSize=10 HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2022-08-01T08:26:41Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Date: Fri, 05 Aug 2022 07:23:56 GMT
4X-Bce-Gateway-Region: BJ
5X-Bce-Request-Id: 9de1d766-a5de-46c0-a40c-29e916410d22
6
7{
8 "total": 1,
9 "pageNo": 1,
10 "pageSize": 10,
11 "policies": [
12 {
13 "creationTime": "2022-08-05T07:20:32.098378Z",
14 "description": "trigger-test",
15 "enabled": true,
16 "eventTypes": [
17 "UPLOAD_CHART",
18 "DOWNLOAD_CHART",
19 "DELETE_CHART"
20 ],
21 "filters": [
22 {
23 "type": "project_name",
24 "value": "ns-test"
25 },
26 {
27 "type": "repository_name",
28 "value": "ubuntu"
29 },
30 {
31 "type": "tag_name",
32 "value": "18.02"
33 }
34 ],
35 "id": 2,
36 "name": "trigger-test",
37 "targets": [
38 {
39 "address": "http://baidu.com",
40 "headers": {
41 "Authorization": "Basic dXNlcm5hbWU6cGFzc3dvcmQ="
42 }
43 }
44 ],
45 "updateTime": "2022-08-05T07:20:32.098378Z"
46 }
47 ]
48}查询触发器策略详情
接口描述
查询触发器策略详情。
请求结构
Plain Text
1GET /v1/instances/{instanceId}/triggers/policies/{policyId} HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | CCR实例ID |
| policyId | String | 是 | Path参数 | 触发器策略ID |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| creationTime | String | 触发器创建时间 |
| description | String | 触发器策略备注 |
| enabled | Boolean | 启动状态 |
| eventTypes | List<String> | 触发事件列表，返回值定义： UPLOAD_CHART（Helm Chart推送） DOWNLOAD_CHART（Helm Chart拉取） DELETE_CHART（Helm Chart删除） PUSH_ARTIFACT（制品推送） PULL_ARTIFACT（制品拉取） DELETE_ARTIFACT（制品删除） |
| filters | List<TriggerFilter> | 触发规则 |
| id | Integer | 触发器ID |
| name | String | 触发器名称 |
| targets | List<TriggerTarget> | 访问配置 |
| updateTime | String | 触发器更新时间 |
请求示例
Plain Text
1GET /v1/instances/ccr-test/triggers/policies/1 HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2022-08-01T13:07:36Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Date: Fri, 05 Aug 2022 13:04:25 GMT
4X-Bce-Gateway-Region: BJ
5X-Bce-Request-Id: 847e178c-474a-4083-9b45-02b2bc34c925
6
7{
8 "creationTime": "2022-08-05T07:19:05.797801Z",
9 "description": "触发器测试",
10 "enabled": true,
11 "eventTypes": [
12 "PUSH_ARTIFACT",
13 "PULL_ARTIFACT",
14 "DELETE_ARTIFACT"
15 ],
16 "filters": [
17 {
18 "type": "project_name",
19 "value": "ns-test"
20 },
21 {
22 "type": "repository_name",
23 "value": "ubuntu"
24 },
25 {
26 "type": "tag_name",
27 "value": "18.052"
28 }
29 ],
30 "id": 1,
31 "name": "trigger-test1",
32 "targets": [
33 {
34 "address": "http://baidu.com",
35 "headers": {
36 "Authorization": "Basic dXNlcm5hbWU6cGFzc3dvcmQ="
37 }
38 }
39 ],
40 "updateTime": "2022-08-05T07:19:05.797801Z"
41}创建触发器策略
接口描述
创建触发器策略。
请求结构
Plain Text
1POST /v1/instances/{instanceId}/triggers/policies HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string
4
5{
6 "description": {description},
7 "eventTypes": {eventTypes},
8 "filters": {filters},
9 "name": {name},
10 "targets": {targets}
11}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | CCR实例ID |
| description | String | 否 | Body参数 | 触发器策略备注 |
| eventTypes | List<String> | 是 | Body参数 | 触发事件列表，有效值为： UPLOAD_CHART（Helm Chart推送）、 DOWNLOAD_CHART（Helm Chart拉取）、 DELETE_CHART（Helm Chart删除）、 PUSH_ARTIFACT（制品推送）、 PULL_ARTIFACT（制品拉取）、 DELETE_ARTIFACT（制品删除） |
| filters | List<TriggerFilter> | 否 | Body参数 | 触发规则 |
| name | String | 是 | Body参数 | 触发器名称 |
| targets | List<TriggerTarget> | 否 | Body参数 | 访问配置 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
如果请求成功无响应参数。如果请求失败则返回标准错误结构。
请求示例
Plain Text
1POST /v1/instances/ccr-test/triggers/policies HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2022-08-01T13:07:36Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6
4
5{
6 "description": "触发器测试",
7 "eventTypes": [
8 "PUSH_ARTIFACT"
9 ],
10 "filters": [
11 {
12 "type": "project_name",
13 "value": "ns-test"
14 }
15 ],
16 "name": "trigger-test",
17 "targets": [
18 {
19 "address": "http://baidu.com",
20 "headers": {
21 "Authorization": "Basic dXNlcm5hbWU6cGFzc3dvcmQ="
22 }
23 }
24 ]
25}响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: text/plain; charset=utf-8
3Date: Mon, 08 Aug 2022 06:48:43 GMT
4X-Bce-Gateway-Region: BJ
5X-Bce-Request-Id: a89e0780-2b4c-44d2-84e8-ce55883a5cb7修改触发器策略
接口描述
修改触发器策略。
请求结构
Plain Text
1PUT /v1/instances/{instanceId}/triggers/policies/{policyId} HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string
4
5{
6 "description": {description},
7 "eventTypes": {eventTypes},
8 "filters": {filters},
9 "name": {name},
10 "targets": {targets}
11}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | CCR实例ID |
| policyId | String | 是 | Path参数 | 触发器策略ID |
| description | String | 否 | Body参数 | 触发器策略备注 |
| eventTypes | List<String> | 是 | Body参数 | 触发事件列表，有效值为： UPLOAD_CHART（Helm Chart推送）、 DOWNLOAD_CHART（Helm Chart拉取）、 DELETE_CHART（Helm Chart删除）、 PUSH_ARTIFACT（制品推送）、 PULL_ARTIFACT（制品拉取）、 DELETE_ARTIFACT（制品删除） |
| filters | List<TriggerFilter> | 否 | Body参数 | 触发规则 |
| name | String | 是 | Body参数 | 触发器名称 |
| targets | List<TriggerTarget> | 否 | Body参数 | 访问配置 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
如果请求成功无响应参数。如果请求失败则返回标准错误结构。
请求示例
Plain Text
1PUT /v1/instances/ccr-test/triggers/policies/3 HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2022-08-01T13:07:36Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6
4
5{
6 "description": "触发器测试-修改",
7 "eventTypes": [
8 "PUSH_ARTIFACT",
9 "DELETE_CHART"
10 ],
11 "filters": [
12 {
13 "type": "project_name",
14 "value": "ns-test"
15 }
16 ],
17 "name": "trigger-test",
18 "targets": [
19 {
20 "address": "http://baidu.com",
21 "headers": {
22 "Authorization": "Basic dXNlcm5hbWU6cGFzc3dvcmQ="
23 }
24 }
25 ]
26}响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: text/plain; charset=utf-8
3Date: Mon, 08 Aug 2022 06:48:43 GMT
4X-Bce-Gateway-Region: BJ
5X-Bce-Request-Id: a89e0780-2b4c-44d2-84e8-ce55883a5cb7批量删除触发器策略
接口描述
批量删除触发器策略。
请求结构
Plain Text
1DELETE /v1/instances/{instanceId}/triggers/policies HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string
4
5{
6 "items": {items}
7}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | CCR实例ID |
| items | List<Integer> | 是 | Body参数 | 触发器策略ID数组 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
如果请求成功无响应参数。如果请求失败则返回标准错误结构。
请求示例
Plain Text
1DELETE /v1/instances/ccr-test/triggers/policies HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2022-08-01T08:26:41Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6
4
5{
6 "items": [
7 1,
8 2
9 ]
10}响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Date: Mon, 08 Aug 2022 07:28:25 GMT
4X-Bce-Gateway-Region: BJ
5X-Bce-Request-Id: 8f21c375-ce7e-4ed7-b9a9-9499e9e1262d删除触发器策略
接口描述
删除触发器策略。
请求结构
Plain Text
1DELETE /v1/instances/{instanceId}/triggers/policies/{policyId} HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | CCR实例ID |
| policyId | String | 是 | Path参数 | 触发器策略ID |
响应头域
除公共头域外，无其它特殊头域。
响应参数
如果请求成功无响应参数。如果请求失败则返回标准错误结构。
请求示例
Plain Text
1DELETE /v1/instances/ccr-test/triggers/policies/1 HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2022-08-01T08:26:41Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Date: Mon, 08 Aug 2022 07:37:59 GMT
4X-Bce-Gateway-Region: BJ
5X-Bce-Request-Id: d422ac7a-298a-42c5-ab51-00d6beb78396测试触发器策略目标地址
接口描述
测试触发器策略目标地址的访问情况。
请求结构
Plain Text
1POST /v1/instances/{instanceId}/triggers/policies/targets HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string
4
5{
6 "address": {address},
7 "headers": {headers}
8}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | CCR实例ID |
| address | String | 是 | Body参数 | 目标URL |
| headers | Object | 否 | Body参数 | header key仅支持“Authorization” |
响应头域
除公共头域外，无其它特殊头域。
响应参数
如果请求成功无响应参数。如果请求失败则返回标准错误结构。
请求示例
Plain Text
1POST /v1/instances/ccr-test/triggers/policies/targets HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2022-08-01T13:07:36Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6
4
5{
6 "address": "http://baidu.com",
7 "headers": {
8 "Authorization": "Basic dXNlcm5hbWU6cGFzc3dvcmQ="
9 }
10}响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: text/plain; charset=utf-8
3Date: Mon, 08 Aug 2022 06:48:43 GMT
4X-Bce-Gateway-Region: BJ
5X-Bce-Request-Id: a89e0780-2b4c-44d2-84e8-ce55883a5cb7启动或关闭触发器策略
接口描述
启动或关闭触发器策略。
请求结构
Plain Text
1PUT /v1/instances/{instanceId}/triggers/policies/{policyId}/enable?enabled={enabled} HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | CCR实例ID |
| policyId | String | 是 | Path参数 | 触发器策略ID |
| enabled | String | 是 | Query参数 | 是否开启 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
如果请求成功无响应参数。如果请求失败则返回标准错误结构。
请求示例
Plain Text
1PUT /v1/instances/ccr-test/triggers/policies/1/enable?enabled=false HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2022-08-01T13:07:36Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Date: Mon, 08 Aug 2022 08:07:21 GMT
4X-Bce-Gateway-Region: BJ
5X-Bce-Request-Id: 518d789f-013d-4bf1-ade5-4e7fd1f33dd4获取触发器任务列表
接口描述
获取触发器任务列表。
请求结构
Plain Text
1GET /v1/instances/{instanceId}/triggers/policies/{policyId}/jobs?pageNo={pageNo}&pageSize={pageSize} HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | CCR实例ID |
| policyId | String | 是 | Path参数 | 触发器策略ID |
| pageNo | Integer | 否 | Query参数 | 当前页 |
| pageSize | Integer | 否 | Query参数 | 每页记录数 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| total | Integer | 触发器任务总数 |
| pageNo | Integer | 当前页 |
| pageSize | Integer | 每页记录数 |
| jobs | List<TriggerJob> | 触发器任务列表 |
请求示例
Plain Text
1GET /v1/instances/ccr-test/triggers/policies/1/jobs?pageNo=1&pageSize=10 HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2022-08-01T13:07:36Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Date: Mon, 08 Aug 2022 08:32:05 GMT
4X-Bce-Gateway-Region: BJ
5X-Bce-Request-Id: dc60c252-5bc5-4d98-96c4-14473048dc9f
6
7{
8 "total": 2,
9 "pageNo": 1,
10 "pageSize": 10,
11 "jobs": [
12 {
13 "creationTime": "2022-08-12T03:01:12.458882Z",
14 "eventType": "PUSH_ARTIFACT",
15 "id": 4,
16 "notifyType": "trigger",
17 "status": "finished",
18 "operator": "xiaoming",
19 "image": "ns1/pause:3.4",
20 "images": [
21 "ns1/pause:3.4"
22 ],
23 "updateTime": "2022-08-12T03:01:13.005546Z"
24 },
25 {
26 "creationTime": "2022-08-08T09:29:32.032588Z",
27 "eventType": "PULL_ARTIFACT",
28 "id": 1,
29 "notifyType": "trigger",
30 "status": "finished",
31 "image": "ns1/ubuntu:18.04-tools",
32 "images": [
33 "ns1/ubuntu:18.04-tools"
34 ],
35 "updateTime": "2022-08-08T09:29:32.231975Z"
36 }
37 ]
38}重新执行触发器任务
接口描述
重新执行触发器任务。
请求结构
Plain Text
1PUT /v1/instances/{instanceId}/triggers/policies/{policyId}/jobs/{jobId}/retry HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | CCR实例ID |
| policyId | String | 是 | Path参数 | 触发器策略ID |
| jobId | String | 是 | Path参数 | 触发器任务ID |
响应头域
除公共头域外，无其它特殊头域。
响应参数
如果请求成功无响应参数。如果请求失败则返回标准错误结构。
请求示例
Plain Text
1PUT /v1/instances/ccr-test/triggers/policies/1/jobs/2/retry HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2022-08-01T13:07:36Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Date: Mon, 08 Aug 2022 08:32:05 GMT
4X-Bce-Gateway-Region: BJ
5X-Bce-Request-Id: dc60c252-5bc5-4d98-96c4-14473048dc9f