summaryrefslogtreecommitdiff
path: root/doc/api/builds.md
diff options
context:
space:
mode:
authorTomasz Maczukin <tomasz@maczukin.pl>2016-01-11 11:15:04 +0100
committerTomasz Maczukin <tomasz@maczukin.pl>2016-01-11 11:15:04 +0100
commit4e70f2519bba83d5f9d6fd0bed80e9837e8b5fc5 (patch)
tree2f967d3eb865b3998e69ebf1c03b33b3767a5cf9 /doc/api/builds.md
parent96bbc145f31ad029e080ad8903445d81d6c31968 (diff)
downloadgitlab-ce-4e70f2519bba83d5f9d6fd0bed80e9837e8b5fc5.tar.gz
Update ./doc/api/builds.md
Diffstat (limited to 'doc/api/builds.md')
-rw-r--r--doc/api/builds.md301
1 files changed, 232 insertions, 69 deletions
diff --git a/doc/api/builds.md b/doc/api/builds.md
index c52266714d0..64efe6bb3b1 100644
--- a/doc/api/builds.md
+++ b/doc/api/builds.md
@@ -17,37 +17,97 @@ Parameters:
[
{
"commit": {
- "committed_at": "2015-12-28T14:34:03.814Z",
- "id": 2,
- "ref": null,
- "sha": "6b053ad388c531c21907f022933e5e81598db388"
+ "author_email": "admin@example.com",
+ "author_name": "Administrator",
+ "created_at": "2015-12-24T16:51:14.000+01:00",
+ "id": "0ff3ae198f8601a285adcf5c0fff204ee6fba5fd",
+ "message": "Test the CI integration.",
+ "short_id": "0ff3ae19",
+ "title": "Test the CI integration."
},
- "created_at": "2016-01-04T15:41:23.147Z",
- "finished_at": null,
- "id": 65,
- "name": "brakeman",
+ "coverage": null,
+ "created_at": "2015-12-24T15:51:21.802Z",
+ "download_url": null,
+ "finished_at": "2015-12-24T17:54:27.895Z",
+ "id": 7,
+ "name": "teaspoon",
"ref": "master",
"runner": null,
"stage": "test",
- "started_at": null,
- "status": "pending"
+ "started_at": "2015-12-24T17:54:27.722Z",
+ "status": "failed",
+ "tag": false,
+ "user": {
+ "avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
+ "bio": null,
+ "can_create_group": true,
+ "can_create_project": true,
+ "color_scheme_id": 2,
+ "created_at": "2015-12-21T13:14:24.077Z",
+ "current_sign_in_at": "2016-01-11T09:31:40.472Z",
+ "email": "admin@example.com",
+ "id": 1,
+ "identities": [],
+ "is_admin": true,
+ "linkedin": "",
+ "name": "Administrator",
+ "projects_limit": 100,
+ "skype": "",
+ "state": "active",
+ "theme_id": 3,
+ "twitter": "",
+ "two_factor_enabled": false,
+ "username": "root",
+ "web_url": "http://gitlab.dev/u/root",
+ "website_url": ""
+ }
},
{
"commit": {
- "committed_at": "2015-12-28T14:34:03.814Z",
- "id": 2,
- "ref": null,
- "sha": "6b053ad388c531c21907f022933e5e81598db388"
+ "author_email": "admin@example.com",
+ "author_name": "Administrator",
+ "created_at": "2015-12-24T16:51:14.000+01:00",
+ "id": "0ff3ae198f8601a285adcf5c0fff204ee6fba5fd",
+ "message": "Test the CI integration.",
+ "short_id": "0ff3ae19",
+ "title": "Test the CI integration."
},
- "created_at": "2016-01-04T15:41:23.046Z",
- "finished_at": null,
- "id": 64,
- "name": "rubocop",
+ "coverage": null,
+ "created_at": "2015-12-24T15:51:21.727Z",
+ "download_url": null,
+ "finished_at": "2015-12-24T17:54:24.921Z",
+ "id": 6,
+ "name": "spinach:other",
"ref": "master",
"runner": null,
"stage": "test",
- "started_at": null,
- "status": "pending"
+ "started_at": "2015-12-24T17:54:24.729Z",
+ "status": "failed",
+ "tag": false,
+ "user": {
+ "avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
+ "bio": null,
+ "can_create_group": true,
+ "can_create_project": true,
+ "color_scheme_id": 2,
+ "created_at": "2015-12-21T13:14:24.077Z",
+ "current_sign_in_at": "2016-01-11T09:31:40.472Z",
+ "email": "admin@example.com",
+ "id": 1,
+ "identities": [],
+ "is_admin": true,
+ "linkedin": "",
+ "name": "Administrator",
+ "projects_limit": 100,
+ "skype": "",
+ "state": "active",
+ "theme_id": 3,
+ "twitter": "",
+ "two_factor_enabled": false,
+ "username": "root",
+ "web_url": "http://gitlab.dev/u/root",
+ "website_url": ""
+ }
}
]
```
@@ -57,7 +117,7 @@ Parameters:
Get a list of builds for specific commit in a project.
```
-GET /projects/:id/builds/commit/:sha
+GET /projects/:id/repository/commits/:sha/builds
```
Parameters:
@@ -67,45 +127,104 @@ Parameters:
- `scope` (optional) - The scope of builds to show (one or array of: pending, running, failed, success, canceled; if none provided showing all builds)
```json
-[
- {
- "commit": {
- "committed_at": "2015-12-28T14:34:03.814Z",
- "id": 2,
- "ref": null,
- "sha": "6b053ad388c531c21907f022933e5e81598db388"
+
+```
+
+## Get a single build
+mmit": {
+ "author_email": "admin@example.com",
+ "author_name": "Administrator",
+ "created_at": "2015-12-24T16:51:14.000+01:00",
+ "id": "0ff3ae198f8601a285adcf5c0fff204ee6fba5fd",
+ "message": "Test the CI integration.",
+ "short_id": "0ff3ae19",
+ "title": "Test the CI integration."
},
- "created_at": "2016-01-04T15:41:23.147Z",
- "finished_at": null,
- "id": 65,
+ "coverage": null,
+ "created_at": "2015-12-24T15:51:21.957Z",
+ "download_url": null,
+ "finished_at": "2015-12-24T17:54:33.913Z",
+ "id": 9,
"name": "brakeman",
"ref": "master",
"runner": null,
"stage": "test",
- "started_at": null,
- "status": "pending"
+ "started_at": "2015-12-24T17:54:33.727Z",
+ "status": "failed",
+ "tag": false,
+ "user": {
+ "avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
+ "bio": null,
+ "can_create_group": true,
+ "can_create_project": true,
+ "color_scheme_id": 2,
+ "created_at": "2015-12-21T13:14:24.077Z",
+ "current_sign_in_at": "2016-01-11T09:31:40.472Z",
+ "email": "admin@example.com",
+ "id": 1,
+ "identities": [],
+ "is_admin": true,
+ "linkedin": "",
+ "name": "Administrator",
+ "projects_limit": 100,
+ "skype": "",
+ "state": "active",
+ "theme_id": 3,
+ "twitter": "",
+ "two_factor_enabled": false,
+ "username": "root",
+ "web_url": "http://gitlab.dev/u/root",
+ "website_url": ""
+ }
},
{
"commit": {
- "committed_at": "2015-12-28T14:34:03.814Z",
- "id": 2,
- "ref": null,
- "sha": "6b053ad388c531c21907f022933e5e81598db388"
+ "author_email": "admin@example.com",
+ "author_name": "Administrator",
+ "created_at": "2015-12-24T16:51:14.000+01:00",
+ "id": "0ff3ae198f8601a285adcf5c0fff204ee6fba5fd",
+ "message": "Test the CI integration.",
+ "short_id": "0ff3ae19",
+ "title": "Test the CI integration."
},
- "created_at": "2016-01-04T15:41:23.046Z",
- "finished_at": null,
- "id": 64,
+ "coverage": null,
+ "created_at": "2015-12-24T15:51:21.880Z",
+ "download_url": null,
+ "finished_at": "2015-12-24T17:54:31.198Z",
+ "id": 8,
"name": "rubocop",
"ref": "master",
"runner": null,
"stage": "test",
- "started_at": null,
- "status": "pending"
+ "started_at": "2015-12-24T17:54:30.733Z",
+ "status": "failed",
+ "tag": false,
+ "user": {
+ "avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
+ "bio": null,
+ "can_create_group": true,
+ "can_create_project": true,
+ "color_scheme_id": 2,
+ "created_at": "2015-12-21T13:14:24.077Z",
+ "current_sign_in_at": "2016-01-11T09:31:40.472Z",
+ "email": "admin@example.com",
+ "id": 1,
+ "identities": [],
+ "is_admin": true,
+ "linkedin": "",
+ "name": "Administrator",
+ "projects_limit": 100,
+ "skype": "",
+ "state": "active",
+ "theme_id": 3,
+ "twitter": "",
+ "two_factor_enabled": false,
+ "username": "root",
+ "web_url": "http://gitlab.dev/u/root",
+ "website_url": ""
+ }
}
]
-```
-
-## Get a single build
Get a single build of a project
@@ -121,20 +240,50 @@ Parameters:
```json
{
"commit": {
- "committed_at": "2015-12-28T14:34:03.814Z",
- "id": 2,
- "ref": null,
- "sha": "6b053ad388c531c21907f022933e5e81598db388"
+ "author_email": "admin@example.com",
+ "author_name": "Administrator",
+ "created_at": "2015-12-24T16:51:14.000+01:00",
+ "id": "0ff3ae198f8601a285adcf5c0fff204ee6fba5fd",
+ "message": "Test the CI integration.",
+ "short_id": "0ff3ae19",
+ "title": "Test the CI integration."
},
- "created_at": "2016-01-04T15:41:23.046Z",
- "finished_at": null,
- "id": 64,
+ "coverage": null,
+ "created_at": "2015-12-24T15:51:21.880Z",
+ "download_url": null,
+ "finished_at": "2015-12-24T17:54:31.198Z",
+ "id": 8,
"name": "rubocop",
"ref": "master",
"runner": null,
"stage": "test",
- "started_at": null,
- "status": "pending"
+ "started_at": "2015-12-24T17:54:30.733Z",
+ "status": "failed",
+ "tag": false,
+ "user": {
+ "avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
+ "bio": null,
+ "can_create_group": true,
+ "can_create_project": true,
+ "color_scheme_id": 2,
+ "created_at": "2015-12-21T13:14:24.077Z",
+ "current_sign_in_at": "2016-01-11T09:31:40.472Z",
+ "email": "admin@example.com",
+ "id": 1,
+ "identities": [],
+ "is_admin": true,
+ "linkedin": "",
+ "name": "Administrator",
+ "projects_limit": 100,
+ "skype": "",
+ "state": "active",
+ "theme_id": 3,
+ "twitter": "",
+ "two_factor_enabled": false,
+ "username": "root",
+ "web_url": "http://gitlab.dev/u/root",
+ "website_url": ""
+ }
}
```
@@ -154,20 +303,27 @@ Parameters:
```json
{
"commit": {
- "committed_at": "2015-12-28T14:34:03.814Z",
- "id": 2,
- "ref": null,
- "sha": "6b053ad388c531c21907f022933e5e81598db388"
+ "author_email": "admin@example.com",
+ "author_name": "Administrator",
+ "created_at": "2015-12-24T16:51:14.000+01:00",
+ "id": "0ff3ae198f8601a285adcf5c0fff204ee6fba5fd",
+ "message": "Test the CI integration.",
+ "short_id": "0ff3ae19",
+ "title": "Test the CI integration."
},
- "created_at": "2016-01-05T15:33:25.936Z",
- "finished_at": "2016-01-05T15:33:47.553Z",
- "id": 66,
+ "coverage": null,
+ "created_at": "2016-01-11T10:13:33.506Z",
+ "download_url": null,
+ "finished_at": "2016-01-11T10:14:09.526Z",
+ "id": 69,
"name": "rubocop",
"ref": "master",
"runner": null,
"stage": "test",
"started_at": null,
- "status": "canceled"
+ "status": "canceled",
+ "tag": false,
+ "user": null
}
```
@@ -187,19 +343,26 @@ Parameters:
```json
{
"commit": {
- "committed_at": "2015-12-28T14:34:03.814Z",
- "id": 2,
- "ref": null,
- "sha": "6b053ad388c531c21907f022933e5e81598db388"
+ "author_email": "admin@example.com",
+ "author_name": "Administrator",
+ "created_at": "2015-12-24T16:51:14.000+01:00",
+ "id": "0ff3ae198f8601a285adcf5c0fff204ee6fba5fd",
+ "message": "Test the CI integration.",
+ "short_id": "0ff3ae19",
+ "title": "Test the CI integration."
},
- "created_at": "2016-01-05T15:33:25.936Z",
+ "coverage": null,
+ "created_at": "2016-01-11T10:13:33.506Z",
+ "download_url": null,
"finished_at": null,
- "id": 66,
+ "id": 69,
"name": "rubocop",
"ref": "master",
"runner": null,
"stage": "test",
"started_at": null,
- "status": "pending"
+ "status": "pending",
+ "tag": false,
+ "user": null
}
```