すべてのプロダクト
Search
ドキュメントセンター

Elasticsearch:推定 Logstash 再起動時間

最終更新日:Mar 17, 2025

EstimatedLogstashRestartTime を呼び出して、Logstash インスタンスを再起動できる推定期間を取得します。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer を使用すると、API 操作の検索、API 操作の呼び出し、SDK サンプルコードの動的生成を行うことができます。

リクエストヘッダー

この操作では、共通のリクエストヘッダーのみを使用します。 詳細については、「共通パラメーター」をご参照ください。

リクエスト構文

POST /openapi/logstashes/[InstanceId]/estimated-time/restart-time HTTPS|HTTP

リクエストパラメーター

パラメーター タイプ 必須 説明
InstanceId String はい ls-cn-oew1qbgl****

インスタンス ID。

force ブール値 いいえ false

再起動を強制するかどうかを示します。 デフォルト値: false。

リクエスト本文

リクエスト本文に次のパラメーターを入力して、再起動パラメーターを指定することもできます。

パラメーター

タイプ

必須

説明

restartType

String

いいえ

instance

再起動タイプ。 有効な値: instance (インスタンスの再起動。デフォルト) および nodeIp (ノードの再起動)。

nodes

List<String>

いいえ

["127.0.xx.xx"]

ノードが再起動するときに、ターゲットノードの IP アドレスリストを選択します。

blueGreenDep

ブール値

いいえ

false

ノードが再起動されたときにブルーグリーン変更を実行するかどうかを指定します。 デフォルト値: false。

batch

Integer

いいえ

25.0

強制インスタンス再起動の同時実行性。 デフォルト値: 1/ノードの総数。

batchUnit

String

いいえ

percent

バッチ単位。 デフォルト値: percent。

  • restartType が instance に設定されている場合、blueGreenDep パラメーターは無視されます。
    • force が true に設定されています。 batch の値は 0 より大きく、100 以下である必要があります。そうでない場合、システムは RestartBatchValueError エラーをプロンプトします。
    • force の値は false です。 batch のデフォルト値は 0 です。別の値が入力されると、NormalRestartNotSupportBatch エラーが報告されます。
  • restartType が nodeIp に設定されている場合、batch パラメーターは無視されます。
    • nodeIp が空の場合、システムはパラメーターエラーをプロンプトします。
    • blueGreenDep が true に設定されている場合、ブルーグリーン変更の再起動が実行されます。 blueGreenDep が false に設定されている場合、通常の再起動が実行されます。

サンプルコード:

{
    "restartType":"nodeIp",
    "nodes": ["172.16.xx.xx"],
    "blueGreenDep":true
}

レスポンスパラメーター

パラメーター タイプ 説明
RequestId String 5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1D***

リクエスト ID。

Result Struct

戻り値。

unit String second

単位。

value Long 600

推定再起動時間。

サンプルリクエスト

POST /openapi/logstashes/ls-cn-oew1qbgl****/estimated-time/restart-time/restart-time?force=true HTTP/1.1
共通リクエストヘッダー

サンプルの成功レスポンス

JSON 構文

{
    "Result": {
        "unit": "second",
        "value": 600
    },
    "RequestId": "623E4A4C-199E-4A71-8096-842831A4****"
}

エラーコード

エラーコードのリストについては、API エラーセンターをご覧ください。