doc-exports/docs/swr/api-ref/swr_02_0036.html
Dong, Qiu Jian f5c28c856a SWR API update 20241012
Reviewed-by: Eotvos, Oliver <oliver.eotvos@t-systems.com>
Co-authored-by: Dong, Qiu Jian <qiujiandong1@huawei.com>
Co-committed-by: Dong, Qiu Jian <qiujiandong1@huawei.com>
2024-10-18 07:19:46 +00:00

9.6 KiB

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.