Deleting Lite Server Jobs in Batches

Function

This API is used to remove multiple Lite Server jobs. It is used when multiple Lite Server jobs are completed, incorrectly configured, or resources need to be cleared. Before using this API, ensure that the target Lite Server job exists and you have the administrator permissions. After the deletion, the specified Lite Server job is permanently removed, and related resources and configurations are cleared. If the target Lite Server job does not exist, you do not have the required permission, or the request parameters are incorrect, the API returns an error message.

Debugging

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

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, no identity policy-based permission required for calling this API.

URI

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

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition: Project ID. For details, see Obtaining a Project ID and Name. Constraints: The value can contain 1 to 64 characters. Letters, digits, and hyphens (-) are allowed. Range: N/A Default Value: N/A

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
job_ids	No	Array of strings	ID list of DevServer tasks to be deleted.

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
current	Integer	Definition: Current page number. Range: N/A
data	Array of DevServerJobListResponse objects	Definition: Job instance list.
pages	Integer	Definition: Total number of pages. Range: N/A
size	Integer	Definition: Number of records on each page. Range: N/A
total	Long	Definition: Total number of records. Range: N/A

**Table 4** DevServerJobListResponse
Parameter	Type	Description
id	String	Task ID.
name	String	Task name.
user_name	String	Username.
description	String	Task description.
type	String	Definition: Task type. Range: COMMON, SERVICE_DEPLOY, and others.
status	String	Definition: Task status. Range: PROCESSING, FINISHED, and DELETED.
abnormal_count	Integer	Number of nodes where the task fails.
create_at	String	Creation time.
update_at	String	Update time.

Example Requests

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

{
  "job_ids" : [ "03af7361-5cba-44d4-b29b-4dcc5d9dff51", "62c89f77-fc81-45a8-9647-d6e457e73954" ]
}

Example Responses

Status code: 200

{
  "current" : 1,
  "data" : [ {
    "create_at" : 1749536420547,
    "update_at" : 1749536603947,
    "id" : "03af7361-5cba-44d4-b29b-4dcc5d9dff51",
    "name" : "software-upgrade-792a",
    "user_name" : "modelarts_user",
    "type" : "ASCEND_SOFTWARE_UPGRADE",
    "status" : "FINISHED",
    "abnormal_count" : 0
  }, {
    "create_at" : 1749523685137,
    "update_at" : 1749523899848,
    "id" : "62c89f77-fc81-45a8-9647-d6e457e73954",
    "name" : "diagnosis-81ef",
    "user_name" : "modelarts_user",
    "description" : "POC",
    "type" : "ASCEND_DIAGNOSIS",
    "status" : "FINISHED",
    "abnormal_count" : 0
  } ],
  "pages" : 1,
  "size" : 2,
  "total" : 2
}