This documentation contains work-in-progress information for future Elastic Stack and Cloud releases. Use the version selector to view supported release docs. It also contains some Elastic Cloud serverless information. Check out our serverless docs for more details.
Unfollow
editUnfollow
editPhases allowed: hot, warm, cold, frozen.
Converts a CCR follower index into a regular index. This enables the shrink, rollover, and searchable snapshot actions to be performed safely on follower indices. You can also use unfollow directly when moving follower indices through the lifecycle. Has no effect on indices that are not followers, phase execution just moves to the next action.
This action is triggered automatically by the rollover, shrink, and searchable snapshot actions when they are applied to follower indices.
This action waits until is it safe to convert a follower index into a regular index. The following conditions must be met:
-
The leader index must have
index.lifecycle.indexing_completeset totrue. This happens automatically if the leader index is rolled over using the rollover action, and can be set manually using the index settings API. - All operations performed on the leader index have been replicated to the follower index. This ensures that no operations are lost when the index is converted.
Once these conditions are met, unfollow performs the following operations:
- Pauses indexing following for the follower index.
- Closes the follower index.
- Unfollows the leader index.
- Opens the follower index (which is at this point is a regular index).
Options
editNone.
Example
editresp = client.ilm.put_lifecycle(
name="my_policy",
policy={
"phases": {
"hot": {
"actions": {
"unfollow": {}
}
}
}
},
)
print(resp)
response = client.ilm.put_lifecycle(
policy: 'my_policy',
body: {
policy: {
phases: {
hot: {
actions: {
unfollow: {}
}
}
}
}
}
)
puts response
const response = await client.ilm.putLifecycle({
name: "my_policy",
policy: {
phases: {
hot: {
actions: {
unfollow: {},
},
},
},
},
});
console.log(response);
PUT _ilm/policy/my_policy
{
"policy": {
"phases": {
"hot": {
"actions": {
"unfollow" : {}
}
}
}
}
}