批量删除Lite Server Job - DeleteDevServerJobs

功能介绍

批量删除Lite Server Job接口用于批量移除已创建的Lite Server Job。该接口适用于以下场景：当多个Lite Server Job已完成、配置错误或需要清理资源时，用户可以通过此接口批量删除指定的Lite Server Job。使用该接口的前提条件是目标Lite Server Job已存在且用户具有管理员权限。删除操作完成后，指定的Lite Server Job将被永久移除，相关资源和配置也将被清理。若目标Lite Server Job不存在、用户无权限操作或请求参数不正确，接口将返回相应的错误信息。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，当前API调用无需身份策略权限。

URI

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：用户项目ID。获取方法请参见获取项目ID和名称。约束限制：1 - 64字符，字母、数字和中划线。取值范围：不涉及。默认取值：不涉及。

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
job_ids	否	Array of strings	参数解释：要删除的DevServer的任务id列表

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
current	Integer	参数解释：当前页数。取值范围：不涉及。
data	Array of DevServerJobListResponse objects	参数解释：job实例列表。
pages	Integer	参数解释：总页数。取值范围：不涉及。
size	Integer	参数解释：每一页的数量。取值范围：不涉及。
total	Long	参数解释：总的记录数量。取值范围：不涉及。

表4 DevServerJobListResponse
参数	参数类型	描述
id	String	参数解释：任务id。取值范围：不涉及。
name	String	参数解释：任务名称。取值范围：不涉及。
user_name	String	参数解释：用户名。取值范围：不涉及。
description	String	参数解释：任务描述。取值范围：不涉及。
type	String	参数解释：任务类型。取值范围：- COMMON -SERVICE_DEPLOY 等。
status	String	参数解释：任务状态。取值范围：- PROCESSING, -FINISHED, -DELETED。
abnormal_count	Integer	参数解释：task失败的节点数量。取值范围：不涉及。
create_at	String	参数解释：创建时间。取值范围：不涉及。
update_at	String	参数解释：更新时间。取值范围：不涉及。

请求示例

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

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

响应示例

状态码：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
}