ポリシーを削除（Remove policy）

インデックスAPIからポリシーを削除

インデックスまたはデータストリームのバックインデックスから割り当てられた ライフサイクル ポリシーを削除します。

リクエスト

POST <target>/_ilm/remove

前提条件

• Elasticsearchのセキュリティ機能が有効になっている場合、このAPIを使用するには管理対象のインデックスに対してmanage_ilmの権限が必要です。詳細については、セキュリティ権限を参照してください。

説明

インデックスの場合、ライフサイクルポリシー削除APIは割り当てられたライフサイクルポリシーを削除し、指定されたインデックスの管理を停止します。

データストリームの場合、APIはストリームのバックインデックスから割り当てられたライフサイクルポリシーを削除し、インデックスの管理を停止します。

パスパラメータ

• <target>
• (必須、文字列) 対象とするデータストリーム、インデックス、およびエイリアスのカンマ区切りリスト。ワイルドカード(*)をサポートします。すべてのデータストリームとインデックスを対象とするには、*または_allを使用します。

クエリパラメータ

• master_timeout
• (オプション、時間単位) マスターノードを待機する期間。タイムアウトが切れる前にマスターノードが利用できない場合、リクエストは失敗し、エラーが返されます。デフォルトは30sです。リクエストがタイムアウトしないことを示すために-1に設定することもできます。

例

次の例は、my-index-000001から割り当てられたポリシーを削除します。

Python

resp = client.ilm.remove_policy(
   index="my-index-000001",
)
print(resp)

Ruby

response = client.ilm.remove_policy(
  index: 'my-index-000001'
)
puts response

Js

const response = await client.ilm.removePolicy({
  index: "my-index-000001",
});
console.log(response);

コンソール

POST my-index-000001/_ilm/remove

リクエストが成功した場合、次の結果が返されます：

コンソール-結果

{
  "has_failures" : false,
  "failed_indexes" : []
}