功能介紹
- 將部署在 專屬主機(jī) 上的彈性 云服務(wù)器 遷移至其他專屬主機(jī)。
- 將部署在專屬主機(jī)上的彈性云服務(wù)器 遷移 至公共資源池，即不再部署在專屬主機(jī)上。
- 將公共資源池的彈性云服務(wù)器遷移至專屬主機(jī)上，成為專屬主機(jī)上部署的彈性云服務(wù)器。
本接口為異步接口，當(dāng)前冷遷移彈性云服務(wù)器請(qǐng)求下發(fā)成功后會(huì)返回job_id，此時(shí)冷遷移彈性云服務(wù)器并沒(méi)有立即完成，需要通過(guò)調(diào)用查詢?nèi)蝿?wù)的執(zhí)行狀態(tài)查詢job狀態(tài)，當(dāng)Job狀態(tài)為 SUC CES S 時(shí)代表云服務(wù)器冷遷移成功。
接口約束
- 接口目前只適用于專屬主機(jī)使用場(chǎng)景。
- 關(guān)機(jī)狀態(tài)的彈性云服務(wù)器才能執(zhí)行冷遷移操作。
- 按需計(jì)費(fèi)方式的彈性云服務(wù)器才能執(zhí)行冷遷移操作。
- 繼承原生冷遷移接口已有的約束限制。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v1/{project_id}/cloudservers/{server_id}/migrate
參數(shù)說(shuō)明請(qǐng)參見(jiàn)表1。
|
參數(shù) |
是否必選 |
描述 |
|---|---|---|
|
project_id |
是 |
項(xiàng)目ID。 獲取方法請(qǐng)參見(jiàn)獲取項(xiàng)目ID。 |
|
server_id |
是 |
云服務(wù)器ID。 |
請(qǐng)求消息
請(qǐng)求參數(shù)如表2所示。
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
migrate |
是 |
Object |
遷移云服務(wù)器，詳情請(qǐng)參見(jiàn)表3。 將彈性云服務(wù)器從專屬 主機(jī)遷移 至公共資源池時(shí)，migrate字段值為null。 |
響應(yīng)消息
請(qǐng)參考響應(yīng)（任務(wù)類）。
請(qǐng)求示例
遷移公共資源池的云服務(wù)器遷移至ID為“459a2b9d-804a-4745-ab19-a113bb1b4ddc”的專屬主機(jī)。
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/migrate
{
"migrate": {
"dedicated_host_id": "459a2b9d-804a-4745-ab19-a113bb1b4ddc"
}
}
響應(yīng)示例
{
"job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}
返回值
請(qǐng)參考通用請(qǐng)求返回值。
錯(cuò)誤碼
請(qǐng)參考錯(cuò)誤碼。
猜你喜歡
