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

Deleting the Image with a Specified Tag

Function

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

URI

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

For details about parameters, see Table 1.

Table 1 Parameter description

Parameter

Mandatory

Type

Description

namespace

Yes

String

Organization name

repository

Yes

String

Image repository name

tag

Yes

String

Image tag name

Request

  • 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 or 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 an IAM API. The value of X-Subject-Token in the response header is the user token.

  • Example request
    DELETE https://{Endpoint}/v2/manage/namespaces/group/repos/busybox/tags/v1

Response

N/A

Status Code

Status Code

Description

204

The image with a specified tag is deleted successfully.

400

Request error. Error information is returned.

401

Authentication failed.

404

The repository or the image with a specified tag does not exist.

500

Internal error. Error information is returned.

Error Codes

For details, see Error Codes.