Help Center/ CodeArts Pipeline/ API Reference/ API/ Pipeline Management/ Querying Parameters Used in a Pipeline

Updated on 2025-09-08 GMT+08:00

Online Debugging

CLI Examples

View PDF

Querying Parameters Used in a Pipeline

Function

This API is used to query parameters used in a pipeline.

Calling Method

For details, see Calling APIs.

URI

GET /v5/{project_id}/api/pipelines/{pipeline_id}/pipeline-runs/{pipelineRunId}/run-variables

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
pipelineRunId	Yes	String	Pipeline run ID. The return value of the API for starting a pipeline is the pipeline run ID.
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
pipeline_id	Yes	String	Definition: Pipeline ID. Obtain the ID by calling the API for querying pipelines. pipelines.pipelineId indicates the pipeline ID. Constraints: N/A Value range: The value consists of 32 characters, including digits and letters. Default value: N/A

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
mode	Yes	Integer	Query mode. 0: user-defined parameter; 1: system parameter; 2: parameter group.

Request Parameters

None

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
[items]	Array of ListRunVariablesResp objects	Response body.

**Table 4** ListRunVariablesResp
Parameter	Type	Description
name	String	Parameter name.
sequence	String	Parameter sequence number.
type	String	Parameter type.
value	String	Parameter value.
is_secret	Boolean	Whether the parameter is private. true: private; false: not private.
description	String	Description.
is_runtime	String	Whether the parameter must be set at runtime. true: The parameter must be set at runtime. false: The parameter does not need to be set at runtime.
limits	String	Parameter limit value.
is_reset	Boolean	Reset or not.
latest_value	String	Parameter value of the latest run.
required	Boolean	Mandatory or not. true: mandatory; false: optional.
variableGroupName	String	Parameter group name.

Example Requests

GET https://(endpoint)/v5/071112d87d3e4ed49130c691936202e9/api/pipelines/53acae73a3f44b2994f9b20a710721c6/pipeline-runs/13a48f79f7104f9785720cf2c11890ba/run-variables?mode=0

Example Responses

Status code: 200

Response body.

