閱讀228 返回首頁    go 阿裏雲 go 技術社區[雲棲]

停止實例__實例相關接口_API 參考_雲服務器 ECS-阿裏雲

描述

停止一個指定的實例。

  • 隻有狀態為 Running 的實例才可以進行此操作。
  • 接口調用成功後實例進入 Stopping 狀態。係統後台會在實例實際 Stop 成功後進入 Stopped 狀態。
  • 實例支持強製停止，強製停止等同於斷電處理，可能丟失實例操作係統中未寫入磁盤的數據。
  • 被安全控製在實例的 OperationLocks 中標記了 "LockReason" : "security" 的鎖定狀態時，不能停止實例。

請求參數

名稱 類型 是否必須 描述
Action String 是 係統規定參數，取值：StopInstance
InstanceId String 是 指定的實例 ID
ForceStop String 否 重啟機器時的是否強製關機策略。取值：
  • true
  • false
默認值為 false。
若為 false 則走正常關機流程；若為 true 則強製關機。

返回參數

全是公共返回參數，詳見公共返回參數

錯誤碼

錯誤代碼 描述 Http 狀態碼 語義
InvalidInstanceId.NotFound The InstanceId provided does not exist in our records. 404 指定的 InstanceId 不存在
MissingParameter The input parameter "InstanceId" that is mandatory for processing this request is not supplied. 400 缺少 InstanceId 值
InvalidParameter The specified parameter "ForceStop" is not valid. 400 指定的 ForceStop 不合法，（不在枚舉範圍內）
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 該資源目前被安全鎖定被拒絕操作

示例

請求示例

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

返回示例

XML格式

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

JSON格式

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

最後更新：2016-11-23 16:03:50

  上一篇：go 啟動實例__實例相關接口_API 參考_雲服務器 ECS-阿裏雲
  下一篇：go 修改實例屬性__實例相關接口_API 參考_雲服務器 ECS-阿裏雲