全部產品
Search
文件中心

Elasticsearch:RestartLogstash

更新時間:Jan 15, 2025

調用RestartLogstash,重啟指定執行個體。重啟後,執行個體會進入生效中(activating)狀態。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

要求標頭

該介面使用公用要求標頭,無特殊要求標頭。請參見公用請求參數文檔。

請求文法

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

請求參數

名稱類型位置是否必選樣本值描述
InstanceIdStringPathls-cn-v0h1kzca****

執行個體ID。

forceBooleanQuerytrue

是否強制重啟:

  • true:強制,
  • false(預設):不強制
clientTokenStringQuery5A2CFF0E-5718-45B5-9D4D-70B3FF****

用於保證請求的等冪性。由用戶端產生該參數值,要保證在不同請求間唯一,最大不超過64個ASCII字元。

ObjectBody

請求體。

batchCountdoubleBody20%

強制重啟的並發度。藍綠重啟時,無法進行強制重啟,無需設定。

restartTypeStringBodyinstance

重啟類型,可選值:

  • instance:重啟執行個體
  • nodeIp:重啟節點
nodesArray of StringBody["192.168.1.1"]

待重啟的節點的IP地址清單,採用JSON數組格式。

nodeTypesArray of StringBodykibana

重啟的角色節點類型,暫不支援。

blueGreenDepBooleanBodyfalse

是否進行藍綠重啟,預設為false。

返回資料

名稱類型樣本值描述
RequestIdStringF99407AB-2FA9-489E-A259-40CF6DCC****

請求ID。

ResultLogstash

當前執行個體的詳情。

返回資料中還包括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****"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。