Querying the Pipeline Group Tree

Function

This API is used to query the pipeline group tree.

Calling Method

For details, see Calling APIs.

URI

GET /v5/{project_id}/api/pipeline-group/tree

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition: Project ID. For details, see Obtaining a Project ID. Constraints: N/A Value range: The value consists of 32 characters, including digits and letters. Default value: N/A

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition: User token. Obtain a token (the value of the X-Subject-Token response header) by calling the IAM API for . Constraints: N/A Value range: N/A Default value: N/A

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
[items]	Array of PipelineGroupVo objects	Parameter description: Pipeline group parameter list. PipelineGroupVo stores pipeline group parameters, including the IDs of parent and child groups. Constraints: N/A.

**Table 4** PipelineGroupVo
Parameter	Type	Description
id	String	Definition: Group ID. Value range: The value consists of 32 characters, including digits and letters.
domain_id	String	Definition: Tenant ID, that is, domain ID of a user. Range: The value consists of 32 characters, including digits and letters.
project_id	String	Definition: Project ID. Value range: The value consists of 32 characters, including digits and letters.
name	String	Definition: Group name. Value range: The value consists of 32 characters, including digits and letters.
parent_id	String	Definition: Parent group ID. Value range: The value consists of 32 characters, including digits and letters.
path_id	String	Parameter description: Group path ID. For example, id1.id2.id3 indicates that the parent group of group id3 is id2, and the parent group of group id2 is id1. Value range: N/A.
ordinal	Integer	Definition: Sequence number. Value range: ≥ 0
creator	String	Definition: Creator ID. Value range: The value consists of 32 characters, including digits and letters.
updater	String	Definition: Updater ID. Value range: The value consists of 32 characters, including digits and letters.
create_time	Long	Parameter description: Creation time. Value range: N/A.
update_time	Long	Parameter description: Update time. Value range: N/A.
children	Array of PipelineGroupVo objects	Definition: Pipeline group details. Value range: N/A

Status code: 400

**Table 5** Response body parameters
Parameter	Type	Description
error_msg	String	Parameter description: Error message. Value range: N/A
error_code	String	Parameter description: Error code. Value range: N/A

Example Requests

GET https://{endpoint}/v5/d80a8a6530324b7bac972cbb8a9f28ec/api/pipeline-group/tree

Example Responses

Status code: 200

[ {
  "id" : "894daf0db79c4ccb839490770fa06596",
  "domain_id" : "ce8df55870164338a72d7e828a966a2a",
  "project_id" : "d80a8a6530324b7bac972cbb8a9f28ec",
  "name" : "Creating a Group 22",
  "parent_id" : "",
  "path_id" : "894daf0db79c4ccb839490770fa06596",
  "ordinal" : 2,
  "creator" : "847a5317086c41798469d0868535943a",
  "updater" : null,
  "create_time" : 1698487536000,
  "update_time" : null,
  "children" : null
}, {
  "id" : "2ca78947b25847a9ab68a07d8ef1347b",
  "domain_id" : "ce8df55870164338a72d7e828a966a2a",
  "project_id" : "d80a8a6530324b7bac972cbb8a9f28ec",
  "name" : "Creating group 11",
  "parent_id" : "",
  "path_id" : "2ca78947b25847a9ab68a07d8ef1347b",
  "ordinal" : 1,
  "creator" : "847a5317086c41798469d0868535943a",
  "updater" : null,
  "create_time" : 1698487008000,
  "update_time" : null,
  "children" : null
}, {
  "id" : "58d55f8a646443a984e7399632b3963e",
  "domain_id" : "ce8df55870164338a72d7e828a966a2a",
  "project_id" : "d80a8a6530324b7bac972cbb8a9f28ec",
  "name" : "G2",
  "parent_id" : "",
  "path_id" : "58d55f8a646443a984e7399632b3963e",
  "ordinal" : 0,
  "creator" : "847a5317086c41798469d0868535943a",
  "updater" : "847a5317086c41798469d0868535943a",
  "create_time" : 1698484566000,
  "update_time" : 1698485674000,
  "children" : [ {
    "id" : "d805c90bf99049d3a49e83d2024df6b8",
    "domain_id" : "ce8df55870164338a72d7e828a966a2a",
    "project_id" : "d80a8a6530324b7bac972cbb8a9f28ec",
    "name" : "Creating group 3",
    "parent_id" : "58d55f8a646443a984e7399632b3963e",
    "path_id" : "58d55f8a646443a984e7399632b3963e.d805c90bf99049d3a49e83d2024df6b8",
    "ordinal" : 1,
    "creator" : "847a5317086c41798469d0868535943a",
    "updater" : "847a5317086c41798469d0868535943a",
    "create_time" : 1698487527000,
    "update_time" : 1698487868000,
    "children" : null
  }, {
    "id" : "ebb779b3b9f742e181b1f6829fa1aca0",
    "domain_id" : "ce8df55870164338a72d7e828a966a2a",
    "project_id" : "d80a8a6530324b7bac972cbb8a9f28ec",
    "name" : "Creating a Group",
    "parent_id" : "58d55f8a646443a984e7399632b3963e",
    "path_id" : "58d55f8a646443a984e7399632b3963e.ebb779b3b9f742e181b1f6829fa1aca0",
    "ordinal" : 0,
    "creator" : "847a5317086c41798469d0868535943a",
    "updater" : null,
    "create_time" : 1698485344000,
    "update_time" : null,
    "children" : [ {
      "id" : "1b80aa3df0984e9caffefdc4e557524e",
      "domain_id" : "ce8df55870164338a72d7e828a966a2a",
      "project_id" : "d80a8a6530324b7bac972cbb8a9f28ec",
      "name" : "Creating group 4",
      "parent_id" : "ebb779b3b9f742e181b1f6829fa1aca0",
      "path_id" : "58d55f8a646443a984e7399632b3963e.ebb779b3b9f742e181b1f6829fa1aca0.1b80aa3df0984e9caffefdc4e557524e",
      "ordinal" : 2,
      "creator" : "847a5317086c41798469d0868535943a",
      "updater" : null,
      "create_time" : 1698487502000,
      "update_time" : null,
      "children" : null
    }, {
      "id" : "6bc8a3cda52c41fe84d71c9ff86161ea",
      "domain_id" : "ce8df55870164338a72d7e828a966a2a",
      "project_id" : "d80a8a6530324b7bac972cbb8a9f28ec",
      "name" : "Creating group 3",
      "parent_id" : "ebb779b3b9f742e181b1f6829fa1aca0",
      "path_id" : "58d55f8a646443a984e7399632b3963e.ebb779b3b9f742e181b1f6829fa1aca0.6bc8a3cda52c41fe84d71c9ff86161ea",
      "ordinal" : 1,
      "creator" : "847a5317086c41798469d0868535943a",
      "updater" : null,
      "create_time" : 1698486710000,
      "update_time" : null,
      "children" : null
    } ]
  } ]
} ]