kotovalexarian-likes-gitlab
/
gitlab-org--gitlab-foss
1
0
Fork 0
Code Releases Activity

More fixes in runners doc 

[ci skip]
This commit is contained in:
Achilleas Pipinellis 2016-02-03 15:39:55 +02:00 committed by Tomasz Maczukin
parent a09ae17337
commit dc32af9508
1 changed files with 13 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
doc/api/runners.md
View File

@ -2,10 +2,11 @@
## List owned runners
Get a list of specific runners available for user.
Get a list of runners available to the user.
```
GET /runners
GET /runners?scope=active
```
| Attribute | Type | Required | Description |
@ -39,10 +40,12 @@ Example response:
## List all runners
Get a list of all runners (specific and shared). Access restricted to users with `admin` privileges.
Get a list of all runners in the GitLab instance (specific and shared). Access
is restricted to users with `admin` privileges.
```
GET /runners/all
GET /runners?scope=online
```
| Attribute | Type | Required | Description |
@ -210,8 +213,9 @@ Example response:
## List project's runners
List all runners (*shared* and *specific*) available in project. Shared runners are listed if at least one shared runner
is defined **and** shared runners usage is enabled in project's settings.
List all runners (specific and shared) available in the project. Shared runners
are listed if at least one shared runner is defined **and** shared runners
usage is enabled in the project's settings.
```
GET /projects/:id/runners
@ -222,7 +226,7 @@ GET /projects/:id/runners
| `id` | integer | yes | The ID of a project |
```
curl -H "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/project/9/runners"
curl -H "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/projects/9/runners"
```
Example response:
@ -248,7 +252,7 @@ Example response:
## Enable a runner in project
Enable available specific runner in project.
Enable an available specific runner in the project.
```
POST /projects/:id/runners/:runner_id
@ -277,8 +281,9 @@ Example response:
## Disable a runner from project
Disable a specific runner from project. It works only, if the project isn't an only project associated with the
specified runner. If so, then an error is returned and user should use the [remove a runner](#remove-a-runner) feature.
Disable a specific runner from the project. It works only if the project isn't
the only project associated with the specified runner. If so, an error is
returned. Use the [Remove a runner](#remove-a-runner) call instead.
```
DELETE /projects/:id/runners/:runner_id