获取镜像老化规则列表

功能介绍

获取镜像老化规则列表。

URI

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

参数说明请参见表1。

请求消息

• 请求参数

  表2 请求Header参数

  参数	是否必选	参数类型	描述
  Content-Type	是	String	消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json 缺省值：application/json
  X-Auth-Token	是	String	用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

• 请求样例

  GET https://{Endpoint}/v2/manage/namespaces/group/repos/busybox/retentions

响应消息

• 响应参数
  状态码： 200

  表3 Response Body参数说明

  参数	参数类型	描述
  [数组元素]	Array of objects	镜像老化规则列表

  表4 [数组元素]参数说明

  参数	参数类型	描述
  algorithm	String	回收规则匹配策略，固定为"or"。
  id	Integer	规则ID
  rules	Array of objects	镜像老化规则
  scope	String	保留字段

  表5 rules参数说明

  参数	参数类型	描述
  template	String	老化规则类型，date_rule（存活时间）、tag_rule（版本数目）
  params	Object	template是date_rule时，params为{"days": "xxx"} template是tag_rule时，params为{"num": "xxx"}
  tag_selectors	Array of objects	例外镜像

  表6 tag_selectors参数说明

  参数	参数类型	描述
  kind	String	匹配规则，label、regexp
  pattern	String	kind是label时，该值为镜像版本 kind是regexp时，该值为正则表达式

• 响应样例
  状态码： 200

  [
      {
          "algorithm": "or",
          "id": 1093,
          "rules": [
              {
                  "template": "date_rule",
                  "params": {
                      "days": "30"
                  },
                  "tag_selectors": [
                      {
                          "kind": "label",
                          "pattern": "v5"
                      },
                      {
                          "kind": "label",
                          "pattern": "1.0.1"
                      },
                      {
                          "kind": "regexp",
                          "pattern": "^123$"
                      }
                  ]
              }
          ],
          "scope": ""
      }
  ]

状态码

错误码

请参见错误码。