Build Task¶
Build task represents information about individual build tasks. One task is responsible for one chroot.
Structure of the build task entity¶
{
"chroot_name": "fedora-rawhide-x86_64",
"build_id": 12345,
"started_on": 1440753865,
"ended_on": 1440753919,
"state": "succeeded",
"result_dir_url": "http://copr-be-dev.cloud.fedoraproject.org/results/vgologuz/aeghqawgt/fedora-rawhide-x86_64/00106882-python-marshmallow",
"git_hash": "d241064b14f9dcd5d9032d0aca3b4e78fbd1aafd"
}
Build tasks fields¶
Field | Type | Description |
---|---|---|
chroot_name | str | chroot name |
build_id | int | unique build identifier |
state | str | current build task state |
started_on | int(unixtime UTC) | time when the build chroot started |
ended_on | int(unixtime UTC) | time when the build chroot ended |
git_hash | str | hash of the git commit in dist-git used for the build |
result_dir_url | str(URL) | location of the build results |
Note
Build Task doesn’t currently support any modifications, so all fields are read-only.
List build tasks¶
-
GET
/api_2/builds_tasks
¶ Returns list of build tasks according to the given query parameters
Query Parameters: - owner (str) – select build tasks from projects owned by this user
- project_id (int) – select build tasks from one project,
when used query parameter
owner
is ignored - build_id (int) – select build tasks from one project,
when used query parameters
owner
andproject_id
are ignored - state (str) – select builds in particular state, allowed values:
failed
,succeeded
,canceled
,running
,pending
,starting
,importing
- offset (int) – offset number, default value is 0
- limit (int) – limit number between 1 and 100, default value is 100
Status Codes: - 200 OK – no error
- 404 Not Found – build not found
Example request
GET /api_2/builds_tasks?build_id=106882 HTTP/1.1 Host: copr.fedoraproject.org
Response
HTTP/1.1 200 OK Content-Type: application/json { "build_tasks": [ { "build_task": { "chroot_name": "fedora-rawhide-x86_64", "started_on": 1440753865, "state": "succeeded", "ended_on": 1440753919, "result_dir_url": "http://copr-be-dev.cloud.fedoraproject.org/results/vgologuz/aeghqawgt/fedora-rawhide-x86_64/00106882-python-marshmallow", "git_hash": "d241064b14f9dcd5d9032d0aca3b4e78fbd1aafd" }, "_links": { "project": { "href": "/api_2/projects/3985" }, "self": { "href": "/api_2/build_tasks/106882/fedora-rawhide-x86_64" } } } ], "_links": { "self": { "href": "/api_2/build_tasks?build_id=106882" } } }
Get build task details¶
-
GET
/api_2/build_tasks/
(int: build_id)/
(str: name)¶ Returns details about one build task
Parameters: - build_id (int) – a unique identifier of the build
- name (str) – chroot name
Status Codes: - 200 OK – no error
- 404 Not Found – build or build task not found
Example request
GET /api_2/build_tasks/106882/fedora-rawhide-x86_64 HTTP/1.1 Host: copr.fedoraproject.org
Response
HTTP/1.1 200 OK Content-Type: application/json { "build_task": { "chroot_name": "fedora-rawhide-x86_64", "build_id": 3985, "started_on": 1440753865, "state": "succeeded", "ended_on": 1440753919, "result_dir_url": "http://copr-be-dev.cloud.fedoraproject.org/results/vgologuz/aeghqawgt/fedora-rawhide-x86_64/00106882-python-marshmallow", "git_hash": "d241064b14f9dcd5d9032d0aca3b4e78fbd1aafd" }, "_links": { "project": { "href": "/api_2/projects/3985" }, "self": { "href": "/api_2/build_tasks/106882/fedora-rawhide-x86_64" } } }