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.

« Get runner Set runner roles »
Elastic Docs ›Elastic Cloud Enterprise Reference [2.4] ›RESTful API ›API reference ›Platform - Runners

Resynchronize runner

edit

Resynchronize runner

edit

Immediately resynchronizes the search index and cache for the selected runner.

Request

edit

POST /api/v1/platform/infrastructure/runners/{runner_id}/_resync

Path parameters

edit
Name Type Required Description

runner_id

string

Y

The identifier for the runner

Responses

edit
200

(EmptyResponse) The runner resync operation executed successfully

449

(BasicFailedReply) Elevated permissions are required. (code: root.unauthorized.rbac.elevated_permissions_required)

Headers

x-cloud-error-codes (string; allowed values: [root.unauthorized.rbac.elevated_permissions_required])
The error codes associated with the response
500

(BasicFailedReply) The runner resync operation failed for runner {runner_id}. (code: runners.resync_failed)

Headers

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

To perform this operation, you must be authenticated by means of one of the following methods: apiKey, basicAuth.

Request example

edit
curl -XPOST {{hostname}}/api/v1/platform/infrastructure/runners/{runner_id}/_resync \
-H "Authorization: ApiKey $ECE_API_KEY"
« Get runner Set runner roles »