Registering a Custom Image

Function

Constraints

None

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

URI

POST /v1/{project_id}/images

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID and Name.

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
arch	No	String	Processor architecture supported by the image. Options: X86_64: x86 architecture AARCH64: Arm architecture
description	No	String	Provides supplementary information about the image. The value contains a maximum of 512 characters.
origin	No	String	Image source, which defaults to CUSTOMIZE. Options: CUSTOMIZE: user-defined image IMAGE_SAVE: image saved using a development environment instance
resource_category	No	Array of strings	Flavors supported by the image. Options: CPU GPU ASCEND
service_type	No	String	Supported image types. Options: COMMON: common image INFERENCE: image used for inference TRAIN: image used for training DEV: image used for development and debugging UNKNOWN: image whose supported services are not specified
services	No	Array of strings	Services supported by the image. Options: NOTEBOOK: You can access a notebook instance using HTTPS. SSH: You can remotely access the notebook instance from a local IDE through SSH.
swr_path	No	String	SWR image address
visibility	No	String	Image visibility. Options: PRIVATE: private image PUBLIC: All users can perform read-only operations based on the image ID.
workspace_id	No	String	Workspace ID. If no workspaces are available, the default value is 0.

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
arch	String	Processor architecture supported by the image. Options: X86_64: x86 architecture AARCH64: Arm architecture
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. Options: NOTEBOOK: You can access the notebook instance using HTTPS. SSH: You can remotely access the notebook instance from a local IDE through SSH.
id	String	ID of the image used for creating notebook instances. The ID is in Universally Unique Identifier (UUID) format.For details, see Querying Supported Images.
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. Options: CUSTOMIZE: user-defined image IMAGE_SAVE: image saved using a development environment instance
resource_categories	Array of strings	Flavors supported by the image. Options: CPU GPU ASCEND
service_type	String	Supported image types. Options: COMMON: common image INFERENCE: image used for inference TRAIN: image used for training DEV: image used for development and debugging UNKNOWN: image whose supported services are not specified
size	Long	Specifies the image size, in KB.
status	String	Image status. Options: INIT: The image is being initialized. CREATING: The image is being saved. In this case, the notebook instance is unavailable. CREATE_FAILED: Saving the image failed. ERROR: An error occurs. DELETED: The image has been deleted. ACTIVE: The image has been saved, which you can view on the SWR console and use to create notebook instances.
status_message	String	Build information during image saving
support_res_categories	Array of strings	Flavors supported by the image. Options: CPU GPU ASCEND
swr_path	String	SWR image address
tag	String	Image tag
type	String	Image type. Options: BUILD_IN: built-in system image DEDICATED: private image
update_at	Long	Specifies the time (UTC ms) when the image was last updated.
visibility	String	Image visibility. Options: PRIVATE: private image PUBLIC: All users can perform read-only operations based on the image ID.
workspace_id	String	Workspace ID. If no workspaces are available, the default value is 0.

Example Requests

The following is an example of how to register a custom image whose resource type is CPU and architecture is X86_64.

{
  "description" : "",
  "resource_category" : [ "CPU" ],
  "arch" : "X86_64",
  "swr_path" : "swr.xxx.com/op_svc_modelarts_container2/pytorch_1_8:train-pytorch_1.8.0-cuda_10.2-py_3.7"
}

Example Responses

Status code: 200

{
  "arch" : "x86_64",
  "create_at" : 1671708630448,
  "description" : "",
  "dev_services" : [ "NOTEBOOK", "SSH" ],
  "id" : "708ca95d-c601-4dc7-86b9-670adfd5e818",
  "name" : "pytorch_1_8",
  "namespace" : "op_svc_modelarts_container2",
  "origin" : "CUSTOMIZE",
  "resource_categories" : [ "CPU" ],
  "service_type" : "UNKNOWN",
  "size" : 3376133259,
  "status" : "ACTIVE",
  "swr_path" : "swr.xxx.com/op_svc_modelarts_container2/pytorch_1_8:train-pytorch_1.8.0-cuda_10.2-py_3.7",
  "tag" : "train-pytorch_1.8.0-cuda_10.2-py_3.7",
  "type" : "DEDICATED",
  "update_at" : 1671708630448,
  "visibility" : "PRIVATE",
  "workspace_id" : "0"
}