更新时间:2026-09-28 GMT+08:00
分享

获取触发器详情 - ShowTrigger

功能介绍

获取触发器详情

接口约束

无

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v2/manage/namespaces/{namespace}/repos/{repository}/triggers/{trigger}

表1 路径参数

参数

是否必选

参数类型

描述

namespace

是

String

参数解释:

组织名称。用于唯一标识一个组织,组织下的所有镜像仓库都属于该组织。

约束限制:

不涉及。

取值范围:

小写字母开头,后面跟小写字母、数字、小数点、下划线或中划线(其中下划线最多允许连续两个,不同类型分隔符不能直接相连),小写字母或数字结尾,长度1~64个字符。

默认取值:

不涉及。

repository

是

String

参数解释:

镜像仓库名称过滤关键字,用于模糊匹配镜像仓库列表。与精确匹配的name参数不同,filter支持模糊查询。

约束限制:

不涉及。

取值范围:

小写字母或数字开头,后面跟小写字母、数字、小数点、斜杠、下划线或中划线(其中下划线最多允许连续两个,不同类型分隔符不能直接相连),小写字母或数字结尾,长度1~128个字符。

默认取值:

不涉及。

trigger

是

String

参数解释:

触发器名称。用于唯一标识一个触发器。

约束限制:

不涉及。

取值范围:

由字母开头,后面跟字母、数字、中划线或下划线,长度1~64个字符。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

参数解释:

消息体的类型(格式),用于指定请求体的MIME类型。

约束限制:

不涉及。

取值范围:

  • application/json;charset=utf-8:使用UTF-8字符集的JSON格式

  • application/json:标准JSON格式

默认取值:

不涉及。

X-Auth-Token

是

String

参数解释:

用户Token。用于调用API时的鉴权。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

action

String

参数解释:

触发动作。

取值范围:

  • update:更新操作

app_type

String

参数解释:

应用类型。

取值范围:

  • deployments:Deployment应用

  • statefulsets:StatefulSet应用

application

String

参数解释:

应用名。

取值范围:

长度1~255个字符,以字母或数字开头,后面可跟字母、数字、小数点、中划线或下划线。

cluster_id

String

参数解释:

集群ID(cci时为空)。

取值范围:

由字母、数字组成,长度1~65个字符。

cluster_name

String

参数解释:

集群名(cci时为空)。

取值范围:

以小写字母开头,后面跟小写字母、数字或中划线,以小写字母或数字结尾,长度3~128个字符,符合正则^[a-z][a-z0-9-]{2,126}[a-z0-9]$。

cluster_ns

String

参数解释:

应用名所在的namespace。

取值范围:

小写字母开头,后面跟小写字母、数字、小数点、下划线或中划线(其中下划线最多允许连续两个,不同类型分隔符不能直接相连),小写字母或数字结尾,长度1~255个字符。

condition

String

参数解释:

触发条件。根据trigger_type的值不同,condition的取值不同。

取值范围:

  • trigger_type为all时:固定为 .*,长度不超过255个字符

  • trigger_type为tag时:触发器对应的tag名称,长度不超过255个字符

  • trigger_type为regular时:有效的正则表达式,长度不超过255个字符

container

String

参数解释:

需更新的container名,默认为所有container。

取值范围:

由小写字母、数字、小数点、下划线、中划线、斜杠组成,长度1~255个字符。

created_at

String

参数解释:

创建时间,UTC时间格式,如2025-11-19T07:50:06.718359Z。

取值范围:

不涉及。

creator_name

String

参数解释:

创建人。

取值范围:

由中文字符、英文字母、数字及部分特殊字符组成,长度1~256个字符。

enable

String

参数解释:

是否生效。

取值范围:

  • true:生效

  • false:不生效

name

String

参数解释:

触发器名称。

取值范围:

长度1~64个字符,以字母开头,后面可跟字母、数字、中划线或下划线,符合正则^[a-zA-Z]+((-|_)?[a-zA-Z0-9]+)*$。

trigger_history

