# 获取镜像仓库下的触发器列表 - ListTriggersDetails #### 功能介绍 获取镜像仓库下的触发器列表 #### 接口约束 无 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-swr/swr_02_0002.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-swr/swr_02_0131.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI GET /v2/manage/namespaces/{namespace}/repos/{repository}/triggers 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | namespace | 是 | String | **参数解释**： 组织名称。用于唯一标识一个组织，组织下的所有镜像仓库都属于该组织。 **约束限制**： 不涉及。 **取值范围**： 小写字母开头，后面跟小写字母、数字、小数点、下划线或中划线（其中下划线最多允许连续两个，不同类型分隔符不能直接相连），小写字母或数字结尾，长度1\~64个字符。 **默认取值**： 不涉及。 | | repository | 是 | String | **参数解释**： 镜像仓库名称过滤关键字，用于模糊匹配镜像仓库列表。与精确匹配的name参数不同，filter支持模糊查询。 **约束限制**： 不涉及。 **取值范围**： 小写字母或数字开头，后面跟小写字母、数字、小数点、斜杠、下划线或中划线（其中下划线最多允许连续两个，不同类型分隔符不能直接相连），小写字母或数字结尾，长度1\~128个字符。 **默认取值**： 不涉及。 | #### 请求参数 表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参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | \[数组元素\] | Array of [Trigger] objects | **参数解释**： 触发器列表，列表元素为Trigger对象，每条记录包含触发动作、应用类型、应用名、集群信息、触发条件、触发类型、触发器历史等字段，参见Trigger数据类型。 **取值范围**： 不涉及。 | 表4Trigger | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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：正则匹配触发 | 表5TriggerHistories | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 ``` #### 响应示例 **状态码：200** ``` [ { "action" : "update", "app_type" : "deployments", "application" : "abcde", "cluster_id" : "******************", "cluster_name" : "test123", "cluster_ns" : "default", "condition" : ".*", "container" : "", "created_at" : "2020-04-16T02:04:55.922236Z", "creator_name" : "************", "enable" : "true", "name" : "test1", "trigger_history" : null, "trigger_mode" : "cce", "trigger_type" : "all" } ] ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查询成功 | | 400 | 错误的请求 | | 401 | 鉴权失败 | | 404 | 组织或镜像仓库不存在 | | 500 | 内部错误 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-swr/ErrorCode.html)。