Help Center/ CodeArts Pipeline/ API Reference/ API/ Pipeline Management/ Obtaining Custom Parameters Required for Pipeline Running
Updated on 2025-03-25 GMT+08:00

Obtaining Custom Parameters Required for Pipeline Running

Function

This API is used to obtain custom parameters required for pipeline running.

Calling Method

For details, see Calling APIs.

URI

GET /v5/{project_id}/api/pipelines/{pipeline_id}/list-runtime-vars

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Parameter description:

CodeArts project ID.

Constraints:

N/A.

Value Range:

The value contains 32 characters.

Default value:

N/A.

pipeline_id

Yes

String

Parameter description:

Pipeline ID.

Constraints:

N/A.

Value Range:

The value contains 32 characters.

Default value:

N/A.

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

offset

No

Integer

Offset.

limit

No

Integer

Number of records of each query.

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Parameter description:

User token.

It can be obtained by calling the IAM API. The value of X-Subject-Token in the response header is the user token.

Constraints:

None.

Value range:

None.

Default value:

None.

X-Language

No

String

Language. The value can be zh-cn (Chinese) or en-us (English). The default value is en-us.

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

offset

Integer

Offset.

limit

Integer

Size.

total

Integer

Total number of records.

variables

Array of PipelineVariable objects

Customized pipeline parameters

Table 5 PipelineVariable

Parameter

Type

Description

name

String

Parameter description:

Parameter name.

Value range:

N/A

sequence

Integer

Parameter description:

Sequence number.

Value range:

1–2147483647

type

String

Parameter description:

Type.

Value range:

N/A

value

String

Parameter description:

Default value.

Value range:

N/A

is_secret

Boolean

Parameter description:

Whether the parameter is private.

Value range:

true: private; false: not private.

description

String

Parameter description:

Description.

Value range:

N/A

is_runtime

Boolean

Parameter description:

Whether a parameter can be set during runtime.

Value range:

true: The parameter can be set during runtime; false: The parameter cannot be set during runtime.

limits

Array of strings

Parameter description:

List of limited enumerated values.

Value range:

N/A

is_reset

Boolean

Parameter description:

Whether an auto-increment parameter is reset.

Value range:

true: reset; false: not reset.

latest_value

String

Parameter description:

The latest value of an auto-increment parameter.

Value range:

N/A

Example Requests

GET https://{endpoint}/v5/6428c2e2b4b64affa14ec80896695c49/api/pipelines/633839ac12a2465ba86dfc5cd212ee1a/list-runtime-vars

Example Responses

None

Status Codes

Status Code

Description

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

Error Codes

See Error Codes.