Description
Delete an image with a specified tag.
Constraints
None
API Calling
For details, see Calling APIs.
URI
DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/tags/{tag}
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. Enter 1 to 128 characters. It must start and end with a lowercase letter or digit. Only lowercase letters, digits, periods (.), slashes (/), underscores (_), and hyphens (-) are allowed. Periods, slashes, underscores, and hyphens cannot be placed next to each other. A maximum of two consecutive underscores are allowed. Replace a slash (/) with a dollar sign ($) before you send the request. |
tag | Yes | String | Image tag name. |
Request 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. Default value: application/json |
X-Auth-Token | Yes | String | User token. The token can be obtained through 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
None
Example Request
DELETE https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/tags/{tag}
Example Response
None
Status Codes
Status Code | Description |
|---|---|
204 | Image with a specified tag deleted. |
400 | Request error. |
401 | Authentication failed. |
404 | The image repository or the image of the specified tag was not found. |
500 | Internal error. |
Error Codes
For details, see Error Codes.
- Description
- Constraints
- API Calling
- URI
- Request Parameters
- Response Parameters
- Example Request
- Example Response
- Status Codes
- Error Codes