シャットダウンAPIを削除（Delete shutdown API）

シャットダウンAPIの削除

この機能は、Elasticsearch Service、Elastic Cloud Enterprise、およびElastic Cloud on Kubernetesによる間接的な使用を目的としています。直接の使用はサポートされていません。

シャットダウンの準備をキャンセルするか、シャットダウン要求をクリアして、ノードが通常の操作を再開できるようにします。

リクエスト

DELETE _nodes/<node-id>/shutdown

前提条件

• Elasticsearchのセキュリティ機能が有効になっている場合、このAPIを使用するにはmanage クラスター権限が必要です。
• オペレーター権限機能が有効になっている場合、このAPIを使用するにはオペレーターである必要があります。

説明

put shutdownリクエストの後、ノードが通常の操作を再開できるようにします。ノードがクラスターに再参加する際、またはノードがクラスターを永久に離れた際には、シャットダウン要求を明示的にクリアする必要があります。シャットダウン要求はElasticsearchによって自動的に削除されることはありません。

パスパラメータ

• <node-id>
• (オプション、文字列) シャットダウンのために準備したノードのID。

クエリパラメータ

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

例

ノードを再起動するために準備します:

Python

resp = client.shutdown.put_node(
   node_id="USpTGYaBSIKbgSUJR2Z9lg",
   type="restart",
   reason="Demonstrating how the node shutdown API works",
)
print(resp)

Ruby

response = client.shutdown.put_node(
  node_id: 'USpTGYaBSIKbgSUJR2Z9lg',
  body: {
   type: 'restart',
   reason: 'Demonstrating how the node shutdown API works'
  }
)
puts response

Js

const response = await client.shutdown.putNode({
  node_id: "USpTGYaBSIKbgSUJR2Z9lg",
  type: "restart",
  reason: "Demonstrating how the node shutdown API works",
});
console.log(response);

コンソール

PUT /_nodes/USpTGYaBSIKbgSUJR2Z9lg/shutdown
{
  "type": "restart",
  "reason": "Demonstrating how the node shutdown API works"
}

再起動後にシャットダウンの準備をキャンセルするか、シャットダウン要求をクリアします:

Python

resp = client.shutdown.delete_node(
   node_id="USpTGYaBSIKbgSUJR2Z9lg",
)
print(resp)

Ruby

response = client.shutdown.delete_node(
  node_id: 'USpTGYaBSIKbgSUJR2Z9lg'
)
puts response

Js

const response = await client.shutdown.deleteNode({
  node_id: "USpTGYaBSIKbgSUJR2Z9lg",
});
console.log(response);

コンソール

DELETE /_nodes/USpTGYaBSIKbgSUJR2Z9lg/shutdown

次のレスポンスが返されます:

コンソール-結果

{
   "acknowledged": true
}