Array of TriggerHistories objects

参数解释:

触发器历史。

取值范围:

不涉及。

trigger_mode

String

参数解释:

触发器模式。

取值范围:

  • cce:CCE集群触发

  • cci:CCI实例触发

  • cce-autopilot:CCE Autopilot集群触发

trigger_type

String

参数解释:

触发类型。

取值范围:

  • all:所有版本触发

  • tag:指定tag触发

  • regular:正则匹配触发

表4 TriggerHistories

参数

参数类型

描述

action

String

参数解释:

触发动作。

取值范围:

  • update:更新操作

app_type

String

参数解释:

应用类型。

取值范围:

  • deployments:Deployment应用

  • statefulsets:StatefulSet应用

application

String

参数解释:

应用名。

取值范围:

长度1~255个字符,以字母或数字开头,后面可跟字母、数字、小数点、中划线或下划线。

cluster_id

String

参数解释:

集群ID(cci时为空)。

取值范围:

由字母、数字组成,长度1~65个字符。

cluster_name

String

参数解释:

集群名(cci时为空)。

取值范围:

以小写字母开头,后面跟小写字母、数字或中划线,以小写字母或数字结尾,长度3~128个字符,符合正则^[a-z][a-z0-9-]{2,126}[a-z0-9]$。

cluster_ns

String

参数解释:

应用名所在的namespace。

取值范围:

小写字母开头,后面跟小写字母、数字、小数点、下划线或中划线(其中下划线最多允许连续两个,不同类型分隔符不能直接相连),小写字母或数字结尾,长度1~255个字符。

condition

String

参数解释:

触发条件。根据trigger_type的值不同,condition的取值不同。

取值范围:

  • trigger_type为all时:固定为 .*,长度不超过255个字符

  • trigger_type为tag时:触发器对应的tag名称,长度不超过255个字符

  • trigger_type为regular时:有效的正则表达式,长度不超过255个字符

container

String

参数解释:

需更新的container名,默认为所有container。

取值范围:

由小写字母、数字、小数点、下划线、中划线、斜杠组成,长度1~255个字符。

created_at

String

参数解释:

创建时间,UTC时间格式,如2025-11-19T07:50:06.718359Z。

取值范围:

不涉及。

creator_name

String

参数解释:

创建人。

取值范围:

由中文字符、英文字母、数字及部分特殊字符组成,长度1~256个字符。

detail

String

参数解释:

详情。

取值范围:

不涉及。

result

String

参数解释:

更新结果。

取值范围:

  • success:更新成功

  • failed:更新失败

tag

String

参数解释:

触发的版本号。

取值范围:

以字母或数字开头,后面跟字母、数字、小数点、下划线或中划线,长度1~128个字符。

请求示例

GET https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/triggers/{trigger}

响应示例

状态码:200

{
  "action" : "update",
  "app_type" : "deployments",
  "application" : "cci-deployment-20204161",
  "cluster_id" : "",
  "cluster_name" : "",
  "cluster_ns" : "cci-namespace-21539491",
  "condition" : ".*",
  "container" : "",
  "created_at" : "2020-04-16T01:35:08.639589Z",
  "creator_name" : "paas_swr_z00232859",
  "enable" : "true",
  "name" : "test",
  "trigger_history" : [ {
    "action" : "update",
    "app_type" : "deployments",
    "application" : "cci-deployment-20204161",
    "cluster_id" : "",
    "cluster_name" : "",
    "cluster_ns" : "",
    "condition" : ".*",
    "container" : "",
    "created_at" : "2020-04-16T01:36:36.155119Z",
    "creator_name" : "************",
    "detail" : "xxxxxxxxxxxxxx",
    "result" : "failed",
    "tag" : "test"
  } ],
  "trigger_mode" : "cci",
  "trigger_type" : "all"
}

状态码

状态码

描述

200

查询成功

400

错误的请求

401

鉴权失败

404

组织或镜像仓库或触发器不存在

500

内部错误

错误码

请参见错误码。

相关文档