文档首页/ 容器镜像服务 SWR/ API参考（基础版）/ API/ 镜像老化规则管理/ 获取镜像老化记录
更新时间：2025-06-16 GMT+08:00
在线调试
CLI示例
查看PDF
分享

获取镜像老化记录

功能介绍

获取镜像老化记录

接口约束

无

调用方法

请参见如何调用API。

URI

GET /v2/manage/namespaces/{namespace}/repos/{repository}/retentions/histories

表1 路径参数

参数

是否必选

参数类型

描述

namespace

是

String

组织名称。小写字母开头，后面跟小写字母、数字、小数点、下划线或中划线（其中下划线最多允许连续两个，小数点、下划线、中划线不能直接相连），小写字母或数字结尾，1-64个字符。

repository

是

String

镜像仓库名称。小写字母或数字开头，后面跟小写字母、数字、小数点、斜杠、下划线或中划线（其中下划线最多允许连续两个，小数点、斜杠、下划线、中划线不能直接相连），小写字母或数字结尾，1-128个字符。如果您的镜像名称repository参数中有斜杠，请先替换成$再进行请求。
表2 Query参数

参数

是否必选

参数类型

描述

limit

否

String

返回条数。注意：offset和limit参数需要配套使用。

offset

否

String

起始索引。取值范围：必须为数字且大于等于0。

注意：offset和limit参数需要配套使用。

filter

否

String

应填写 limit::{limit}|offset::{offset}, 其中{limit}为返回条数,{offset}为起始索引, 注意：offset和limit参数需要配套使用

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json

缺省值：application/json

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

响应参数

状态码： 200

表4 响应Header参数

参数

参数类型

描述

Content-Range

String

offset(开始索引)-count(当前页记录条数)/total(总记录条数)
表5 响应Body参数

参数

参数类型

描述

retention_log

Array of RetentionLog objects

镜像老化日志

total

Integer

总个数
表6 RetentionLog

参数

参数类型

描述

created_at

String

创建时间

id

Integer

ID

namespace

String

组织名

repo

String

镜像仓库名

retention_id

Integer

老化规则ID

rule_type

String

规则

tag

String

镜像版本

请求示例

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

内部错误

错误码

请参见错误码。

父主题： 镜像老化规则管理

相关文档