获取镜像老化规则记录

功能介绍

获取镜像老化规则记录。

URI

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

参数说明请参见表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/1093

响应消息

• 响应参数

  状态码： 200

  表3 Response Body参数说明

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

  表4 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	例外镜像

  表5 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": ""
  }

状态码

错误码

请参见错误码。