當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、Scheduled |
| 僅限使用了本地盤的 ECS 實例：因系統錯誤實例重新啟動（SystemFailure.Reboot） | Executing |
| 因系統維護隔離壞盤（SystemMaintenance.IsolateErrorDisk） | Inquiring |
| 因系統維護重新初始化壞盤（SystemMaintenance.ReInitErrorDisk） | Inquiring |
說明
重新部署本地盤實例會重新初始化本地盤，存儲設備的數據被清空。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
當前API暫無授權信息透出。
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| InstanceId | string | 是 | 處于運行中或者已停止狀態的實例 ID。 | i-bp1azkttqpldxgted**** |
| ForceStop | boolean | 否 | 是否強制停止運行中（Running）的實例。 默認值：false 說明
強制停止等同于典型的服務器斷電關機，實例操作系統中暫未寫入存儲設備的數據會丟失。建議您盡量對已停止實例做重新部署操作。
| false |
返回參數
示例
正常返回示例
JSON格式
{
"TaskId": "t-bp10e8orkp8x****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 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 | IncorrectInstanceStatus | %s | 當前實例的狀態不支持此操作。 |
| 403 | InvalidOperation.RedeployInstance | %s | 操作無效。 |
| 404 | InvalidInstanceId.NotFound | The InstanceId provided does not exist in our records. | 指定的實例不存在，請您檢查實例 ID 是否正確。 |
| 500 | InternalError | The request processing has failed due to some unknown error. | 內部錯誤，請重試。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|
暫無變更歷史