diff options
author | Tomasz Maczukin <tomasz@maczukin.pl> | 2016-02-02 17:52:02 +0300 |
---|---|---|
committer | Tomasz Maczukin <tomasz@maczukin.pl> | 2016-02-19 15:18:47 +0300 |
commit | 81ced6f55b1ab847bbb21da9c43410340c95c2b3 (patch) | |
tree | 7b98c9f8a1d6b6d148f44e69d2bcb9b6767c216b /doc/api/runners.md | |
parent | b56ee397bb5fa32e3a53fdaee3d6592f1486d7f1 (diff) |
Split `/runners` entrypoint to `/runners` and `/runners/all`
Diffstat (limited to 'doc/api/runners.md')
-rw-r--r-- | doc/api/runners.md | 55 |
1 files changed, 53 insertions, 2 deletions
diff --git a/doc/api/runners.md b/doc/api/runners.md index 3be3fd17e65..a8b95ee49ed 100644 --- a/doc/api/runners.md +++ b/doc/api/runners.md @@ -1,8 +1,8 @@ # Runners API -## List runners +## List owned runners -Get a list of runners. +Get a list of specific runners available for user. ``` GET /runners @@ -37,6 +37,57 @@ Example response: ] ``` +## List all runners + +Get a list of all runners (specific and shared). Access restricted to users with `admin` privileges. + +``` +GET /runners/all +``` + +| Attribute | Type | Required | Description | +|-----------|---------|----------|---------------------| +| `scope` | string | no | The scope of runners to show, one of: `specific`, `shared`, `active`, `paused`, `online`; showing all runners if none provided | + +``` +curl -H "PRIVATE_TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/runners/all" +``` + +Example response: + +```json +[ + { + "active": true, + "description": "shared-runner-1", + "id": 1, + "is_shared": true, + "name": null + }, + { + "active": true, + "description": "shared-runner-2", + "id": 3, + "is_shared": true, + "name": null + }, + { + "active": true, + "description": "test-1-20150125", + "id": 6, + "is_shared": false, + "name": null + }, + { + "active": true, + "description": "test-2-20150125", + "id": 8, + "is_shared": false, + "name": null + } +] +``` + ## Get runner's details Get details of a runner. |