：StopInstance

描述

• 只有狀態為 運行中（Running）的執行個體才可以進行此操作。
• 成功調用介面後執行個體進入 停止中（Stopping） 狀態。執行個體成功停止關機後進入 已停止（Stopped）狀態。
• 支援強制停止，等同於斷電處理，可能丟失執行個體作業系統中未寫入磁碟的資料。
• 安全控制 的執行個體的 OperationLocks 中標記了 "LockReason" : "security" 的鎖定狀態時，不能停止執行個體。
• 對於配置 本地碟儲存（Local_storage） 的 I1 規格類型系列 執行個體，ConfirmStop 入參為必選，取值為 True 後介面調用才會成功，否則會返回錯誤碼。
• I1 規格類型系列執行個體，成功調用介面後，本地碟儲存上的資料將會被清空，需要通過應用程式層的資料冗餘保證資料可用性。
• 系統自動忽略其他規格類型系列執行個體的 ConfirmStop 入參。
• 開通 預設VPC內執行個體停機不收費 功能後，您可以通過設定 StoppedMode=KeepCharging 保持停機收費，ECS 執行個體停止後會繼續計費，並為您保留 ECS 執行個體規格庫存和公網 IP 位址。

請求參數

返回參數

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

樣本

https://ecs.aliyuncs.com/?Action=StopInstance
&InstanceId=i-instance1
&<公共請求參數>

<StopInstanceResponse>
    <RequestId>1C488B66-B819-4D14-8711-C4EAAA13AC01</RequestId>
</StopInstanceResponse>

{
    "RequestId": "1C488B66-B819-4D14-8711-C4EAAA13AC01"
}

錯誤碼

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