インデックスライフサイクル管理APIの停止
インデックスライフサイクル管理 (ILM) プラグインを停止します。
リクエスト
POST /_ilm/stop
前提条件
- Elasticsearchのセキュリティ機能が有効になっている場合、このAPIを使用するには
manage_ilm
クラスタ特権が必要です。詳細については、セキュリティ特権を参照してください。
説明
すべてのライフサイクル管理操作を停止し、ILMプラグインを停止します。これは、クラスタのメンテナンスを行っているときに、ILMがインデックスに対して何らかのアクションを実行するのを防ぐために便利です。
APIは、停止リクエストが承認されるとすぐに返されますが、プラグインは進行中の操作が完了するまで実行を続ける可能性があり、プラグインを安全に停止できる状態になるまで待機します。ILMステータスの取得 APIを使用して、ILMが実行中かどうかを確認します。
クエリパラメータ
master_timeout
- (オプション、時間単位) マスターノードを待機する期間。タイムアウトが切れる前にマスターノードが利用できない場合、リクエストは失敗し、エラーが返されます。デフォルトは
30s
です。リクエストがタイムアウトしないことを示すために-1
に設定することもできます。 timeout
- (オプション、時間単位) クラスタメタデータを更新した後、クラスタ内のすべての関連ノードからの応答を待機する期間。タイムアウトが切れる前に応答が受信されない場合、クラスタメタデータの更新は適用されますが、応答は完全に承認されなかったことを示します。デフォルトは
30s
です。リクエストがタイムアウトしないことを示すために-1
に設定することもできます。
例
以下の例は、ILMプラグインを停止します。
Python
resp = client.ilm.stop()
print(resp)
Ruby
response = client.ilm.stop
puts response
Js
const response = await client.ilm.stop();
console.log(response);
コンソール
POST _ilm/stop
コンソール-結果
{
"acknowledged": true
}