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

最近更新时间:2018-12-10 11:40:11

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

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

约束条件1: 联网增强主机重装系统,只能安装联网增强型的标准系统镜像,暂不支持自定义镜像安装;

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字符,必须包含大小写英文字符和数字,支持其他可见字符
  • 是否可缺省: 是

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
}

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

立即注册