Obtaining Build Record Information (Unavailable Soon)

Function

This API is used to obtain build record information.

Calling Method

For details, see Calling APIs.

URI

GET /v3/jobs/{job_id}/{build_no}/record-info

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
job_id	Yes	String	Definition Enter the ID of the build task whose history you want to query. To obtain this ID, open the build task details page in your browser, and copy the 32-character string, which includes both digits and letters, at the end of the URL. Constraints N/A. Range The value is 32 characters long. Only letters and digits are allowed. Default Value N/A.
build_no	Yes	Integer	Definition The build number tracks each run of the build task. This parameter starts at 1, indicating the first build. It increments by 1 for every subsequent run. Constraints The value is a positive integer. Range Use only numbers that are 1 or greater. Default Value 1

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition User token. (The value of the X-Subject-Token response header is the user token.) It can be obtained by calling the IAM service API. For details, seeObtaining an IAM User Token. Constraints Global tenant tokens are not supported. Use a region-level token whose scope is project. Range N/A. Default Value N/A.

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
success	Boolean	Definition Status. Range ● true: The query is successful. ● false: The query fails.
message	String	Definition Message. Range N/A.
err_code	String	Definition Error code. Range N/A.
result	result object	Definition Data returned after the API is successfully called. Range N/A.

**Table 4** result
Parameter	Type	Description
id	String	Definition ID. Range N/A.
buildProjectId	String	Definition Build project ID. It uniquely corresponds to codeci_job_id. Range N/A.
buildRecordId	String	Definition Build record ID. Range N/A.
parentRecordId	String	Definition Parent build record ID. Range N/A.
devcloudProjectId	String	Definition Project ID. Range N/A.
codeciJobId	String	Definition codeci task ID. It uniquely corresponds to build_project_id. Range N/A.
userId	String	Definition User ID. Range N/A.
buildNo	Integer	Definition Build number. Range N/A.
dailyBuildNum	String	Definition Daily build number. It starts from 1 every day. Range N/A.
executionId	String	Definition CloudOctopus task ID. Range N/A.
repoName	String	Definition Repository name. Range N/A.
repoId	String	Definition Repository ID. Range N/A.
branch	String	Definition Repository branch. Range N/A.
tag	String	Definition Repository tag. Range N/A.
commit	String	Definition Repository commit ID. Range N/A.
commitMessage	String	Definition Repository commit message. Range N/A.
commitCreateTime	String	Definition Commit creation time. Range N/A.
triggerType	String	Definition Triggering mode. Options include MANUAL (manual execution), TIMED_EXECUTION (schedule), CODEHUB_TRIGGER (code change), or PIPELINE_TRIGGER (pipeline). Range ● MANUAL: Manual trigger ● TIMED_EXECUTION: Scheduled trigger ● CODEHUB_TRIGGER: Code change trigger ● PIPELINE_TRIGGER: Pipeline trigger
buildType	String	Definition Build type. Options include build from a branch, tag, or commit. Range The value can be branch (referencing the build source by branch), tag (referencing the build source by tag), or commitId (referencing the build source by commit ID).
status	String	Definition Build status. Range N/A.
domainId	String	Definition Tenant ID. Range N/A.
createTime	String	Definition Build task creation time. Range N/A.
scheduleTime	String	Definition Build assignment time. Range N/A.
queuedTime	String	Definition Build queuing duration. Range N/A.
startTime	String	Definition Build start time. Range N/A.
runnableTime	String	Definition Time when CloudOctopus starts the build process. Range N/A.
finishTime	String	Definition Build end time. Range N/A.
duration	Float	Definition Build duration. Range N/A.
recordStatus	String	Definition Build task record status. Range N/A.
usePrivateSlave	Integer	Definition Whether a custom executor is used. Range N/A.
region	String	Definition The region where the tenant is located. Range N/A.
errMsg	String	Definition Error message. Range N/A.
buildConfigType	String	Definition Build configuration type. It can be YAML or ACTION. Range YAML or ACTION.

Example Requests

GET https://{endpoint}/v3/jobs/cb5fa20de5fd4cf8be681d4bd6fdd2f6/61/record-info

Example Responses

Status code: 200

{
  "success" : true,
  "message" : "",
  "err_code" : "",
  "result" : {
    "id" : "8605c15d-efac-4973-9825-8fa16202c4a4",
    "buildProjectId" : "6a310b95-62e3-48eb-a35b-474f5daa3ccc",
    "buildRecordId" : "48da14e2-6ee7-495b-9dc7-f14d4a344511",
    "devcloudProjectId" : "eeb08ff821434781ac86211e640c50b2",
    "codeciJobId" : "b3c3fbb0cc0a4b388cb500b807a42334",
    "userId" : "6d7a54d45bf44a0684a7a682f719ffd9",
    "buildNo" : 1,
    "dailyBuildNum" : "20220909.1",
    "executionId" : "j_AIQZdVeb",
    "repoName" : "APITest-Python-02",
    "repoId" : 568398,
    "branch" : "master",
    "commit" : "c2be53c0ffe913e4c9b8cebd013dcbef3a76d70b",
    "commitMessage" : "init",
    "commitCreateTime" : "2019-11-13T03:28:32.000+00:00",
    "triggerType" : "MANUAL",
    "buildType" : "branch",
    "status" : "SUCCESS",
    "domainId" : "764f03980afc4e5c97a1a9a73c1d707a",
    "createTime" : "2022-09-09T06:31:50.000+00:00",
    "scheduleTime" : "2022-09-09T06:31:50.000+00:00",
    "queuedTime" : "2022-09-09T06:31:51.000+00:00",
    "startTime" : "2022-09-09T06:31:51.000+00:00",
    "runnableTime" : "2022-09-09T06:31:50.000+00:00",
    "finishTime" : "2022-09-09T06:32:43.000+00:00",
    "duration" : 52261.0,
    "usePrivateSlave" : 0,
    "region" : "xx-xxxx-xx",
    "buildConfigType" : "ACTION\"",
    "tag" : null,
    "recordStatus" : null,
    "errMsg" : null
  }
}