It is time to say goodbye: This version of Elastic Cloud Enterprise has reached end-of-life (EOL) and is no longer supported.

The documentation for this version is no longer being maintained. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.

« Delete runner Resynchronize runner »
Elastic Docs ›Elastic Cloud Enterprise Reference [2.12] ›RESTful API ›API reference ›Platform - Runners

Get runner

edit

Get runner

edit

Retrieves a runner by id.

Request

edit

GET /api/v1/platform/infrastructure/runners/{runner_id}

Path parameters

edit
Name Type Required Description

runner_id

string

Y

The identifier for the runner

Responses

edit
200

(RunnerInfo) The information for the runner specified by {runner_id}.

404

(BasicFailedReply) Unable to find the {runner_id} specified runner. Edit your request, then try again. (code: runners.runner_not_found)

Headers

x-cloud-error-codes (string; allowed values: [runners.runner_not_found])
The error codes associated with the response

Request example

edit
curl -XGET https://{{hostname}}/api/v1/platform/infrastructure/runners/{runner_id} \
-H "Authorization: ApiKey $ECE_API_KEY"
« Delete runner Resynchronize runner »