Scroll to navigation

Search::Elasticsearch::Client::8_0::Direct::CCR(3) User Contributed Perl Documentation Search::Elasticsearch::Client::8_0::Direct::CCR(3)

NAME

Search::Elasticsearch::Client::8_0::Direct::CCR - Plugin providing cross-cluster replication APIs for Search::Elasticsearch 8.x

VERSION

version 8.12

DESCRIPTION

This module provides methods to use the cross-cluster replication feature.

The full documentation for CCR is available here: <https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-apis.html>

FOLLOW METHODS

follow()

    $response = $es->ccr->follow(
        index   => $index,  # required
        body    => {...}    # required
    )

The follow() method creates a new follower index that is configured to follow the referenced leader index.

Query string parameters:
"error_trace",
"filter_path",
"human",
"wait_for_active_shards"

See the CCR follow docs <https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-put-follow.html> for more information.

pause_follow()

    $response = $es->ccr->pause_follow(
        index   => $index,  # required
    )

The pause_follow() method pauses following of an index.

Query string parameters:
"error_trace",
"filter_path",
"human"

See the CCR pause follow docs <https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-post-pause-follow.html> for more information.

resume_follow()

    $response = $es->ccr->resume_follow(
        index   => $index,  # required
    )

The resume_follow() method resumes following of an index.

Query string parameters:
"error_trace",
"filter_path",
"human"

See the CCR resume follow docs <https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-post-resume-follow.html> for more information.

unfollow()

    $response = $es->ccr->unfollow(
        index   => $index,  # required
    )

The unfollow() method converts a follower index into a normal index.

Query string parameters:
"error_trace",
"filter_path",
"human"

See the CCR unfollow docs <https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-post-unfollow.html> for more information.

forget_follower()

    $response = $es->ccr->forget_follower(
        index   => $index,  # required
    )

The forget_follower() method removes the follower retention leases from the leader.

Query string parameters:
"error_trace",
"filter_path",
"human"

See the CCR forget_follower docs <https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-post-forget-follower.html> for more information.

STATS METHODS

stats()

    $response = $es->ccr->stats()

The stats() method returns all stats related to cross-cluster replication.

Query string parameters:
"error_trace",
"filter_path",
"human"

See the CCR stats docs <https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-get-stats.html> for more information.

follow_stats()

    $response = $es->ccr->follow_stats(
        index   => $index | \@indices,  # optional
    )

The follow_stats() method returns shard-level stats about follower indices.

Query string parameters:
"error_trace",
"filter_path",
"human"

See the CCR follow stats docs <https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-get-follow-stats.html> for more information.

follow_info()

    $response = $es->ccr->follow_info(
        index   => $index | \@indices,  # optional
    )

The follow_info() method returns the parameters and the status for each follower index.

Query string parameters:
"error_trace",
"filter_path",
"human"

See the CCR follow info docs <https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-get-follow-info.html> for more information.

AUTO-FOLLOW METHODS

put_auto_follow_pattern()

    $response = $es->ccr->put_auto_follow_pattern(
        name    => $name    # required
    )

The put_auto_follow_pattern() method creates a new named collection of auto-follow patterns against the remote cluster specified in the request body.

Query string parameters:
"error_trace",
"filter_path",
"human"

See the CCR put auto follow pattern docs <https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-put-auto-follow-pattern.html> for more information.

get_auto_follow_pattern()

    $response = $es->ccr->get_auto_follow_pattern(
        name    => $name    # optional
    )

The get_auto_follow_pattern() method retrieves a named collection of auto-follow patterns, or all patterns.

Query string parameters:
"error_trace",
"filter_path",
"human"

See the CCR get auto follow pattern docs <https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-get-auto-follow-pattern.html> for more information.

delete_auto_follow_pattern()

    $response = $es->ccr->delete_auto_follow_pattern(
        name    => $name    # required
    )

The delete_auto_follow_pattern() method deletes a named collection of auto-follow patterns.

Query string parameters:
"error_trace",
"filter_path",
"human"

See the CCR delete auto follow pattern docs <https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-delete-auto-follow-pattern.html> for more information.

AUTHOR

Enrico Zimuel <enrico.zimuel@elastic.co>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2024 by Elasticsearch BV.

This is free software, licensed under:

  The Apache License, Version 2.0, January 2004
2024-03-08 perl v5.40.0