Obtaining Details of an Image¶
Function¶
Obtain the details of an image.
Constraints¶
None
URI¶
GET /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. |
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¶
GET https://{endpoint}/v1/{project_id}/images/{id}
Example Responses¶
Status code: 200
OK
{
"arch" : "x86_64",
"create_at" : 1638234504492,
"description" : "CPU and GPU general algorithm development and training, preconfigured with AI engine PyTorch1.8",
"dev_services" : [ "NOTEBOOK", "SSH" ],
"id" : "278e88d1-5b71-4766-8502-b3ba72e824d9",
"name" : "pytorch1.8-cuda10.2-cudnn7-ubuntu18.04",
"resource_categories" : [ "GPU", "CPU" ],
"service_type" : "COMMON",
"status" : "ACTIVE",
"swr_path" : "swr.xxx.com/atelier/pytorch_1_8:pytorch_1.8.0-cuda_10.2-py_3.7-ubuntu_18.04-x86_64-20220926104358-041ba2e",
"tag" : "pytorch_1.8.0-cuda_10.2-py_3.7-ubuntu_18.04-x86_64-20220926104358-041ba2e",
"type" : "BUILD_IN",
"update_at" : 1638234504492,
"workspace_id" : "0"
}
Status Codes¶
Status Code | Description |
---|---|
200 | OK |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
Error Codes¶
See Error Codes.