1. 重启云服务器
本接口用于重启一台云服务器。
- 只有状态为 Running 的云服务器才可以进行此操作。
- 接口调用成功时，云服务器会进入 Rebooting 状态；重启云服务器成功后，会进入 Running 状态。
- 接口支持强制重启。强制重启的效果等同于关闭物理计算机的电源开关再重新启动。强制重启可能会导致数据丢失或文件系统损坏，请仅在服务器不能正常重启时使用。
- 本接口暂未支持批量操作。
1.1. 接口说明
本接口所属服务类型为 ecs
本接口操作类型为 RebootInstances
1.1.1. 请求路径
POST {baseUrl}/v3/ecs/RebootInstances1.1.2. 请求体
{
"zoneCode": "cn-zhongwei-a",
"ecsUuids": ["1d393df7-5ef0-4123-bf44-d2f953efae5e"],
"stopType": "SOFT"
}请求体内容说明
| 属性名 | 属性类型 | 是否必须 | 默认值 | 说明 |
|---|---|---|---|---|
| zoneCode | String | 是 | 无 | 可用区编码 |
| ecsUuids | Array | 是 | 无 | 待重启云服务器 UUID 列表 |
| stopType | String | 否 | SOFT | 关机类型。取值范围：默认SOFT 表示软关机；HARD 表示强制关机 |
1.1.3. 返回内容
{
"code": 200,
"message": "重启成功",
"data": [
{
"jobUuid": "c587e4a5ffdb4a1eb866bc21caee8059",
"success": false,
"progress": 0.0,
"type": "RebootECS",
"done": false,
"resourceUuid": "1d393df7-5ef0-4123-bf44-d2f953efae5e"
}
]
}返回内容说明
| 属性名 | 属性类型 | 说明 |
|---|---|---|
| code | Integer | 返回码。正常返回 200，异常返回500或其他业务错误码 |
| message | String | 返回信息 |
| data | Array | 异步任务进度信息 |
异步任务进度信息
| 属性名 | 属性类型 | 说明 |
|---|---|---|
| jobUuid | String | 异步任务唯一编码 |
| success | Boolean | 异步任务是否执行成功 |
| progress | Double | 异步任务执行进度。0-100% |
| type | String | 异步任务类型 |
| done | Boolean | 异步任务是否执行完成 |
| resourceUuid | String | 异步任务所处理的资源 Uuid |
异步任务执行状态详见异步任务。
1.2. 应用场景举例
1.2.1. 强制重启云服务器
强制重启云服务器是在正常重启无法完成的前提下提供的一种重启机制，有丢失数据风险。
请求参数为
{
"zoneCode": "cn-zhongwei-a",
"ecsUuids": ["1d393df7-5ef0-4123-bf44-d2f953efae5e"],
"stopType":"HARD"
}