Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:orchestration-write.
objectunionThe targets of the schedule.
stringThe target branch the build should run on.
list<BranchName>The branches to retrieve JobSpecs from if no JobSpec is found on the target branch.
booleanWhether to ignore staleness information when running the build.
integerThe number of retry attempts for failed jobs.
objectThe duration to wait before retrying after a Job fails.
booleanIf any job in the build is unsuccessful, immediately finish the build by cancelling all other jobs.
booleanWhether to receive a notification at the end of the build.
The notification will be sent to the user that has most recently edited the schedule.
No notification will be sent if the schedule has scopeMode set to ProjectScope.
objectstringThe RID of a Build.
stringThe branch that the build is running on.
stringThe timestamp that the build was created.
stringThe user who created the build.
list<BranchName>The branches to retrieve JobSpecs from if no JobSpec is found on the target branch.
list<JobRid>integerThe number of retry attempts for failed Jobs within the Build. A Job's failure is not considered final until all retries have been attempted or an error occurs indicating that retries cannot be performed. Be aware, not all types of failures can be retried.
objectThe duration to wait before retrying after a Job fails.
booleanIf any job in the build is unsuccessful, immediately finish the build by cancelling all other jobs.
string (enum)The status of the build.
Enum values: RUNNING, SUCCEEDED, FAILED, CANCELED
stringSchedule RID of the Schedule that triggered this build. If a user triggered the build, Schedule RID will be empty.
1
2
3
4
5
curl -X POST \
\t-H "Content-type: application/json" \
\t-H "Authorization: Bearer $TOKEN" \
"https://$HOSTNAME/api/v2/orchestration/builds/create" \
-d '{"abortOnFailure":false,"retryBackoffDuration":{"unit":"SECONDS","value":30},"retryCount":1,"fallbackBranches":[],"branchName":"master","target":{"type":"manual","targetRids":["ri.foundry.main.dataset.4263bdd9-d6bc-4244-9cca-893c1a2aef62","ri.foundry.main.dataset.86939c1e-4256-41db-9fe7-e7ee9e0f752a"]}}'1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
"abortOnFailure": false,
"createdBy": "f05f8da4-b84c-4fca-9c77-8af0b13d11de",
"retryBackoffDuration": {
"unit": "SECONDS",
"value": 30
},
"retryCount": 1,
"fallbackBranches": [],
"scheduleRid": "ri.scheduler.main.schedule.5ad5c340-59f3-4a60-9fc6-161bb984f871",
"branchName": "master",
"createdTime": "2003-05-06T12:34:56.789Z",
"jobRids": [
"ri.foundry.main.job.aaf94076-d773-4732-a1df-3b638eb50448"
],
"rid": "ri.foundry.main.build.a4386b7e-d546-49be-8a36-eefc355f5c58",
"status": "RUNNING"
}| Error Name | ||
|---|---|---|
Create | Error Code | PERMISSION_DENIED |
| Status Code | 403 | |
| Description | Could not create the Build. | |
| Parameters | | |
See Errors for a general overview of errors in the platform.