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

最近更新时间:2021-09-30 19:56:55

查看PDF

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

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

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

Request Parameters(请求参数)

名称 类型 是否可缺省 示例值 有效值 描述
Action String ModifyInstanceImage - 系统规定参数。取值:ModifyInstanceImage
InstanceId String 98284100-f6d1-4bbf-886a-1b0765024738 标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 待更换或者重新安装操作系统的实例ID
ImageId String 8f12ad9e-ae9a-44b9-95f3-c4e65ce582e2 标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 待更换的镜像ID;如果缺省,表明无需改变镜像,只需重新安装实例的操作系统。
SystemDisk String - SystemDisk 云主机系统盘配置参数。若不指定该参数,则按照系统默认值进行分配。通用型N2、N3主机支持更换操作系统时指定系统盘大小。
InstancePassword String 1qaQ!abc 最短8字符,最长32字符,必须包含大小写英文字符和数字,支持其他可见字符 实例开机密码
KeyId.N String 552a0523-b9b4-4868-b8d9-52ad7a38bf89 - 密钥ID
KeepImageLogin Boolean true true/false,默认false 保留镜像设置登录。该参数只对使用自定义镜像有效。当该值填写为true,默认InstancePassword参数无效。该参数与InstancePassword必须填写一个。

Response Elements(返回值)

名称 类型 是否可缺省 示例值 有效值 描述
RequestId String 98284100-f6d1-4bbf-886a-1b0765024738 - 请求ID
Return Boolean true true(成功)/false(失败) 更换或者重装实例操作系统成功与否

Examples(例子)

例1:在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
}

例2:在cn-beijing-6这个region,为一个实例更换操作系统并设置密钥。

Sample Request(请求)
http://kec.cn-beijing-6.api.ksyun.com/?Action=ModifyInstanceImage
&Version=2016-03-04
&InstanceId=ee96d64b-d42f-4a43-bbc1-27a683b88b6a
&ImageId=992bfaf8-8ca0-4fd6-9ec0-06062b822476
&KeyId.1=552a0523-b9b4-4868-b8d9-52ad7a38bf89
&KeyId.2=2685c9be-fffd-4c50-bc58-e6f5967c53e5
Sample Response(返回)
{
    <RequestId>8355b628-c1b5-4031-9205-cc5525dda1b6022</RequestId>
    <Return>true</Return>
}

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

内容不全,不深入
内容更新不及时
描述不清晰,比较混乱
系统或功能太复杂,缺乏足够的引导
内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