更新镜像版本保留规则
更新时间 2026-03-20 10:17:37
最近更新时间: 2026-03-20 10:17:37
接口功能介绍
更新镜像版本保留规则
接口约束
仅限企业版实例使用
URI
POST /v2/updateRetentionPolicy
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| Content-Type | 是 | String | 类型 | application/json | |
| regionId | 是 | String | 资源池编码（资源池ID，您可以查看容器镜像服务资源池获取） | bb9fdb42056f11eda1610242ac110002 |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| instanceId | 是 | String | 实例ID | f04e47d9b48747958c9f4516cf1a8d82 | |
| namespaceName | 是 | String | 命名空间名称 | myns | |
| cronExpression | 是 | String | cron定时表达式，若传空字符串表示不设置（由6个字段组成，分别表示秒、分、小时、日期、月份和星期几。每个字段都可以设置一个数字、一组数字（用逗号分隔）、一段数字范围（用短横线分隔）、通配符（表示任意值）或者特定的字符（如星期几的英文缩写）） | 0 0 * * * * | |
| rules | 是 | Object | 规则列表 | rules |
表 rules
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| scopePattern | 是 | String | 仓库的匹配模式（key： 精确匹配名称为key的仓库；key*: 匹配前缀为key的仓库；**：表示匹配所有仓库；如果有多个，使用逗号分隔并用大括号包裹，如 {key1,key2,key3*}） | repo | |
| scopeOperator | 是 | String | 仓库筛选器模式（匹配模式：matches；排除模式：excludes） | matches | |
| tagPattern | 是 | String | 版本的匹配模式（key： 精确匹配名称为key的仓库；key*: 匹配前缀为key的仓库；**：表示匹配所有仓库；如果有多个，使用逗号分隔并用大括号包裹，如 {key1,key2,key3*}） | v1 | |
| tagOperator | 是 | String | Tag筛选器模式（匹配模式：matches；排除模式：excludes） | matches | |
| params | 是 | Object | 保留策略 | params | |
| disabled | 否 | Boolean | 是否禁用保留策略（默认为false） | false |
表 params
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| latestPulledN | 是 | Integer | 版本保留策略（latestPulledN：保留最近拉取N个；latestPushedK：保留最近推送N个；nDaysSinceLastPull：保留最近D天拉取；nDaysSinceLastPush：保留最近D天推送） | 8 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 响应码 （800为请求成功，900为失败 ） | 800 | |
| message | String | 返回信息 | ||
| error | String | 错误码 | ||
| returnObj | Boolean | 是否修改成功 | true |
枚举参数
无
请求示例
请求url
POST https://crs-global.ctapi.ctyun.cn/v2/updateRetentionPolicy
请求头header
{
"Content-Type": "application/json",
"regionId": "bb9fdb42056f11eda1610242ac110002"
}
请求体body
{
"instanceId": "f04e47d9b48747958c9f4516cf1a8d82",
"namespaceName": "myns",
"rules": [
{
"disabled": false,
"params":{
"latestPulledN":8
},
"scopePattern": "a3",
"tagPattern": "v2"
}
],
"cronExpression": "0 0 * * * *"
}
响应示例
{
"statusCode": 800,
"message": "",
"returnObj": true
}
状态码
请参考 状态码
错误码
请参考 错误码
