帮助与文档

搜索
  • 云服务器
  • 弹性IP
  • VPC
  • CDN
  • IAM

文档中心

云服务器(KEC)

金山云 > 文档中心 > 云服务器(KEC) > API文档 > 实例

更换或者重新安装实例操作系统

最近更新时间：2019-07-26 15:34:21

ModifyInstanceImage（更换或者重新安装实例操作系统）

重新安装/更换实例的操作系统；

约束条件1： 联网增强主机重装系统，只能安装联网增强型的标准系统镜像，暂不支持自定义镜像安装；2.实例必须处于已关闭状态

Request Parameters（请求参数）

InstanceId

  • 待更换或者重新安装操作系统的实例ID
  • 类型: String
  • 有效值：标准UUID格式，形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
  • 是否可缺省: 否

ImageId

  • 待更换的镜像ID；如果缺省，表明无需改变镜像，只需重新安装实例的操作系统。
  • 类型: String
  • 有效值：标准UUID格式，形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
  • 是否可缺省: 是

SystemDisk

  • 云主机系统盘配置参数。若不指定该参数，则按照系统默认值进行分配。通用型N2、N3主机支持更换操作系统时指定系统盘大小。
  • 类型：SystemDisk
  • 是否可缺省：是

InstancePassword

  • 实例开机密码
  • 类型: String
  • 有效值：最短8字符，最长32字符，必须包含大小写英文字符和数字，支持其他可见字符
  • 是否可缺省: 是

KeyId.N

  • 密钥ID
  • 类型：String
  • 是否可缺省：是

KeepImageLogin

  • 保留镜像设置登录。该参数只对使用自定义镜像有效。当该值填写为true，默认InstancePassword参数无效。该参数与InstancePassword必须填写一个。
  • 类型：Boolean
  • 有效值：true | false
  • 默认值：false
  • 是否可以缺省：是

Response Elements（返回值）

RequestId

  • 请求ID
  • 类型: String
  • 是否可缺省: 否

Return

  • 更换或者重装实例操作系统成功与否
  • 类型: String
  • 有效值：true（成功）| false（失败）
  • 是否可缺省: 否

Examples（例子）

在cn-beijing-6这个region，为一个实例更换操作系统。

Sample Request(请求)
http://kec.cn-beijing-6.api.ksyun.com/?Action=ModifyInstanceImage&Version=2016-03-04
&InstanceId=efa35216-2fde-4e38-9b7e-2d0646f33d0f
&ImageId=8f12ad9e-ae9a-44b9-95f3-c4e65ce582e2
&InstancePassword=1qaQ!abc
Sample Response（返回）
{
  "RequestId": "7a6fa859-85e6-40ba-95d2-69deb5e43b6a",
  "Return": true
}

金山云，开启您的云计算之旅

免费注册