調用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 | 返回結果:
|
樣本
請求樣本
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****"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。