重启一台实例。

描述

  • 您只能重启状态为 运行中Running)的 ECS 实例。
  • 重启 ECS 实例后进入 启动中Starting)状态。
  • 支持强制重启(ForceStop),强制重启等同于传统服务器的断电重启,可能丢失实例操作系统中未写入磁盘的数据。
  • 安全控制 的 ECS 实例的 OperationLocks 中标记了 "LockReason" : "security" 时,不能重启实例。

调试

前往【API Explorer】在线调试,API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力,能显著降低使用云 API 的难度,强烈推荐使用。

请求参数

名称 类型 是否必选 示例值 描述
InstanceId String i-instance1

指定实例的 ID。

Action String RebootInstance

系统规定参数。取值:RebootInstance

ForceStop Boolean false

重启 ECS 实例前是否强制关机策略。取值范围:

  • true:重启 ECS 实例前强制关机
  • false(默认):重启 ECS 实例前正常关机
OwnerAccount String ECSforCloud@Alibaba.com

RAM用户的账号登录名称。

返回参数

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求 ID。无论调用接口成功与否,我们都会返回请求 ID。

示例

请求示例


https://ecs.aliyuncs.com/?Action=RebootInstance
&InstanceId=i-instance1
&ForceStop=false
&<公共请求参数>

正常返回示例

XML 格式

<RebootInstanceResponse>
  <RequestId>F2E2C40D-AB09-45A1-B5C5-EB9F5C4E4E4A</RequestId>
</RebootInstanceResponse>

JSON 格式

{
	"RequestId":"F2E2C40D-AB09-45A1-B5C5-EB9F5C4E4E4A"
}

错误码

HttpCode 错误码 错误信息 描述
403 InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). 包年包月实例已过期,请您续费后再进行操作。
403 IncorrectInstanceStatus %s 实例当前的状态不支持该操作。

查看本产品错误码