本地英文版地址: ../en/slm-api-execute-lifecycle.html
Execute snapshot lifecycle policy APIedit
Immediately creates a snapshot according to the lifecycle policy, without waiting for the scheduled time.
Requestedit
PUT /_slm/policy/<snapshot-lifecycle-policy-id>/_execute
Prerequisitesedit
If the Elasticsearch security features are enabled, you must have the manage_slm
cluster privilege to use this API. For more information, see
Security privileges.
Descriptionedit
Manually applies the snapshot policy to immediately create a snapshot. The snapshot policy is normally applied according to its schedule, but you might want to manually execute a policy before performing an upgrade or other maintenance.
Path parametersedit
-
<policy-id> - (Required, string) ID of the snapshot lifecycle policy to execute.
Examplesedit
To take an immediate snapshot according to the daily-snapshots policy:
POST /_slm/policy/daily-snapshots/_execute
If successful, this request returns the generated snapshot name:
{
"snapshot_name": "daily-snap-2019.04.24-gwrqoo2xtea3q57vvg0uea"
}
The snapshot is taken in the background. You can use the snapshot APIs to monitor the status of the snapshot.
To see the status of a policy’s most recent snapshot, you can use the get snapshot lifecycle policy API.