文档首页/ 编译构建 CodeArts Build/ API参考/ 编译构建API/ 分组管理/ 查询分组树
更新时间：2025-09-04 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询分组树

功能介绍

查询分组树

调用方法

请参见如何调用API。

URI

GET /v1/job/{project_id}/group/tree

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

CodeArts项目ID。获取方式请参考获取CodeArts项目ID。

约束限制：

不涉及。

取值范围：

32位数字、字母组合的字符串。

默认取值：

不涉及。

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

result

Array of JobGroupTreeResponseBody objects

返回结果

error

String

返回错误信息

status

String

返回状态信息
表3 JobGroupTreeResponseBody

参数

参数类型

描述

id

String

分组编号

domain_id

String

租户ID

project_id

String

CodeArts项目ID。构建任务所在项目的ID。

name

String

分组名称

parent_id

String

父分组编号

path_id

String

分组路径

ordinal

Integer

序数

create_user

String

创建用户

update_user

String

更新用户

create_time

String

创建时间

update_time

String

更新时间

children

Array of JobGroupTreeResponseBody objects

子分组

状态码：400

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码：401

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码：403

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码：404

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码：500

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

GET https://{endpoint}/v1/job/{project_id}/group/tree

响应示例

状态码：200

OK

{
  "result" : [ {
    "id" : "b13c933bbc6f4d09a98ef09e4cc07e17",
    "domain_id" : "60021bab32fd450aa2cb89226f425e06",
    "project_id" : "923785f9674548259144259077bc6a98",
    "name" : "新建分组-2160794",
    "parent_id" : null,
    "path_id" : "b13c933bbc6f4d09a98ef09e4cc07e17",
    "ordinal" : 0,
    "create_user" : "devcloud_codeci_z00485259_02",
    "update_user" : null,
    "create_time" : "2025-06-05T07:06:50+0800",
    "update_time" : null,
    "children" : [ {
      "id" : "e2c52ec7654948c09e635697a4ffcb59",
      "domain_id" : "60021bab32fd450aa2cb89226f425e06",
      "project_id" : "923785f9674548259144259077bc6a98",
      "name" : "分组测试2225",
      "parent_id" : "b13c933bbc6f4d09a98ef09e4cc07e17",
      "path_id" : "b13c933bbc6f4d09a98ef09e4cc07e17.e2c52ec7654948c09e635697a4ffcb59",
      "ordinal" : 7,
      "create_user" : "devcloud_codeci_z00485259_02",
      "update_user" : null,
      "create_time" : "2025-06-10T09:50:28+0800",
      "update_time" : null,
      "children" : null
    }, {
      "id" : "70e158b6054e442893d7f5a79d34ce61",
      "domain_id" : "60021bab32fd450aa2cb89226f425e06",
      "project_id" : "923785f9674548259144259077bc6a98",
      "name" : "新建分组237",
      "parent_id" : "b13c933bbc6f4d09a98ef09e4cc07e17",
      "path_id" : "b13c933bbc6f4d09a98ef09e4cc07e17.70e158b6054e442893d7f5a79d34ce61",
      "ordinal" : 6,
      "create_user" : "devcloud_codeci_z00485259_02",
      "update_user" : "devcloud_codeci_z00485259_02",
      "create_time" : "2025-06-09T02:55:39+0800",
      "update_time" : "2025-06-09T02:58:36+0800",
      "children" : null
    } ]
  } ],
  "error" : null,
  "status" : "success"
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

父主题： 分组管理

相关文档