Deleting an Image¶
Function¶
Delete an image object. For a private image, you can also delete the image content from SWR using parameters.
Constraints¶
None
URI¶
DELETE /v1/{project_id}/images/{id}
Parameter | Mandatory | Type | Description |
---|---|---|---|
id | Yes | String | Image ID |
project_id | Yes | String | Project ID. For details, see Obtaining a Project ID and Name. |
Parameter | Mandatory | Type | Description |
---|---|---|---|
force | No | Boolean | Image content to be deleted from SWR. This parameter is valid only for private images. |
Request Parameters¶
None
Response Parameters¶
Status code: 200
Parameter | Type | Description |
---|---|---|
arch | String | Processor architecture supported by the image. Enums:
|
create_at | Long | Specifies the time (UTC ms) when the image is created. |
description | String | Image description with a maximum of 512 characters |
dev_services | Array of strings | Services supported by the image. Enums:
|
id | String | Specifies the image ID of the notebook instance to be created. The image ID is in the Universally Unique Identifier (UUID) format. For details about how to obtain the ID of a preset image, see ListImage.xml. |
name | String | Image name, which contains a maximum of 512 characters, including lowercase letters, digits, hyphens (-), underscores (_), and periods (.) |
namespace | String | Organization to which the image belongs. You can create and view the organization on the Organization Management page of the SWR console. |
origin | String | Image source, which defaults to CUSTOMIZE. This parameter is optional. Enums:
|
resource_categories | Array of strings | Flavors supported by the image. Enums:
|
service_type | String | Supported image types. Options:
|
size | Long | Specifies the image size, in KB. |
status | String | Image status. Options:
|
status_message | String | Build information during image saving |
support_res_categories | Array of strings | Flavors supported by the image. Enums:
|
swr_path | String | SWR image address |
tag | String | Image tag |
type | String | Image type. Enums:
|
update_at | Long | Specifies the time (UTC ms) when the image was last updated. |
visibility | String | Image visibility. Enums:
|
workspace_id | String | Workspace ID. If no workspaces are available, the default value is 0. |
Example Requests¶
DELETE https://{endpoint}/v1/{project_id}/images/{id}
Example Responses¶
Status code: 200
OK
{
"arch" : "x86_64",
"create_at" : 1671093486722,
"description" : "",
"dev_services" : [ "NOTEBOOK", "SSH" ],
"id" : "c9ab2b2f-edda-4556-bdbb-494e868d043c",
"name" : "mock-service-python",
"namespace" : "mock-service1",
"origin" : "CUSTOMIZE",
"resource_categories" : [ "CPU" ],
"service_type" : "UNKNOWN",
"size" : 387840321,
"status" : "DELETED",
"swr_path" : "swr.xxx.com/mock-service1/mock-service-python:0.0.17",
"tag" : "0.0.17",
"type" : "DEDICATED",
"update_at" : 1671093486722,
"visibility" : "PRIVATE",
"workspace_id" : "0"
}
Status Codes¶
Status Code | Description |
---|---|
200 | OK |
204 | No Content |
401 | Unauthorized |
403 | Forbidden |
Error Codes¶
See Error Codes.