調用RestartLogstash,重啟指定執行個體。重啟後,執行個體會進入生效中(activating)狀態。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
要求標頭
該介面使用公用要求標頭,無特殊要求標頭。請參見公用請求參數文檔。
請求文法
POST /openapi/logstashes/{InstanceId}/actions/restart HTTP/1.1請求參數
| 名稱 | 類型 | 位置 | 是否必選 | 樣本值 | 描述 |
| InstanceId | String | Path | 是 | ls-cn-v0h1kzca**** | 執行個體ID。 |
| force | Boolean | Query | 否 | true | 是否強制重啟:
|
| clientToken | String | Query | 否 | 5A2CFF0E-5718-45B5-9D4D-70B3FF**** | 用於保證請求的等冪性。由用戶端產生該參數值,要保證在不同請求間唯一,最大不超過64個ASCII字元。 |
| Object | Body | 否 | 請求體。 | ||
| batchCount | double | Body | 否 | 20% | 強制重啟的並發度。藍綠重啟時,無法進行強制重啟,無需設定。 |
| restartType | String | Body | 否 | instance | 重啟類型,可選值:
|
| nodes | Array of String | Body | 否 | ["192.168.1.1"] | 待重啟的節點的IP地址清單,採用JSON數組格式。 |
| nodeTypes | Array of String | Body | 否 | kibana | 重啟的角色節點類型,暫不支援。 |
| blueGreenDep | Boolean | Body | 否 | false | 是否進行藍綠重啟,預設為false。 |
返回資料
| 名稱 | 類型 | 樣本值 | 描述 |
| RequestId | String | F99407AB-2FA9-489E-A259-40CF6DCC**** | 請求ID。 |
| Result | Logstash | 當前執行個體的詳情。 |
返回資料中還包括Result參數,參數說明請參見ListLogstash。
樣本
請求樣本
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****"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。