elasticsearch/docs/reference/ccr/apis/follow/post-pause-follow.asciidoc

[role="xpack"]
[[ccr-post-pause-follow]]
=== Pause follower API
++++
<titleabbrev>Pause follower</titleabbrev>
++++

Pauses a follower index.

[[ccr-post-pause-follow-request]]
==== {api-request-title}

//////////////////////////

[source,console]
--------------------------------------------------
PUT /follower_index/_ccr/follow?wait_for_active_shards=1
{
  "remote_cluster" : "remote_cluster",
  "leader_index" : "leader_index"
}
--------------------------------------------------
// TESTSETUP
// TEST[setup:remote_cluster_and_leader_index]

//////////////////////////

[source,console]
--------------------------------------------------
POST /<follower_index>/_ccr/pause_follow
--------------------------------------------------
// TEST[s/<follower_index>/follower_index/]

[[ccr-post-pause-follow-prereqs]]
==== {api-prereq-title}

* If the {es} {security-features} are enabled, you must have `manage_ccr` cluster
privileges on the cluster that contains the follower index. For more information,
see <<security-privileges>>.

[[ccr-post-pause-follow-desc]]
==== {api-description-title}

This API pauses a follower index. When this API returns, the follower index will
not fetch any additional operations from the leader index. You can resume
following with the <<ccr-post-resume-follow,resume follower API>>. Pausing and
resuming a follower index can be used to change the configuration of the
following task.

[[ccr-post-pause-follow-path-parms]]
==== {api-path-parms-title}

`<follower_index>`::
  (Required, string) The name of the follower index.

[[ccr-post-pause-follow-query-params]]
==== {api-query-parms-title}

`master_timeout`::
(Optional, <<time-units, time units>>) Specifies the period of time to wait for
a connection to the master node. If no response is received before the timeout
expires, the request fails and returns an error. Defaults to `30s`.

[[ccr-post-pause-follow-examples]]
==== {api-examples-title}

This example pauses a follower index named `follower_index`:

[source,console]
--------------------------------------------------
POST /follower_index/_ccr/pause_follow
--------------------------------------------------
// TEST

The API returns the following result:

[source,console-result]
--------------------------------------------------
{
  "acknowledged" : true
}
--------------------------------------------------