調用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****"
}

錯誤碼

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