UpgradeEngineVersion - Elasticsearch

說明升級執行個體版本功能目前只支援5.5.3版本升級到5.6.16版本、5.6.16版本升級到6.3.2版本、6.3.2版本升級到6.7.0版本，暫不支援其他版本間的升級。詳情請參見升級版本。

調試

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

要求標頭

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

請求文法

POST /openapi/instances/{InstanceId}/actions/upgrade-version HTTP/1.1

請求參數

名稱	類型	位置	是否必選	樣本值	描述
InstanceId	String	Path	是	es-cn-n6w1o1x0w001c****	執行個體ID。
clientToken	String	Query	否	5A2CFF0E-5718-45B5-9D4D-70B3FF****	用於保證請求的等冪性。由用戶端產生該參數值，要保證在不同請求間唯一，最大不超過64個ASCII字元。
dryRun	Boolean	Query	否	false	是否進行升級前校正： true：校正 false（預設）：不校正警告版本升級校正涉及叢集YML、外掛程式配置、叢集狀態、索引、資源等檢查，強烈建議升級前進行前置校正，否則可能帶來升級問題。
	Object	Body	否		請求體。
version	String	Body	否	6.7	升級後的版本。當type為engineVersion時，取值為執行個體版本，例如6.7；當type為aliVersion時，取值為核心版本，例如ali1.2.0。
type	String	Body	否	engineVersion	升級類型，可選值： engineVersion（預設）：大版本升級 aliVersion：核心版本升級

返回資料

名稱	類型	樣本值	描述
RequestId	String	F99407AB-2FA9-489E-A259-40CF6DC*****	請求ID。
Result	Array of Result		返回結果。
validateType	String	checkClusterHealth	校正類型。支援： checkClusterHealth：叢集健康狀態 checkConfigCompatible：配置相容狀態 checkClusterResource：資源空間狀態 checkClusterSnapshot：是否存在快照
validateResult	Array of validateResult		校正資訊。
errorType	String	clusterStatus	錯誤類型。支援： clusterStatus：叢集健康狀態 clusterConfigYml：叢集YML檔案 clusterConfigPlugins：叢集設定檔 clusterResource：叢集資源 clusterSnapshot：叢集快照
errorCode	String	ClusterStatusNotHealth	錯誤碼。
errorMsg	String	The cluster status is not health	錯誤資訊。
status	String	success	校正是否通過。支援： success：通過 failed：未通過

樣本

請求樣本

POST /openapi/instances/es-cn-n6w1o1x0w001c****/actions/upgrade-version?clientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF****&dryRun=false HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json

{
  "version" : "6.7",
  "type" : "engineVersion"
}

正常返回樣本

JSON格式

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

{
  "Result" : [ {
    "validateType" : "checkClusterHealth",
    "status" : "failed",
    "validateResult" : [ {
      "errorType" : "clusterStatus",
      "errorCode" : "ClusterStatusNotHealth",
      "errorMsg" : "ClusterStatusNotHealth"
    } ]
  }, {
    "validateType" : "checkConfigCompatible",
    "status" : "failed",
    "validateResult" : [ {
      "errorType" : "clusterConfigYml",
      "errorCode" : "ClusterYamlNotCompatible",
      "errorMsg" : "ClusterYamlNotCompatible"
    }, {
      "errorType" : "clusterConfigPlugins",
      "errorCode" : "ClusterPluginsNotSupport",
      "errorMsg" : "ClusterPluginsNotSupport"
    } ]
  }, {
    "validateType" : "checkClusterResource",
    "status" : "failed",
    "validateResult" : [ {
      "errorType" : "clusterResource",
      "errorCode" : "ClusterResourceNotEnough",
      "errorMsg" : "ClusterResourceNotEnough"
    } ]
  }, {
    "validateType" : "checkClusterSnapshot",
    "status" : "failed",
    "validateResult" : [ {
      "errorType" : "clusterSnapshot",
      "errorCode" : "ClusterSnapshotNotAvaild",
      "errorMsg" : "ClusterSnapshotNotAvaild"
    } ]
  } ],
  "RequestId" : "F99407AB-2FA9-489E-A259-40CF6DC****"
}

錯誤碼

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