实例重装系统
1. 接口描述
调用 ReInstallInstance 接口为实例更换操作系统。系统盘ID会发生变化，原系统盘会被释放。 注意：实例状态必须为已停止（STOPPED）。
2. 请求参数
| 参数名 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 固定取值：ReInstallInstance |
| RegionCode | String | 是 | 实例所属的地域编码，您可以调用 DescribeRegionConfig 查看最新的地域列表 |
| ZoneCode | String | 是 | 实例所属的可用区编码 |
| InstanceUUID | String | 是 | 实例ID |
| ImageUUID | String | 是 | 重置系统时使用的镜像ID 系统镜像，您可以调用 DescribeImageConfig 查询当前地域下的系统镜像列表 自定义镜像，您可以调用 DescribeImages 查询当前地域下的自定义镜像列表 |
| Password | String | 是 | 实例密码，8-30个字符，必须同时包含大写字母、小写字母，以及数字和特殊符号 特殊字符可以是 ()`~!@#$*-+={}[]:;,.?/ |
3. 返回数据
| 参数名 | 类型 | 说明 |
|---|---|---|
| RequestId | String | 请求ID |
4. 示例
请求示例
https://openapi.kaopuyun.com/?SignatureVersion=1.0
&Action=ReInstallInstance
&Format=JSON
&InstanceUUID=ecs-3m0000gftg8m
&SignatureNonce=fad368fd-b5e3-476b-903b-2ef34e0e9fba
&Version=2014-05-26
&AccessKeyId=hfWkfqG6a794
&Signature=IcyHYfUBWSzJauAbDaqniNSNE94=
&SignatureMethod=HMAC-SHA1
&Timestamp=2023-02-25T15:29:21Z
&RegionCode=cn-fuzhou-6
&ZoneCode=cn-fuzhou-6-a
&ImageUUID=img-xxxxxxxxx
&Password=12345678aA!
正常返回示例
{
"RequestId":"742fbe80-0ea9-11eb-9b36-0208cb7f7896"
}
5. 错误码
| 错误码 | 错误信息 |
|---|---|
| MissingParameter | RegionCode 参数不能为空 |
| MissingParameter | ZoneCode 参数不能为空 |
| MissingParameter | ImageUUID 参数不能为空 |
| MissingParameter | Password 参数不能为空 |
| AvailableInstanceNotFound | 可用实例未找到 |
| AvalibleImageNotFound | 可用镜像未找到 |
| AvalibleSystemDiskNotFound | 可用系统盘未找到 |
| AvalibleSystemDiskNumMoreThanOne | 可用系统盘超过一个 |
| IncorrectInstanceStatus | 该实例目前的状态不支持此操作 |
| IncorrectInstanceStatus.Locked | 非法实例状态--已锁定 |
| ReInstallInstanceFail | 重装实例失败:xxx |