[ {
  "name" : "PROJECT_ID",
  "sequence" : null,
  "type" : "string",
  "value" : "071112d87d3e4ed49130c691936202e9",
  "is_secret" : false,
  "description" : "ID of the project to which the current pipeline belongs",
  "is_runtime" : null,
  "limits" : null,
  "is_reset" : false,
  "latest_value" : null,
  "required" : true,
  "variableGroupName" : null
}, {
  "name" : "PIPELINE_ID",
  "sequence" : null,
  "type" : "string",
  "value" : "53acae73a3f44b2994f9b20a710721c6",
  "is_secret" : false,
  "description" : "ID of the current pipeline",
  "is_runtime" : null,
  "limits" : null,
  "is_reset" : false,
  "latest_value" : null,
  "required" : true,
  "variableGroupName" : null
}, {
  "name" : "PIPELINE_NUMBER",
  "sequence" : null,
  "type" : "string",
  "value" : "34",
  "is_secret" : false,
  "description" : "Pipeline execution number",
  "is_runtime" : null,
  "limits" : null,
  "is_reset" : false,
  "latest_value" : null,
  "required" : true,
  "variableGroupName" : null
}, {
  "name" : "COMMIT_ID",
  "sequence" : null,
  "type" : "string",
  "value" : "fc315b91f027d252be756ade0b4263f6b6be58f4",
  "is_secret" : false,
  "description" : "ID of the last commit for execution",
  "is_runtime" : null,
  "limits" : null,
  "is_reset" : false,
  "latest_value" : null,
  "required" : true,
  "variableGroupName" : null
}, {
  "name" : "COMMIT_ID_SHORT",
  "sequence" : null,
  "type" : "string",
  "value" : "fc315b91",
  "is_secret" : false,
  "description" : "Short ID of the last code commit for execution",
  "is_runtime" : null,
  "limits" : null,
  "is_reset" : false,
  "latest_value" : null,
  "required" : true,
  "variableGroupName" : null
}, {
  "name" : "TIMESTAMP",
  "sequence" : null,
  "type" : "string",
  "value" : "20240621144916",
  "is_secret" : false,
  "description" : "Pipeline execution timestamp. For example: 20211222124301",
  "is_runtime" : null,
  "limits" : null,
  "is_reset" : false,
  "latest_value" : null,
  "required" : true,
  "variableGroupName" : null
}, {
  "name" : "PIPELINE_TRIGGER_TYPE",
  "sequence" : null,
  "type" : "string",
  "value" : "Manual",
  "is_secret" : false,
  "description" : "Pipeline trigger type, which can be **Manual**, **Scheduler**, **RollBack**, **CreateTag**, **Note**, **Issue**, **MR**, or **Push**.",
  "is_runtime" : null,
  "limits" : null,
  "is_reset" : false,
  "latest_value" : null,
  "required" : true,
  "variableGroupName" : null
}, {
  "name" : "REPO_URL",
  "sequence" : null,
  "type" : "string",
  "value" : "https://001/test.git",
  "is_secret" : false,
  "description" : "Code repository address (HTTPS)",
  "is_runtime" : null,
  "limits" : null,
  "is_reset" : false,
  "latest_value" : null,
  "required" : true,
  "variableGroupName" : null
}, {
  "name" : "PIPELINE_RUN_ID",
  "sequence" : null,
  "type" : "string",
  "value" : "13a48f79f7104f9785720cf2c11890ba",
  "is_secret" : false,
  "description" : "Pipeline execution ID",
  "is_runtime" : null,
  "limits" : null,
  "is_reset" : false,
  "latest_value" : null,
  "required" : true,
  "variableGroupName" : null
}, {
  "name" : "test_REPOSITORY_NAME",
  "sequence" : null,
  "type" : "string",
  "value" : "test",
  "is_secret" : false,
  "description" : "Repository name",
  "is_runtime" : null,
  "limits" : null,
  "is_reset" : false,
  "latest_value" : null,
  "required" : true,
  "variableGroupName" : null
}, {
  "name" : "test_SOURCE_BRANCH",
  "sequence" : null,
  "type" : "string",
  "value" : "",
  "is_secret" : false,
  "description" : "Name of the branch of the code source",
  "is_runtime" : null,
  "limits" : null,
  "is_reset" : false,
  "latest_value" : null,
  "required" : true,
  "variableGroupName" : null
}, {
  "name" : "test_TARGET_BRANCH",
  "sequence" : null,
  "type" : "string",
  "value" : "branch-001",
  "is_secret" : false,
  "description" : "Name of the target branch of the code source",
  "is_runtime" : null,
  "limits" : null,
  "is_reset" : false,
  "latest_value" : null,
  "required" : true,
  "variableGroupName" : null
}, {
  "name" : "test_TAG",
  "sequence" : null,
  "type" : "string",
  "value" : "",
  "is_secret" : false,
  "description" : "Repository tag name",
  "is_runtime" : null,
  "limits" : null,
  "is_reset" : false,
  "latest_value" : null,
  "required" : true,
  "variableGroupName" : null
}, {
  "name" : "test_COMMIT_ID",
  "sequence" : null,
  "type" : "string",
  "value" : "fc315b91f027d252be756ade0b4263f6b6be58f4",
  "is_secret" : false,
  "description" : "ID of the last code commit for execution",
  "is_runtime" : null,
  "limits" : null,
  "is_reset" : false,
  "latest_value" : null,
  "required" : true,
  "variableGroupName" : null
}, {
  "name" : "test_COMMIT_ID_SHORT",
  "sequence" : null,
  "type" : "string",
  "value" : "fc315b91",
  "is_secret" : false,
  "description" : "Short ID of the last code commit for execution",
  "is_runtime" : null,
  "limits" : null,
  "is_reset" : false,
  "latest_value" : null,
  "required" : true,
  "variableGroupName" : null
}, {
  "name" : "test_REPO_URL",
  "sequence" : null,
  "type" : "string",
  "value" : "https://1/test.git",
  "is_secret" : false,
  "description" : "Code repository address (HTTPS)",
  "is_runtime" : null,
  "limits" : null,
  "is_reset" : false,
  "latest_value" : null,
  "required" : true,
  "variableGroupName" : null
} ]