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>
++++

..New API reference
[sidebar]
--
For the most up-to-date API details, refer to {api-es}/group/endpoint-ccr[Cross-cluster replication APIs].
--

Resumes a {ccr} <<ccr-auto-follow,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}

include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=master-timeout]

[[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
}
--------------------------------------------------