Help Center/ CodeArts Pipeline/ API Reference/ API/ Pipeline Management/ Running a YAML-based Pipeline Using YAML
Updated on 2025-09-08 GMT+08:00

Running a YAML-based Pipeline Using YAML

Function

This API is used to run a YAML-based pipeline in dry-run mode using YAML.

Calling Method

For details, see Calling APIs.

URI

POST /v5/{project_id}/api/pac/pipelines/dry-run

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 forobtaining a user token.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

X-Language

No

String

Definition:

Language type.

Constraints:

N/A

Value range:

  • zh-cn: Chinese.

  • en-us: English.

Default value:

en-us.

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

repository

Yes

Repository object

Definition:

Code repository information.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

description

No

String

Definition:

Pipeline running description.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

configuration

Yes

String

Definition:

YAML content.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

Table 4 Repository

Parameter

Mandatory

Type

Description

type

Yes

String

Definition:

Code repository type.

Constraints:

N/A

Value range:

  • CodeArts Repo.

  • Gitee.

  • GitHub.

  • GitCode.

  • GitLab.

Default value:

N/A

git_http_url

Yes

String

Definition:

HTTPS address of the code repository.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

branch

Yes

String

Definition:

Code repository branch.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

Response Parameters

Status code: 200

Table 5 Response body parameters

Parameter

Type

Description

pipeline_id

String

ID of the pipeline temporarily created during a dry-run execution.

pipeline_run_id

String

Pipeline run ID.

Example Requests

POST https://{endpoint}/v5/6428c2e2b4b64affa14ec80896695c49/api/pac/pipelines/dry-run

Example Responses

None

Status Codes

Status Code

Description

200

Response body for running a YAML-based pipeline in dry-run mode.

401

Unauthorized

403

Forbidden

404

Not Found

Error Codes

See Error Codes.