Adding an Image Retention Policy

Scenario

This section describes how to add an image retention policy using APIs. For details on how to call APIs, see Calling APIs.

Involved APIs

In this example, the following APIs are used to:

Adding an Image Retention Policy
Deleting an Image Retention Policy

Endpoints

An endpoint is the request address for calling an API. Endpoints vary depending on services and regions. For the endpoints of SWR, see Regions and Endpoints.

Procedure

Add an image retention policy.

URI format
POST /v2/manage/namespaces/{namespace}/repos/{repository}/retentions

For details, see Adding an Image Retention Policy

Example request

POST https://{endpoint}/v2/manage/namespaces/group/repos/test/retentions

Body:

{
    "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$"
                }
            ]
        }
    ]
}

Example response
```
{
    "id": 34
}
```

Delete an image retention policy.
- URI format
  DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/retentions/{retention_id}
  
  For details, see Deleting an Image Retention Policy
- Example request
  DELETE https://{endpoint}/v2/manage/namespaces/group/repos/test/retentions/34
- Example response
```
{}
```