重装系统 - ReinstallUHostInstance
简介
重新安装指定UHost实例的操作系统
ℹ️ 1.请确认在重新安装之前，该实例已被关闭； 2.将原系统重装为不同类型的系统时(Linux->Windows)，不可选择保留数据盘； 3.重装不同版本的系统时(CentOS6->CentOS7)，若选择保留数据盘，请注意数据盘的文件系统格式；
定义
公共参数
| 参数名 | 类型 | 描述信息 | 必填 |
|---|---|---|---|
| Action | string | 对应的 API 指令名称，当前 API 为 ReinstallUHostInstance | Yes |
| PublicKey | string | 用户公钥，可从 控制台 获取 | Yes |
| Signature | string | 根据公钥及 API 指令生成的用户签名，参见 签名算法 | Yes |
请求参数
| 参数名 | 类型 | 描述信息 | 必填 |
|---|---|---|---|
| Region | string | 地域。 参见 地域和可用区列表 | Yes |
| Zone | string | 可用区。参见 可用区列表 | No |
| ProjectId | string | 项目ID。不填写为默认项目，子帐号必须填写。 请参考GetProjectList接口 | No |
| UHostId | string | UHost实例资源ID 参见 DescribeUHostInstance | Yes |
| Password | string | 如果重装UHost实例时LoginMode为Password，则必须填写，如果LoginMode为KeyPair，不需要填写 （密码格式使用BASE64编码；举例如下：# echo -n Password1 | base64UGFzc3dvcmQx。） | No |
| ImageId | string | 镜像Id，默认使用原镜像 参见 DescribeImage | No |
| ReserveDisk | string | 是否保留数据盘，保留：Yes，不报留：No， 默认：Yes；如果是从Windows重装为Linux或反之，则无法保留数据盘（该参数目前仅对本地数据盘起作用） | No |
| BootDiskSpace | int | 系统盘大小。 单位：GB， 范围[20,100]， 步长：10 | No |
| UserData | string | cloudinit初始化使用。注意：1、总数据量大小不超多16K 2、使用base64编码 | No |
| AutoDataDiskInit | string | 数据盘是否需要自动分区挂载。当镜像支持Cloud-init Feature时可填写此字段。取值“On”（默认值）， “Off” | No |
| LoginMode | string | 主机登陆模式。密码（默认选项）: Password，密钥 KeyPair。 | No |
| KeyPairId | string | KeypairId 密钥对ID，LoginMode为KeyPair时此项必须。 | No |
响应字段
| 字段名 | 类型 | 描述信息 | 必填 |
|---|---|---|---|
| RetCode | int | 返回状态码，为 0 则为成功返回，非 0 为失败 | Yes |
| Action | string | 操作指令名称 | Yes |
| Message | string | 返回错误消息，当 RetCode 非 0 时提供详细的描述信息 | No |
| UHostId | string | UHost实例资源ID | No |
示例
请求示例
https://api.tnqacloud.com/?Action=ReinstallUHostInstance
&Region=cn-bj2
&Zone=cn-bj2-04
&ProjectId=org-xxx
&UHostId=uhost-xxx
&Password=xxx
&BootDiskSpace=6
&UserData=TdFuRmBV
&AutoDataDiskInit=LpCzTmbU
&LoginMode=yOknHzpM
&KeyPairId=KfXBMRLJ
&KeyPairId=qqNpnbqV响应示例
{
"Action": "ReinstallUHostInstanceResponse",
"RetCode": 0,
"UHostId": "uhost-xxx"
}