全部產品
Search
文件中心

Elasticsearch:MigrateToOtherZone

更新時間:Jan 16, 2025

調用MigrateToOtherZone,遷移對應可用性區域下的節點到目標可用性區域。

當您升配執行個體,遇到可用性區域規格庫存不足的問題時,可以通過遷移可用性區域節點來解決。在調用此介面前,需要確保:

  • 當前帳號存在資源充足的可用性區域。

    在遷移當前規格的節點到其他可用性區域後,需手動升配叢集,並不會在遷移過程中升配叢集,因此要選擇資源充足的可用性區域,避免叢集升配失敗。建議優先選擇字母順序靠後的新可用性區域(例如對於cn-hangzhou-e和cn-hangzhou-h可用性區域,優先選擇cn-hangzhou-h)。

  • 叢集處於健康狀態。

    可通過GET _cat/health?v命令查看叢集健康狀態。

調試

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

要求標頭

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

請求文法

POST /openapi/instances/[InstanceId]/actions/migrate-zones HTTP/1.1

請求參數

名稱 類型 位置 是否必選 樣本值 描述
dryRun Boolean Query false

校正是否可以進行可用性區域節點遷移。true表示只校正不執行遷移任務;false表示校正通過後即進行遷移任務。

InstanceId String Path es-cn-n6w1o1x0w001c****

執行個體ID。

RequestBody

RequestBody中還需填入以下參數,用來指定遷移的可用性區域資訊。

名稱

類型

是否必選

樣本值

描述

fromZoneId

String

cn-hangzhou-i

執行個體目前所在的可用性區域。

toZoneId

String

cn-hangzhou-b

遷移到的目標可用性區域。

toVswitchId

String

vsw-bp1f7r0ma00pf9h2l****

虛擬交換器ID。

樣本如下。


{
    "fromZoneId": "cn-hangzhou-e",
    "toZoneId": "cn-hangzhou-f",
    "toVswitchId": "vsw-bp16t5hpc689dgkgc****"
}

返回資料

名稱 類型 樣本值 描述
RequestId String 5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****

請求ID。

Result Boolean true

返回結果:

  • true:遷移成功
  • false:遷移失敗

樣本

請求樣本

POST /openapi/instances/es-cn-n6w1o1x0w001c****/actions/migrate-zones?dryRun=false HTTP/1.1
公用要求標頭
{
    "fromZoneId": "cn-hangzhou-e",
    "toZoneId": "cn-hangzhou-f",
    "toVswitchId": "vsw-bp16t5hpc689dgkgc****"
}

正常返回樣本

JSON格式

{
	"Result": true,
	"RequestId": "24A77388-9444-49A3-A1CF-F48385E5****"
}

錯誤碼

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