重啟一台執行個體。

描述

  • 您只能重啟狀態為 運行中（Running）的 ECS 執行個體。
  • 重啟 ECS 執行個體後進入 啟動中（Starting）狀態。
  • 支援強制重啟（ForceStop），強制重啟等同於傳統伺服器的斷電重啟，可能丟失執行個體作業系統中未寫入磁碟的資料。
  • 被 安全控制 的 ECS 執行個體的 OperationLocks 中標記了 "LockReason" : "security" 時，不能重啟執行個體。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：RebootInstance
InstanceId String 是 指定執行個體的 ID。
ForceStop String 否 重啟 ECS 執行個體前是否強制關機策略。取值範圍：
  • true：重啟 ECS 執行個體前強制關機
  • false：重啟 ECS 執行個體前順利關機
預設值：false

返回參數

全是公共返回參數。參閱公共參數

樣本

請求樣本 
https://ecs.aliyuncs.com/?Action=RebootInstance
&InstanceId=i-instance1
&<公共請求參數>
返回樣本

XML 格式 

<RebootInstanceResponse>
    <RequestId>F2E2C40D-AB09-45A1-B5C5-EB9F5C4E4E4A</RequestId>
</RebootInstanceResponse>
JSON 格式 
{
    "RequestId": "F2E2C40D-AB09-45A1-B5C5-EB9F5C4E4E4A"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心。

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
DiskError IncorrectDiskStatus. 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 該資源目前被安全鎖定被拒絕操作。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的 InstanceId 不存在。