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.

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

Search runners

edit

Search runners

edit

Retrieves runners that match a given query.

Request

edit

POST /api/v1/platform/infrastructure/runners/_search

Request body

edit

(SearchRequest) The optional search request to execute. If not supplied then all runners are matched.

Responses

edit
200

(RunnerOverview) An overview of runners that matched the given search query.

400

(BasicFailedReply) The search request failed. (code: runners.search_failed)

Headers

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

Request example

edit
curl -XPOST https://{{hostname}}/api/v1/platform/infrastructure/runners/_search \
-H "Authorization: ApiKey $ECE_API_KEY" \
-d '
{
   "from" : 0,
   "query" : {
      "bool" : {
         "filter" : [
            null
         ],
         "minimum_should_match" : 0,
         "must" : [
            null
         ],
         "must_not" : [
            null
         ],
         "should" : [
            null
         ]
      },
      "exists" : {
         "field" : "string"
      },
      "match" : {
         "some_property" : {
            "analyzer" : "string",
            "minimum_should_match" : 0,
            "operator" : "string",
            "query" : "string"
         }
      },
      "match_all" : {},
      "match_none" : {},
      "nested" : {
         "path" : "string",
         "query" : null,
         "score_mode" : "string"
      },
      "prefix" : {
         "some_property" : {
            "boost" : 0.1,
            "value" : "string"
         }
      },
      "query_string" : {
         "allow_leading_wildcard" : true,
         "analyzer" : "string",
         "default_field" : "string",
         "default_operator" : "string",
         "query" : "string"
      },
      "range" : {
         "some_property" : {
            "boost" : 0.1,
            "format" : "string",
            "gt" : {},
            "gte" : {},
            "lt" : {},
            "lte" : {},
            "time_zone" : "string"
         }
      },
      "term" : {
         "some_property" : {
            "value" : {}
         }
      }
   },
   "size" : 0,
   "sort" : [
      {}
   ]
}
'
« Resynchronize runners Delete runner »