elasticsearch/docs/reference/ccr/apis/auto-follow/resume-auto-follow-pattern.asciidoc

[role="xpack"]
[[ccr-resume-auto-follow-pattern]]
=== Resume auto-follow pattern API
++++
<titleabbrev>Resume auto-follow pattern</titleabbrev>
++++

Resumes an auto-follow pattern.

[[ccr-resume-auto-follow-pattern-request]]
==== {api-request-title}

`POST /_ccr/auto_follow/<auto_follow_pattern_name>/resume`

[[ccr-resume-auto-follow-pattern-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-resume-auto-follow-pattern-desc]]
==== {api-description-title}

This API resumes an <<ccr-auto-follow,auto-follow pattern>> that has been paused with the
<<ccr-pause-auto-follow-pattern, pause auto-follow pattern API>>. When this API
returns, the auto-follow pattern will resume configuring following indices for
newly created indices on the remote cluster that match its patterns. Remote
indices created while the pattern was paused will also be followed, unless they
have been deleted or closed in the meantime.

[[ccr-resume-auto-follow-pattern-path-parms]]
==== {api-path-parms-title}

`<auto_follow_pattern_name>`::
  (Required, string) Specifies the name of the auto-follow pattern to resume.

[[ccr-resume-auto-follow-pattern-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-resume-auto-follow-pattern-examples]]
==== {api-examples-title}

This example resumes the activity of a paused auto-follow pattern
named `my_auto_follow_pattern`:
//////////////////////////

[source,console]
--------------------------------------------------
PUT /_ccr/auto_follow/my_auto_follow_pattern
{
  "remote_cluster" : "remote_cluster",
  "leader_index_patterns" :
  [
    "leader_index"
  ],
  "follow_index_pattern" : "{{leader_index}}-follower"
}
--------------------------------------------------
// TEST[setup:remote_cluster]
// TESTSETUP

[source,console]
--------------------------------------------------
DELETE /_ccr/auto_follow/my_auto_follow_pattern
--------------------------------------------------
// TEST
// TEARDOWN

[source,console]
--------------------------------------------------
POST /_ccr/auto_follow/my_auto_follow_pattern/pause
--------------------------------------------------
// TEST

//////////////////////////
[source,console]
--------------------------------------------------
POST /_ccr/auto_follow/my_auto_follow_pattern/resume
--------------------------------------------------
// TEST

The API returns the following result:

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