WARNING: Version 6.2 of Elasticsearch has passed its EOL date.

This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.

« Start Datafeeds API Update Datafeeds API »

› › ›

Stop Datafeeds API

This API enables you to stop one or more datafeeds.

A datafeed that is stopped ceases to retrieve data from Elasticsearch. A datafeed can be started and stopped multiple times throughout its lifecycle.

Request

POST _xpack/ml/datafeeds/<feed_id>/_stop

POST _xpack/ml/datafeeds/<feed_id>,<feed_id>/_stop

POST _xpack/ml/datafeeds/_all/_stop

Description

You can stop multiple datafeeds in a single API request by using a comma-separated list of datafeeds or a wildcard expression. You can close all datafeeds by using _all or by specifying * as the <feed_id>.

Path Parameters

feed_id: (string) Identifier for the datafeed. It can be a datafeed identifier or a wildcard expression.

Request Body

force: (boolean) If true, the datafeed is stopped forcefully.
timeout: (time) Controls the amount of time to wait until a datafeed stops. The default value is 20 seconds.

Authorization

You must have manage_ml, or manage cluster privileges to use this API. For more information, see Security Privileges.

Examples

The following example stops the datafeed-total-requests datafeed:

POST _xpack/ml/datafeeds/datafeed-total-requests/_stop
{
  "timeout": "30s"
}

When the datafeed stops, you receive the following results:

{
  "stopped": true
}

« Start Datafeeds API Update Datafeeds API »