NAME

Search::Elasticsearch::Client::8_0::Direct::ILM - Plugin providing index lifecycle management APIs for Search::Elasticsearch 8.x

VERSION

version 8.12

DESCRIPTION

This module provides methods to use the index lifecycle management feature.

The full documentation for ILM is available here: https://www.elastic.co/guide/en/elasticsearch/reference/current/index-lifecycle-management.html

POLICY METHODS

put_lifecycle()

$response = $es->ilm->put_lifecycle(
    policy  => $policy  # required
    body    => {...}    # required
)

The put_lifecycle() method creates or updates a lifecycle policy.

Query string parameters: error_trace, filter_path, human

See the ILM put_lifecycle docs for more information.

put_lifecycle()

$response = $es->ilm->put_lifecycle(
    policy  => $policy  # required
    body    => {...}    # required
)

The put_lifecycle() method creates or updates a lifecycle policy.

Query string parameters: error_trace, filter_path, human

See the ILM put_lifecycle docs for more information.

get_lifecycle()

$response = $es->ilm->get_lifecycle(
    policy  => $policy  # required
)

The get_lifecycle() method retrieves the specified policy

Query string parameters: error_trace, filter_path, human

See the ILM get_lifecycle docs for more information.

delete_lifecycle()

$response = $es->ilm->delete_lifecycle(
    policy  => $policy  # required
)

The delete_lifecycle() method deletes the specified policy

Query string parameters: error_trace, filter_path, human

See the ILM delete_lifecycle docs for more information.

INDEX MANAGEMENT METHODS

move_to_step()

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

The move_to_step() method triggers execution of a specific step in the lifecycle policy.

Query string parameters: error_trace, filter_path, human

See the ILM move_to_step docs for more information.

retry()

$response = $es->ilm->retry(
    index  => $index,       # required
)

The retry() method retries executing the policy for an index that is in the ERROR step.

Query string parameters: error_trace, filter_path, human

See the ILM retry docs for more information.

remove_lifecycle()

$response = $es->ilm->remove_lifecycle(
    index  => $index  # required
)

The remove_lifecycle() method removes a lifecycle from the specified index.

Query string parameters: error_trace, filter_path, human

See the ILM remove_lifecycle docs for more information.

explain_lifecycle()

$response = $es->ilm->explain_lifecycle(
    index  => $index  # required
)

The explain_lifecycle() method returns information about the index’s current lifecycle state.

Query string parameters: error_trace, filter_path, human

See the ILM explain_lifecycle docs for more information.

OPERATION MANAGEMENT APIS

status()

$response = $es->ilm->status;

The status() method returns the current operating mode for ILM.

Query string parameters: error_trace, filter_path, human

See the ILM status docs for more information.

start()

$response = $es->ilm->start;

The start() method starts the index lifecycle management process.

Query string parameters: error_trace, filter_path, human

See the ILM start docs for more information.

stop()

$response = $es->ilm->stop;

The stop() method stops the index lifecycle management process.

Query string parameters: error_trace, filter_path, human

See the ILM stop docs 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