调用 RebootInstance 接口重启一台实例。
只有处于 运行中 状态的实例,才支持重启操作。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | RebootInstance | 要执行的操作,取值:RebootInstance。 |
Version | String | 是 | 2020-04-01 | API的版本,取值:2020-04-01。 |
ForceStop | Boolean | 否 | false | 重启实例前是否强制关机,取值:
说明 以下类型的实例,
|
ClientToken | String | 否 | 333456899ff**** | 保证请求幂等性。由客户端自动生成一个参数值,确保不同请求间该参数值唯一,避免当调用API超时或服务器内部错误时,客户端多次重试导致重复性操作。 |
DryRun | Boolean | 否 | false | 是否只预检此次请求。
|
InstanceId | String | 是 | i-3tiefmkskq3vj0x0**** | 实例ID。 |
本接口无特有的返回参数。更多信息请见返回结构。
GET /?Action=RebootInstance&Version=2020-04-01&InstanceId=i-3tiefmkskq3vj0****** HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing Service: ecs
{ "ResponseMetadata": { "RequestId": "20210623195036010225145152013****", "Action": "RebootInstance", "Version": "2020-04-01", "Service": "ecs", "Region": "cn-beijing" }, "Result": {} }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 说明 |
---|---|---|
400 | InvalidArgument | 指定的参数不合法。 |
400 | InvalidInstanceStatus | 当前实例的状态不支持此操作。 |
400 | MissingParameter.InstanceId | 参数实例ID不能为空。 |
400 | IdempotentParameterMismatch | 幂等参数不一致。 |
400 | Insufficient.Balance | 账户余额不足。 |
400 | InvalidClientToken.Malformed | 指定的ClientToken不合法。 |
400 | InvalidDedicatedHostStatus.Unsupported | 当前专有宿主机的状态不支持此操作。 |
403 | InvalidInstance.RequestForbidden | 由于您的火山引擎账户违反了相关规定,指定的资源已不再可以使用,如需恢复服务请提交工单联系服务人员处理。 |
404 | InvalidInstance.NotFound | 指定的实例不存在。 |
412 | OperationDenied.ResourceCreatedByOtherService | 指定的操作被拒绝,因为您的资源被其他服务创建。您可以通过资源的系统标签查询对应服务。 |
412 | OperationDenied.ResourceLocked | 指定的操作被拒绝,因为您的资源已被其他操作锁定。 |
412 | DryRunOperation | 通过“DryRun”校验,您的请求已通过验证。 |
412 | IdempotentProcessing | 先前的幂等请求仍在处理中,请稍后重试。 |
412 | OperationDenied.InstanceIsCreatingImage | 指定的操作被拒绝,因为该实例正在创建自定义镜像。 |
500 | InternalError | 内部错误,请重试。如果多次尝试失败,请提交工单。 |