Updated on 2024-02-23 GMT+08:00

Deleting an Image Retention Policy

Description

Delete an image retention policy.

Constraints

None

API Calling

For details, see Calling APIs.

URI

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

Table 1 Path parameters

Parameter

Mandatory

Type

Description

namespace

Yes

String

Organization name. Enter 1 to 64 characters, starting with a lowercase letter and ending with a lowercase letter or digit. Only lowercase letters, digits, periods (.), underscores (_), and hyphens (-) are allowed. Periods, underscores, and hyphens cannot be placed next to each other. A maximum of two consecutive underscores are allowed.

repository

Yes

String

Image repository name.

retention_id

Yes

Integer

Image retention policy ID.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Message body type (format). The value can be application/json;charset=utf-8 application/json

The default value is application/json.

X-Auth-Token

Yes

String

User token.

The token can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token.

Response Parameters

N/A

Example Request

DELETE https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/retentions/{retention_id}

Example Response

N/A

Status Codes

Status Code

Description

200

Deletion succeeded.

400

Request error.

401

Authentication failed.

404

The organization, image repository, or policy does not exist.

500

Internal error.

Error Codes

For details, see Error Codes.