创建镜像老化规则

功能介绍

创建镜像老化规则。

URI

POST /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的值）。

  表3 Body参数说明

  参数	是否必选	参数类型	描述
  algorithm	是	String	老化规则匹配策略，固定为"or"。
  rules	是	Array of objects	镜像老化规则

  表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时，设置为正则表达式

• 请求样例

  POST https://{Endpoint}/v2/manage/namespaces/group/repos/busybox/retentions
  
  {
      "algorithm": "or",
      "rules": [
          {
              "template": "date_rule",
              "params": {
                  "days": "30"
              },
              "tag_selectors": [
                  {
                      "kind": "label",
                      "pattern": "v5"
                  },
                  {
                      "kind": "label",
                      "pattern": "1.0.1"
                  },
                  {
                      "kind": "regexp",
                      "pattern": "^123$"
                  }
              ]
          }
      ]
  }

响应消息

• 响应参数

  表6 Response Body参数说明

  参数	参数类型	描述
  id	Integer	规则ID

• 响应样例
  状态码： 201

  {"id": 34}

状态码

错误码

请参见错误码。