當 ECS 執行個體收到系統事件通知時,呼叫 RedeployInstance 可以重新部署這台 ECS 執行個體。
介面說明
介面說明
RedeployInstance 為異步呼叫介面,會重新啟動並遷移執行個體。重新部署成功後,執行個體進入運行中(Running)狀態。重新部署失敗時,執行個體返回原有的實體伺服器,並恢復到重新部署前的狀態。
呼叫該介面時,您需要注意:
- 目標執行個體必須處於運行中或者已停止狀態,呼叫介面後的執行個體狀態變化:
處於運行中(
Running)的執行個體會進入停止中(Stopping)狀態。處於已停止(
Stopped)的執行個體會進入啟動中(Starting)狀態。
不支援重新部署專有宿主機上的執行個體。
被安全控制的執行個體的
OperationLocks中標記了"LockReason": "security"時,不支援重新部署。不支援回應透過 CreateSimulatedSystemEvent 建立的模擬事件。
在隔離本地磁碟的系統事件流程中,受損本地磁碟已隔離但尚未發出因系統維護計劃重新啟動並重新初始化壞盤事件(SystemMaintenance.RebootAndReInitErrorDisk)時,也可以呼叫 RedeployInstance。更多資訊,請參見本地磁碟執行個體系統事件概述。
RedeployInstance 能回應系統事件類型及事件狀態請參見下表。
| 事件名稱及參數 | 事件狀態 |
| 因系統維護執行個體重新啟動(SystemMaintenance.Reboot) | Inquiring、Scheduled |
| 因系統維護執行個體重新部署(SystemMaintenance.Redeploy) | Inquiring、Scheduled |
| 因系統維護重新啟動並更換壞盤(SystemMaintenance.RebootAndIsolateErrorDisk) | Inquiring |
| 因系統維護重新啟動並重新初始化壞盤(SystemMaintenance.RebootAndReInitErrorDisk) | Inquiring |
| 因系統錯誤執行個體重新部署(SystemFailure.Redeploy) | Inquiring |
| 僅限使用了本地磁碟的 ECS 執行個體:因系統錯誤執行個體重新啟動(SystemFailure.Reboot) | Executing |
| 因系統維護隔離壞盤(SystemMaintenance.IsolateErrorDisk) | Inquiring |
| 因系統維護重新初始化壞盤(SystemMaintenance.ReInitErrorDisk) | Inquiring |
重新部署本地磁碟執行個體會重新初始化本地磁碟,儲存裝置的資料被清空。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
ecs:RedeployInstance |
update |
*Instance
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| InstanceId |
string |
是 |
處於運行中或者已停止狀態的執行個體 ID。 |
i-bp1azkttqpldxgted**** |
| ForceStop |
boolean |
否 |
是否強制停止運行中(Running)的執行個體。 預設值:false。 說明
強制停止等同於典型的伺服器斷電關機,執行個體作業系統中暫未寫入儲存裝置的資料會丟失。建議您盡量對已停止執行個體做重新部署操作。 |
false |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| TaskId |
string |
重新部署的任務 ID。 您可以使用 DescribeTasks 介面查詢遷移結果。 |
t-bp10e8orkp8x**** |
| RequestId |
string |
請求 ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
樣本
正常返回樣本
JSON格式
{
"TaskId": "t-bp10e8orkp8x****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
異常返回樣本
JSON格式
{
"RequestId": "1C488B66-B819-4D14-8711-C4EAAA13AC01"
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 500 | InternalError | The request processing has failed due to some unknown error. | |
| 403 | IncorrectInstanceStatus | The current status of the resource does not support this operation. | |
| 403 | InstanceLockedForSecurity | The specified operation is denied as your instance is locked for security reasons. | |
| 403 | DiskError | IncorrectDiskStatus. | |
| 403 | InstanceExpiredOrInArrears | The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). | |
| 403 | InvalidOperation.RedeployInstance | %s | |
| 404 | InvalidInstanceId.NotFound | The InstanceId provided does not exist in our records. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。