重启实例
描述
重启指定的实例
只有状态为 Running 的实例才可以进行此操作。
接口调用成功后实例进入 Starting 状态。
支持强制重启,强制重启等同于传统服务器的断电重启,可能丢失实例操作系统中未写入磁盘的数据。
被安全控制在实例的 OperationLocks 中标记了 "LockReason" : "security" 的锁定状态时,不能重启实例。
请求参数
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
Action | String | 是 | 系统规定参数,取值:RebootInstance |
InstanceId | String | 是 | 指定实例的 ID |
ForceStop | String | 否 | 重启机器时的是否强制关机策略。取值:
如果不指定,则默认值为 false。 |
返回参数
全是公共返回参数,详见公共返回参数
错误码
错误代码 | 描述 | 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 | 该资源目前被安全锁定被拒绝操作 |
DiskError | IncorrectDiskStatus | 403 | 不正常的磁盘状态 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=RebootInstance
&InstanceId=i-instance1
&<公共请求参数>
返回示例
XML格式
F2E2C40D-AB09-45A1-B5C5-EB9F5C4E4E4A
JSON格式
{
"RequestId": "F2E2C40D-AB09-45A1-B5C5-EB9F5C4E4E4A"
}