Help Center/ ServiceStage/ API Reference/ Historical APIs/ Build APIs/ Creating a Build Job Instance
Updated on 2025-09-25 GMT+08:00
View PDF
Share

Creating a Build Job Instance

Function

This API is used to create a build job instance based on the build job ID.

URI

POST /assembling/v1/jobs/{job_id}

Table 1 describes the parameters.

Table 1 Path parameters

Parameter

Mandatory

Type

Description

job_id

Yes

String

Build job ID. See Obtaining the Build Job List Based on the Component Name.

Request

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Message body type (format). Default value: application/json;charset=utf8.

X-Auth-Token

Yes

String

API calling can be authenticated using a token or AK/SK. If you use a token, this parameter is mandatory and must be set to the token. For details about how to obtain a token, see Obtaining a User Token.
Table 3 Response

Parameter

Mandatory

Type

Description

name

Yes

String

Build job name.

Response

Table 4 Response

Parameter

Type

Description

build_id

String

Build job instance ID.

job_id

String

Build job ID.

job_name

String

Build job name.

index

Integer

Index of the build job instance.

started_at

Object

Start time of the build job instance.

ended_at

Object

End time of the build job instance.

Example Request

None

Example Response

None

Status Code

Status Code

Description

200

OK

400

Bad Request

Error Code

The error code format is SVCSTG.CPE.[Error_ID], for example, SVCSTG.CPE.5004401. For details, see ServiceStage Error Codes.

Parent topic: Build APIs