获取镜像老化记录
功能介绍
获取镜像老化记录
接口约束
无
调用方法
请参见如何调用API。
URI
GET /v2/manage/namespaces/{namespace}/repos/{repository}/retentions/histories
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
namespace |
是 |
String |
组织名称。小写字母开头，后面跟小写字母、数字、小数点、下划线或中划线（其中下划线最多允许连续两个，小数点、下划线、中划线不能直接相连），小写字母或数字结尾，1-64个字符。 |
|
repository |
是 |
String |
镜像仓库名称。小写字母或数字开头，后面跟小写字母、数字、小数点、斜杠、下划线或中划线（其中下划线最多允许连续两个，小数点、斜杠、下划线、中划线不能直接相连），小写字母或数字结尾，1-128个字符。如果您的镜像名称repository参数中有斜杠，请先替换成$再进行请求。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
limit |
否 |
String |
返回条数。注意：offset和limit参数需要配套使用。 |
|
offset |
否 |
String |
起始索引。取值范围：必须为数字且大于等于0。 注意：offset和limit参数需要配套使用。 |
|
filter |
否 |
String |
应填写 limit::{limit}|offset::{offset}, 其中{limit}为返回条数,{offset}为起始索引, 注意：offset和limit参数需要配套使用 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Content-Type |
是 |
String |
消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json 缺省值：application/json |
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
Content-Range |
String |
offset(开始索引)-count(当前页记录条数)/total(总记录条数) |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
retention_log |
Array of RetentionLog objects |
镜像老化日志 |
|
total |
Integer |
总个数 |
请求示例
GET https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/retentions/histories
响应示例
状态码： 200
请求成功
{
"retention_log" : [ {
"created_at" : "2020-04-17T08:01:09.658309Z",
"id" : 9088,
"namespace" : "hwstaff_l00283074",
"repo" : "experience_2048",
"retention_id" : 91,
"rule_type" : "{\"template\":\"tag_rule\",\"params\":{\"num\":\"7\"},\"tag_selectors\":[]}",
"tag" : "4"
} ],
"total" : 1
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
请求成功 |
|
400 |
错误的请求 |
|
401 |
鉴权失败 |
|
404 |
组织或镜像仓库不存在 |
|
500 |
内部错误 |
错误码
请参见错误码。
