接口功能介绍
查询镜像版本保留规则详情
接口约束
仅限企业版实例使用
URI
GET /v1/getRetentionPolicy
路径参数
无
Query参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
instanceId | 是 | Long | 实例ID | 1638470585571688449 | |
namespaceName | 是 | String | 命名空间名称 | myns |
请求参数
请求头header参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
Content-Type | 是 | String | 类型 | application/json | |
regionId | 是 | String | 资源池编码 | bb9fdb42056f11eda1610242ac110002 |
请求体body参数
无
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 响应码 | 0 | |
message | String | 返回信息 | ||
returnObj | Object | 返回结果 | returnObj | |
error | String | 错误信息 |
表 returnObj
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
instanceId | Long | 实例ID | 1638470585571688449 | |
namespaceId | Long | 命名空间ID | 1671144531534725122 | |
namespaceName | String | 命名空间名称 | myns | |
cronExpression | String | 定时表达式 | * 0 * * * | |
rules | Object | 规则列表 | rules |
表 rules
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
scopePattern | String | 仓库的匹配模式 | repo | |
tagPattern | String | 版本的匹配模式 | v1 | |
params | Object | 保留策略 | params | |
disabled | Boolean | 是否禁用 | false |
表 params
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
latestPulledN | Integer | 版本保留策略(latestPulledN:保留最近拉取N个;latestPushedK:保留最近推送N个;nDaysSinceLastPull:保留最近D天拉取;nDaysSinceLastPush:保留最近D天推送) | 8 |
枚举参数
无
请求示例
请求url
GET https://[endpoint].ctapi.ctyun.cn/v1/listImmutableTagRule?instanceId=1681506751863718000&namespaceName=myns&pageNum=1&pageSize=10
请求头header
{
"Content-Type": "application/json"
}
请求体body
无
响应示例
{
"message": "",
"returnObj": {
"cronExpression": "",
"instanceId": 1681506751863718000,
"namespaceId": 1696096163711742000,
"namespaceName": "myns",
"rules": [
{
"disabled": false,
"params":{
"latestPulledN":8
},
"scopePattern": "crs-test7",
"tagPattern": "**"
}
]
},
"statusCode": 0
}
状态码
请参考 状态码
错误码
请参考 错误码