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"
}

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
403	OperationDenied.KMSKeyUnauthorized	The operation is denied due to missing KMS key authorization. Please check the KMS key permissions and ensure the key is properly authorized for this operation.
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.	目前服務不可用。請稍後重試。

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

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