调用StopInstance停止运行一台实例。

使用说明

  • 只有状态为运行中（Running）的实例才可以进行此操作。
  • 成功调用接口后实例进入停止中（Stopping）状态。
  • 实例成功停止关机后进入已停止（Stopped）状态。
  • 支持强制停止，等同于断电处理，可能丢失实例操作系统中未写入磁盘的数据。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Version String 是 2017-11-10

版本号。
Action String 是 StopInstance

系统规定参数。取值：StopInstance。

InstanceId String 是 i-instanceid****

要停止运行的实例的ID，仅支持停止单个。
ForceStop String 否 true

停止实例时是否强制关机策略。

  • true：强制关机。
  • false（默认）：正常关机流程。

返回数据

名称 类型 示例值 描述
Code Integer 0

返回的业务码，正常成功为0。
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例

http(s)://ens.aliyuncs.com/?Version=2017-11-10
&Action=StopInstance
&InstanceId=i-instanceid****
&ForceStop=true
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<StopInstanceResponse>
    <Code>0</Code>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</StopInstanceResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode 错误码 错误信息 描述
400 NoPermission Permission denied. 没有足够的权限，请联系云账号管理员授予您相应权限。
400 CallInterface Call Inteface Happen Error. 接口调用出错。

访问错误中心查看更多错误码。