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

Elasticsearch:Logstash の再起動

最終更新日:Mar 17, 2025

指定した Logstash クラスタを再起動します。クラスタが再起動されると、アクティブ化状態になります。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK の操作のサンプルコードを動的に生成します。

リクエストヘッダー

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

リクエスト構文

POST /openapi/logstashes/{InstanceId}/actions/restart HTTP/1.1

リクエストパラメーター

パラメータータイプ位置必須説明
InstanceIdStringPathはいls-cn-v0h1kzca****

インスタンス ID。

forceブール値Queryいいえtrue

強制的に再起動するかどうか:

  • true: 強制
  • false (デフォルト): 強制しない
clientTokenStringQueryいいえ5A2CFF0E-5718-45B5-9D4D-70B3FF****

リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。

ObjectBodyいいえ

リクエストの本文。

batchCountdoubleBodyいいえ20%

強制再起動の同時実行性。ブルーグリーン再起動中は、強制再起動を実行できず、設定は不要です。

restartTypeStringBodyいいえinstance

再起動タイプ。有効な値:

  • instance: インスタンスを再起動する
  • nodeIp: ノードを再起動する
nodesString の配列Bodyいいえ["192.168.1.1"]

再起動するノードの IP アドレスリスト (JSON 配列形式)。

nodeTypesString の配列Bodyいいえkibana

再起動するロールノードのタイプ。このパラメーターはサポートされていません。

blueGreenDepブール値Bodyいいえfalse

ブルーグリーン再起動を実行するかどうかを指定します。 デフォルト値: false。

レスポンスパラメーター

パラメータータイプ説明
RequestIdStringF99407AB-2FA9-489E-A259-40CF6DCC****

リクエスト ID。

ResultLogstash

現在のインスタンスの詳細。

返されるデータには、Result パラメーターも含まれています。 パラメーターの詳細については、「Logstash の一覧表示」をご参照ください。

サンプルリクエスト

POST /openapi/logstashes/ls-cn-v0h1kzca****/actions/restart?force=true&clientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF**** HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json

{
  "restartType" : "instance"
}

サンプルレスポンス

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Result" : {
    "instanceId" : "ls-cn-v0h1kzca****",
    "version" : "7.4.0_with_X-Pack",
    "description" : "es-74-keepit",
    "nodeAmount" : 1,
    "paymentType" : "prepaid",
    "status" : "active",
    "enablePublic" : false,
    "nodeSpec" : {
      "spec" : "elasticsearch.sn1ne.large",
      "disk" : 20,
      "diskType" : "cloud_ssd"
    },
    "networkConfig" : {
      "vpcId" : "vpc-bp12nu14urf0upaf4****",
      "vswitchId" : "vsw-bp131d5ag0vjd5ja3****",
      "vsArea" : "cn-hangzhou-h",
      "type" : "vpc"
    },
    "createdAt" : "2020-03-26T09:23:06.575Z",
    "updatedAt" : "2020-05-12T11:06:14.132Z",
    "commodityCode" : "elasticsearch_logstash_pre",
    "extendConfigs" : [ ],
    "endTime" : 1619884800000,
    "clusterTasks" : [ ],
    "resourceGroupId" : "rg-acfm2h5vbzd****",
    "zoneCount" : 1,
    "protocol" : "HTTP",
    "zoneInfos" : [ {
      "zoneId" : "cn-hangzhou-h",
      "status" : "NORMAL"
    } ],
    "instanceType" : "logstash",
    "inited" : true,
    "tags" : [ ],
    "config" : {
      "slowlog.threshold.warn" : "2s",
      "slowlog.threshold.info" : "1s",
      "slowlog.threshold.debug" : "500ms",
      "slowlog.threshold.trace" : "100ms"
    },
    "endpointList" : [ {
      "host" : "10.7.**.**",
      "port" : 9600,
      "zoneId" : "cn-hangzhou-h"
    } ]
  },
  "RequestId" : "831AD23B-175F-47F1-8314-AFBB9947****"
}

エラーコード

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