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

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String StopInstance

系统规定参数。取值:StopInstance

InstanceId String i-instanceid1

要停止运行的实例的ID。

Version String 2017-11-10

版本号。

ForceStop String true

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

  • true:强制关机。
  • false(默认):正常关机流程。

返回数据

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

返回的业务码,正常成功为0。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例

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

正常返回示例

XML 格式

<StopInstanceResponse>
  <RequestId>C0003E8B-B930-4F59-ADC0-0E20xxxxxxxx</RequestId>
  <code>0</code>
</StopInstanceResponse>

JSON 格式

{
	"RequestId":"C0003E8B-B930-4F59-ADC0-0E20xxxxxxxx",
	"code":"0"
}

错误码

HttpCode 错误码 错误信息 描述
400 NoPermission Permission denied. 没有足够的权限,请联系云账号管理员授予您相应权限。

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