指定した Logstash クラスタを再起動します。クラスタが再起動されると、アクティブ化状態になります。
デバッグ
リクエストヘッダー
この操作では、共通のリクエストヘッダーのみを使用します。 詳細については、「共通リクエストヘッダー」をご参照ください。
リクエスト構文
POST /openapi/logstashes/{InstanceId}/actions/restart HTTP/1.1リクエストパラメーター
| パラメーター | タイプ | 位置 | 必須 | 例 | 説明 |
| InstanceId | String | Path | はい | ls-cn-v0h1kzca**** | インスタンス ID。 |
| force | ブール値 | Query | いいえ | true | 強制的に再起動するかどうか:
|
| clientToken | String | Query | いいえ | 5A2CFF0E-5718-45B5-9D4D-70B3FF**** | リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。 |
| Object | Body | いいえ | リクエストの本文。 | ||
| batchCount | double | Body | いいえ | 20% | 強制再起動の同時実行性。ブルーグリーン再起動中は、強制再起動を実行できず、設定は不要です。 |
| restartType | String | Body | いいえ | instance | 再起動タイプ。有効な値:
|
| nodes | String の配列 | Body | いいえ | ["192.168.1.1"] | 再起動するノードの IP アドレスリスト (JSON 配列形式)。 |
| nodeTypes | String の配列 | Body | いいえ | kibana | 再起動するロールノードのタイプ。このパラメーターはサポートされていません。 |
| blueGreenDep | ブール値 | Body | いいえ | false | ブルーグリーン再起動を実行するかどうかを指定します。 デフォルト値: false。 |
レスポンスパラメーター
| パラメーター | タイプ | 例 | 説明 |
| RequestId | String | F99407AB-2FA9-489E-A259-40CF6DCC**** | リクエスト ID。 |
| Result | Logstash | 現在のインスタンスの詳細。 |
返されるデータには、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 エラーセンターをご覧ください。