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

Deleting the Image with a Specified Tag

Description

Delete the image with a specified tag in an image repository.

Constraints

None

API Calling

For details, see Calling APIs.

URI

DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/tags/{tag}

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.

tag

Yes

String

Image tag name.

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}/tags/{tag}

Example Response

N/A

Status Codes

Status Code

Description

204

The image with a specified tag is deleted successfully.

400

Request error.

401

Authentication failed.

404

The image repository or the image of the specified tag does not exist.

500

Internal error.

Error Codes

For details, see Error Codes.