重装实例
最近更新时间: 2024-06-18 14:31:29
1. 接口描述
接口请求域名： cvm.api3.fincloud.tencent.cn。
本接口 (ResetInstance) 用于重装指定实例上的操作系统。
- 如果指定了
ImageId参数，则使用指定的镜像重装；否则按照当前实例使用的镜像进行重装。 - 系统盘将会被格式化，并重置；请确保系统盘中无重要文件。
Linux和Windows系统互相切换时，该实例系统盘ID将发生变化，系统盘关联快照将无法回滚、恢复数据。- 密码不指定将会通过站内信下发随机密码。
- 目前只支持系统盘类型是
CLOUD_BASIC、CLOUD_PREMIUM、CLOUD_SSD类型的实例使用该接口实现Linux和Windows操作系统切换。 - 目前不支持海外地域的实例使用该接口实现
Linux和Windows操作系统切换。
默认接口请求频率限制：10次/秒。
接口更新时间：2022-10-27 11:44:11。
接口只验签名不鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：ResetInstance |
| Version | 是 | 否 | String | 公共参数，本接口取值：2017-03-12 |
| Region | 是 | 否 | String | 公共参数，详见产品支持的地域列表(TODO) |
| InstanceId | 是 | 否 | String | 此参数对外不可见。 实例ID。可通过 DescribeInstances API返回值中的 InstanceId获取。 |
| ImageId | 否 | 否 | String | 此参数对外不可见。 指定有效的镜像ID，格式形如 img-xxx。镜像类型分为四种：<br/><li>公共镜像</li><li>自定义镜像</li><li>共享镜像</li><li>服务市场镜像</li><br/>可通过以下方式获取可用的镜像ID：<br/><li>公共镜像、自定义镜像、共享镜像的镜像ID可通过登录控制台查询。</li><li>通过调用接口 DescribeImages ，取返回信息中的ImageId字段。</li> |
| SystemDisk | 否 | 否 | SystemDisk | 此参数对外不可见。 实例系统盘配置信息。系统盘为云盘的实例可以通过该参数指定重装后的系统盘大小来实现对系统盘的扩容操作，若不指定则默认系统盘大小保持不变。系统盘大小只支持扩容不支持缩容；重装只支持修改系统盘的大小，不能修改系统盘的类型。 |
| LoginSettings | 否 | 否 | LoginSettings | 此参数对外不可见。 实例登录设置。通过该参数可以设置实例的登录方式密码、密钥或保持镜像的原始登录设置。默认情况下会随机生成密码，并以站内信方式知会到用户。 |
| EnhancedService | 否 | 否 | EnhancedService | 此参数对外不可见。 增强服务。通过该参数可以指定是否开启云安全、云监控等服务。若不指定该参数，则默认开启云监控、云安全服务。 |
| DryRun | 否 | 否 | Bool | 此参数对外不可见。 是否跳过实际执行逻辑 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| TaskId | String | 此参数对外不可见。 任务Id |
| FlowId | Int64 | 此参数对外不可见。 任务流转Id |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InvalidInstanceId.NotFound | |
| InvalidInstance.NotSupported | |
| InvalidParameterValue | |
| InternalServerError | |
| InvalidInstanceId.Malformed | |
| MissingParameter | |
| InvalidImageId.NotFound |