當(dāng)ECS實例收到系統(tǒng)事件通知時,調(diào)用RedeployInstance可以重新部署這臺ECS實例。
接口說明
RedeployInstance 為異步調(diào)用接口,會重啟并遷移實例。重新部署成功后,實例進(jìn)入運行中(Running
)狀態(tài)。重新部署失敗時,實例返回原有的物理服務(wù)器,并恢復(fù)到重新部署前的狀態(tài)。
調(diào)用該接口時,您需要注意:
- 目標(biāo)實例必須處于運行中或者已停止?fàn)顟B(tài),調(diào)用接口后的實例狀態(tài)變化:
- 處于運行中(
Running
)的實例會進(jìn)入停止中(Stopping
)狀態(tài)。 - 處于已停止(
Stopped
)的實例會進(jìn)入啟動中(Starting
)狀態(tài)。
- 處于運行中(
- 不支持重新部署專有宿主機上的實例。
- 被安全控制的實例的
OperationLocks
中標(biāo)記了"LockReason": "security"
時,不支持重新部署。 - 不支持響應(yīng)通過 CreateSimulatedSystemEvent 創(chuàng)建的模擬事件。
- 在隔離本地盤的系統(tǒng)事件流程中,受損本地盤已隔離但尚未發(fā)出因系統(tǒng)維護計劃重啟并重新初始化壞盤事件(SystemMaintenance.RebootAndReInitErrorDisk)時,也可以調(diào)用 RedeployInstance。更多詳情,請參見本地盤實例系統(tǒng)事件概述。
RedeployInstance 能響應(yīng)系統(tǒng)事件類型及事件狀態(tài)請參見下表。
事件名稱及參數(shù) | 事件狀態(tài) |
---|---|
因系統(tǒng)維護實例重啟(SystemMaintenance.Reboot) | Inquiring、Scheduled |
因系統(tǒng)維護實例重新部署(SystemMaintenance.Redeploy) | Inquiring、Scheduled |
因系統(tǒng)維護重啟并更換壞盤(SystemMaintenance.RebootAndIsolateErrorDisk) | Inquiring |
因系統(tǒng)維護重啟并重新初始化壞盤(SystemMaintenance.RebootAndReInitErrorDisk) | Inquiring |
因系統(tǒng)錯誤實例重新部署(SystemFailure.Redeploy) | Inquiring、Scheduled |
僅限使用了本地盤的 ECS 實例:因系統(tǒng)錯誤實例重新啟動(SystemFailure.Reboot) | Executing |
因系統(tǒng)維護隔離壞盤(SystemMaintenance.IsolateErrorDisk) | Inquiring |
因系統(tǒng)維護重新初始化壞盤(SystemMaintenance.ReInitErrorDisk) | Inquiring |
說明
重新部署本地盤實例會重新初始化本地盤,存儲設(shè)備的數(shù)據(jù)被清空。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
當(dāng)前API暫無授權(quán)信息透出。
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
InstanceId | string | 是 | 處于運行中或者已停止?fàn)顟B(tài)的實例 ID。 | i-bp1azkttqpldxgted**** |
ForceStop | boolean | 否 | 是否強制停止運行中(Running)的實例。 默認(rèn)值:false 說明
強制停止等同于典型的服務(wù)器斷電關(guān)機,實例操作系統(tǒng)中暫未寫入存儲設(shè)備的數(shù)據(jù)會丟失。建議您盡量對已停止實例做重新部署操作。
| false |
返回參數(shù)
示例
正常返回示例
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. | 該資源目前的狀態(tài)不支持此操作。 |
403 | InstanceLockedForSecurity | The specified operation is denied as your instance is locked for security reasons. | 實例被安全鎖定。 |
403 | DiskError | IncorrectDiskStatus. | 指定的磁盤狀態(tài)不合法。 |
403 | InstanceExpiredOrInArrears | The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). | 實例已過期或者欠費,請您續(xù)費或者結(jié)清后再進(jìn)行操作。 |
403 | IncorrectInstanceStatus | %s | 當(dāng)前實例的狀態(tài)不支持此操作。 |
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. | 內(nèi)部錯誤,請重試。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內(nèi)容概要 | 操作 |
---|
暫無變更歷史