创建镜像老化规则
功能介绍
创建镜像老化规则
接口约束
无
调试
您可以在API Explorer中调试该接口。
URI
POST /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的值）。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
algorithm |
是 |
String |
回收规则匹配策略，固定为"or" |
rules |
是 |
Array of Rule objects |
镜像老化规则 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
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 |
例外镜像 |
响应参数
状态码： 201
参数 |
参数类型 |
描述 |
|---|---|---|
id |
Integer |
镜像老化规则id |
请求示例
POST https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/retentions
{
"algorithm" : "string",
"rules" : [ {
"params" : { },
"tag_selectors" : [ {
"kind" : "string",
"patten" : "string"
} ],
"template" : "string"
} ]
}
响应示例
状态码： 201
创建成功
{
"id" : 34
}
状态码
状态码 |
描述 |
|---|---|
201 |
创建成功 |
400 |
错误的请求 |
401 |
鉴权失败 |
404 |
组织或镜像仓库不存在 |
500 |
内部错误 |
错误码
请参见错误码。
