Obtaining Image Retention Records

Updated on 2023-04-04 GMT+08:00

View PDF

Function

Obtain image retention records.

URI

GET /v2/manage/namespaces/{namespace}/repos/{repository}/retentions/histories?offset={offset}&limit={limit}

Table 1 describes the parameters.

**Table 1** Parameter description
Parameter	Mandatory	Type	Description
namespace	Yes	String	Organization name.
repository	Yes	String	Image repository name.
offset	No	Integer	Offset.
limit	No	Integer	Count.

Request

Request parameters
N/A

Example request

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

Response

Response parameters

**Table 2** Response header parameter description
Parameter	Type	Description
Content-Range	String	Offset (Start index)–Count (Number of records on the current page)/Total (Total number of records)

NOTE:

If the offset and limit parameters are transferred in the request, Content-Range will be added to the response header.

**Table 3** Response body parameter description
Parameter	Type	Description
retention_log	Array of objects	Image retention log.
total	Integer	Total number.

**Table 4** retention_log parameter description
Parameter	Type	Description
created_at	String	Creation time
id	Integer	ID.
namespace	String	Organization name.
repo	String	Image repository name.
retention_id	Integer	Image retention policy ID.
rule_type	String	Policy.
tag	String	Image tag.

Example response

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