文档中心

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}$
  • 是否可缺省: 是

InstancePassword

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

Response Elements(返回值)

RequestId

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

Return

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

Examples(例子)

在默认region,为一个实例更换操作系统

Sample Request(请求)
http://kec.api.ksyun.com/?Action=ModifyInstanceImage&Version=2016-03-04
&InstanceId=efa35216-2fde-4e38-9b7e-2d0646f33d0f
&ImageId=8f12ad9e-ae9a-44b9-95f3-c4e65ce582e2
&InstancePassword=1qaQ!abc
&AUTHPARAMS
Sample Response(返回)
<?xml version="1.0" encoding="UTF-8"?>
<ModifyInstanceImageResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <Return>true</Return>
    <RequestId>09bbe322-a83b-4fc4-8178-39062c7a6c10</RequestId>
</ModifyInstanceImageResponse>