当ECS实例收到系统事件通知时,调用RedeployInstance可以重新部署这台ECS实例。
接口说明
接口说明
RedeployInstance 为异步调用接口,会重启并迁移实例。重新部署成功后,实例进入运行中(Running)状态。重新部署失败时,实例返回原有的物理服务器,并恢复到重新部署前的状态。
调用该接口时,您需要注意:
- 目标实例必须处于运行中或者已停止状态,调用接口后的实例状态变化:
处于运行中(
Running)的实例会进入停止中(Stopping)状态。处于已停止(
Stopped)的实例会进入启动中(Starting)状态。
不支持重新部署专有宿主机上的实例。
被安全控制的实例的
OperationLocks中标记了"LockReason": "security"时,不支持重新部署。不支持响应通过 CreateSimulatedSystemEvent 创建的模拟事件。
在隔离本地盘的系统事件流程中,受损本地盘已隔离但尚未发出因系统维护计划重启并重新初始化坏盘事件(SystemMaintenance.RebootAndReInitErrorDisk)时,也可以调用 RedeployInstance。更多信息,请参见本地盘实例系统事件概述。
RedeployInstance 能响应系统事件类型及事件状态请参见下表。
| 事件名称及参数 | 事件状态 |
| 因系统维护实例重启(SystemMaintenance.Reboot) | Inquiring、Scheduled |
| 因系统维护实例重新部署(SystemMaintenance.Redeploy) | Inquiring、Scheduled |
| 因系统维护重启并更换坏盘(SystemMaintenance.RebootAndIsolateErrorDisk) | Inquiring |
| 因系统维护重启并重新初始化坏盘(SystemMaintenance.RebootAndReInitErrorDisk) | Inquiring |
| 因系统错误实例重新部署(SystemFailure.Redeploy) | Inquiring |
| 仅限使用了本地盘的 ECS 实例:因系统错误实例重新启动(SystemFailure.Reboot) | Executing |
| 因系统维护隔离坏盘(SystemMaintenance.IsolateErrorDisk) | Inquiring |
| 因系统维护重新初始化坏盘(SystemMaintenance.ReInitErrorDisk) | Inquiring |
重新部署本地盘实例会重新初始化本地盘,存储设备的数据被清空。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ecs:RedeployInstance |
update |
*Instance
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| InstanceId |
string |
是 |
处于运行中或者已停止状态的实例 ID。 |
i-bp1azkttqpldxgted**** |
| ForceStop |
boolean |
否 |
是否强制停止运行中(Running)的实例。 默认值:false。 说明
强制停止等同于典型的服务器断电关机,实例操作系统中暂未写入存储设备的数据会丢失。建议您尽量对已停止实例做重新部署操作。 |
false |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| TaskId |
string |
重新部署的任务 ID。 您可以使用 DescribeTasks 接口查询迁移结果。 |
t-bp10e8orkp8x**** |
| RequestId |
string |
请求 ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
示例
正常返回示例
JSON格式
{
"TaskId": "t-bp10e8orkp8x****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
异常返回示例
JSON格式
{
"RequestId": "1C488B66-B819-4D14-8711-C4EAAA13AC01"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 500 | InternalError | The request processing has failed due to some unknown error. | |
| 403 | 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 | InstanceExpiredOrInArrears | The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). | |
| 403 | InvalidOperation.RedeployInstance | %s | 操作无效。 |
| 404 | InvalidInstanceId.NotFound | The InstanceId provided does not exist in our records. |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。