RebootInstance - 重啟執行個體 - Elastic Compute Service

本介面用於重啟一台ECS執行個體。

介面說明

該介面為非同步介面，執行個體的重啟不是立即完成的，成功調用後，執行個體會先進入啟動中（Starting）狀態，你可以調用 DescribeInstanceStatus 查看執行個體狀態，當返回的狀態為Running時代表重啟成功。

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作

存取層級

資源類型

條件關鍵字

關聯操作

ecs:RebootInstance

update

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

無

名稱	類型	必填	描述	樣本值
InstanceId	string	是	指定執行個體的 ID。	i-bp67acfmxazb4ph****
ForceStop	boolean	否	重啟 ECS 執行個體前，是否強制關機。取值範圍： true：強制關機。相當於典型的斷電操作，所有未寫入存放裝置的快取資料會丟失。 false：順利關機。預設值：false。	false
DryRun	boolean	否	是否只預檢此次請求。取值範圍： true：發送檢查請求，不會重啟執行個體。檢查項包括是否填寫了必選參數、請求格式、業務限制和 ECS 庫存。如果檢查不通過，則返回對應錯誤。如果檢查通過，則返回錯誤碼`DryRunOperation`。 false：發送正常請求，通過檢查後直接重啟執行個體。預設值：false。	false

正常返回樣本

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

異常返回樣本

JSON格式

{
    "RequestId": "F2E2C40D-AB09-45A1-B5C5-EB9F5C4E4E4A"
}

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	InvalidParameter.KMSKeyId.CMKUnauthorized	%s
403	InvalidParameter.KMSKeyId.CMKNotEnabled	%s
403	InvalidParameter.KMSKeyId.KMSUnauthorized	%s
404	InvalidParameter.KMSKeyId.NotFound	%s
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	指定的執行個體ID無效。
503	LimitedOperation.ServiceUnavailable	The service is currently unavailable. Please try again later.	當前服務不可用。請稍後重試。

訪問錯誤中心查看更多錯誤碼。

更多資訊，參考變更詳情。