Function
This API is used to delete a specified tag from an image.
Constraints
- To be compatible with remaining tags, the system will not verify the character set and length of the keys and values in the query condition.
- This API is a non-idempotent one. If the key to be deleted does not exist, status code 404 is returned.
URI
DELETE /v2/{project_id}/images/{image_id}/tags/{key}
Table 1 lists the parameters in the URI.
Table 1 Parameter descriptionParameter
|
Mandatory
|
Type
|
Description
|
|---|
project_id
|
Yes
|
String
|
Specifies the project ID.
|
image_id
|
Yes
|
String
|
Specifies the image ID.
|
key
|
Yes
|
String
|
Specifies the key of the tag to be deleted.
|
Request
Request parameters
None
Example Request
Deleting an image tag
DELETE https://{Endpoint}/v2/fd73a4a14a4a4dfb9771a8475e5198ea/images/67e17426-359e-49fb-aa12-0bd1756ec240/tags/key1
Response
- Response parameters
None
- Example response
STATUS CODE 204
Returned Values
- Normal
204
- Abnormal
Returned Value
|
Description
|
|---|
400 Bad Request
|
Request error.
|
401 Unauthorized
|
Authentication failed.
|
403 Forbidden
|
You do not have the rights to perform the operation.
|
404 Not Found
|
The requested resource was not found.
|
500 Internal Server Error
|
Internal service error.
|
503 Service Unavailable
|
The service is unavailable.
|