获取镜像老化规则列表
功能介绍
获取镜像老化规则列表
接口约束
无
调用方法
请参见如何调用API。
URI
GET /v2/manage/namespaces/{namespace}/repos/{repository}/retentions
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
namespace |
是 |
String |
组织名称。小写字母开头，后面跟小写字母、数字、小数点、下划线或中划线（其中下划线最多允许连续两个，小数点、下划线、中划线不能直接相连），小写字母或数字结尾，1-64个字符。 |
repository |
是 |
String |
镜像仓库名称 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
Content-Type |
是 |
String |
消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json 缺省值：application/json |
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
[数组元素] |
Array of Retention objects |
查询成功 |
参数 |
参数类型 |
描述 |
|---|---|---|
algorithm |
String |
回收规则匹配策略，or |
id |
Integer |
ID |
rules |
Array of Rule objects |
镜像老化规则 |
scope |
String |
保留字段 |
参数 |
参数类型 |
描述 |
|---|---|---|
template |
String |
回收类型，date_rule、tag_rule |
params |
Object |
template是date_rule时，设置params为{"days": "xxx"} template是tag_rule时，设置params为{"num": "xxx"} |
tag_selectors |
Array of TagSelector objects |
例外镜像 |
请求示例
GET https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/retentions
响应示例
状态码： 200
查询成功
[ {
"algorithm" : "or",
"id" : 222,
"rules" : [ {
"params" : {
"days" : "30"
},
"tag_selectors" : [ {
"kind" : "label",
"pattern" : "v5"
}, {
"kind" : "label",
"pattern" : "1.0.1"
}, {
"kind" : "regexp",
"pattern" : "^123$"
} ],
"template" : "date_rule"
} ],
"scope" : ""
} ]
状态码
状态码 |
描述 |
|---|---|
200 |
查询成功 |
400 |
错误的请求 |
401 |
鉴权失败 |
404 |
组织或镜像仓库不存在 |
500 |
内部错误 |
错误码
请参见错误码。
