Help Center/ ModelArts/ API Reference/ DevServer Management/ Deleting DevServer Instances
Updated on 2024-05-30 GMT+08:00

Deleting DevServer Instances

Function

This API is used to delete DevServer instances.

Constraints

No constraints

Debugging

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

URI

DELETE /v1/{project_id}/dev-servers/{id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

id

Yes

String

DevServer ID

project_id

Yes

String

Project ID. For details, see Obtaining a Project ID and Name.

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

create_at

Long

Creation time

update_at

Long

Update time

charging_mode

String

Billing mode.

  • COMMON: Both yearly/monthly and pay-per-use are supported.

  • POST_PAID: pay-per-use

  • PRE_PAID: yearly/monthly

cloud_server

CloudServer object

Cloud service information

endpoints_response

Array of Endpoints objects

Private IP address of the instance

flavor

String

Instance flavor name

id

String

Instance ID

key_pair_name

String

Key pair name

name

String

Instance name

order_id

String

Order ID

server_image_response

ServerImageResponse object

Instance image

status

String

Instance status.

  • CREATE_FAILED: Creating the instance failed.

  • CREATING: The instance is being created.

  • DELETED: The instance has been deleted.

  • DELETE_FAILED: Deleting the instance failed.

  • DELETING: The instance is being deleted.

  • ERROR: An error occurred.

  • RUNNING: The instance is running.

  • STARTING: The instance is starting.

  • START_FAILED: Starting the instance failed.

  • STOPPED: The instance has been stopped.

  • STOPPING: The instance is being stopped.

  • STOP_FAILED: Stopping the instance failed.

vpc_id

String

ID of the VPC to which the instance belongs

endpoints

Array of EndpointsRes objects

Private IP address of the server

image

ServerImageResponse object

Server image information

Table 3 CloudServer

Parameter

Type

Description

id

String

Server resource ID

type

String

DevServer type. Enums:

  • BMS

  • ECS

Table 4 Endpoints

Parameter

Type

Description

allowed_access_ips

Array of strings

Whitelisted public IP addresses that are allowed to access notebook instances through SSH. By default, all public IP addresses can access the notebook instances. If this parameter is specified, only the clients at the specified IP addresses can access the notebook instances.

dev_service

String

Supported service. Enums:

  • NOTEBOOK: You can access notebook instances using HTTPS.

  • SSH: You can remotely access notebook instances through SSH.

  • AI_FLOW

  • MA_STUDIO

  • TENSOR_BOARD

  • WEB_IDE

extensions

Map<String,String>

App-specific URL for accessing the remote development mode of the App.

ssh_keys

Array of strings

List of SSH key pairs. You can set multiple key pairs to access an SSH instance at the same time.

Table 5 EndpointsRes

Parameter

Type

Description

allowed_access_ips

Array of strings

Whitelist of public IP addresses that are allowed to access the notebook instance through SSH. By default, all public IP addresses can access the notebook instance. If this parameter is specified, only the clients with the specified IP addresses can access the notebook instance.

dev_service

String

Supported service. Options:

  • NOTEBOOK: You can access notebook instances using HTTPS.

  • SSH: You can remotely access the notebook instance through SSH.

ssh_keys

Array of strings

List of SSH key pairs. You can set multiple key pairs to access an SSH instance at the same time.

service

String

Supported service. The options are:

  • NOTEBOOK: You can access notebook instances using HTTPS.

  • SSH: You can remotely access notebook instances through SSH.

uri

String

Private IP address of the instance

Table 6 ServerImageResponse

Parameter

Type

Description

arch

String

Architecture of the server image. The options are as follows:

  • ARM

  • X86

image_id

String

Server image ID

name

String

Server image name

server_type

String

Server type. Enums:

  • BMS

  • ECS

Example Requests

DELETE https://{endpoint}/v1/{project_id}/dev-servers/{id}

Example Responses

Status code: 200

OK

{
  "charging_mode" : "POST_PAID",
  "cloud_server" : {
    "type" : "ECS"
  },
  "create_at" : 1699348284990,
  "flavor" : "Si2.large.4",
  "id" : "62383738-e52a-450a-9f84-f9e705402be8",
  "image" : {
    "arch" : "X86",
    "image_id" : "c90fb553-2cdb-4b81-b56a-ef68812c6cf7",
    "name" : "Ubuntu18.04_x86_64_CPU",
    "server_type" : "ECS"
  },
  "name" : "EI-evs-1107",
  "status" : "DELETING",
  "update_at" : 1699348285077
}

Status Codes

Status Code

Description

200

OK

Error Codes

See Error Codes.