参数名称 | 类型 | 必填 | 描述 |
|---|
| Action | String | 是 | 公共参数，本接口取值：ModifyInstanceImage。 |
| Version | String | 是 | 公共参数，本接口取值：2016-03-04。 |
| InstanceId | String | 是 | 待更换或者重新安装操作系统的实例ID
标准UUID格式，形如 示例值：98284100-f6d1-4bbf-886a-1b0765024738 |
| ImageId | String | 否 | 待更换的镜像ID；如果缺省，表明无需改变镜像，只需重新安装实例的操作系统。
标准UUID格式，形如 示例值：8f12ad9e-ae9a-44b9-95f3-c4e65ce582e2 |
| SystemDisk.DiskSize | Int | 否 | 云主机系统盘配置参数。若不指定该参数，则按照系统默认值进行分配。通用型N2、N3主机支持更换操作系统时指定系统盘大小。 示例值：- |
| InstancePassword | String | 否 | 实例开机密码 示例值：1qaQ!abc |
| KeyId.N | String | 否 | 密钥ID 示例值：552a0523-b9b4-4868-b8d9-52ad7a38bf89 |
| KeepImageLogin | Boolean | 否 | 保留镜像设置登录。该参数只对使用自定义镜像有效。当该值填写为true，默认InstancePassword参数无效。该参数与InstancePassword必须填写一个。 true/false,默认false 示例值：true |
| SystemDisk.DiskType | String | 否 | 不能给默认值，不传默认按价格体系配置systemDisk属性中第一个创建 |
| SystemDisk.ResizeType | String | 否 | 扩容 offline 离线扩容| online 在线扩容 |
| UserData | String | 否 | 用户自定义数据，必须是base64编码 |
参数名称 | 类型 | 描述 |
|---|
| RequestId | String | 请求ID 示例值：- |
| Return | Boolean | 更换或者重装实例操作系统成功与否 示例值：true（成功）/false（失败） |
JSON格式
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码
错误码 | 错误信息 | Http状态码 | 描述 |
|---|
| InstanceNotFound | 暂无 | 400 | 暂无 |
| ProductSellOutInvalid | product already sell out. | 400 | 此商品在该机房已售罄. |
| ImageTypeMismatching | Foreign region image type mismatching | 400 | 海外机房镜像类型不同不支持重装 |
| GoSDKVersionInvalid | Your GoSDK Version is deprecated for ModifyInstanceImage action, please upgrade your GoSDK to 0.1.29 or Terraform to Version 1.3.26 or later. | 400 | 您的GoSDK版本过低，请升级GoSDK版本到0.1.29 或者升级Terraform版本到1.3.26 |
| ImageTypeNotSupportedKeyLogin | The ImageType for this not supported KeyLogin | 400 | 该镜像类型不支持密钥登录 |
| OperationDenied.SpotInstance | The operation is not permitted due to charge type of the instance. | 400 | 竞价实例计费方式不允许该操作. |
| LocalImageOnlySupportSSD3ForModifyImage | Only support instances which the system disk is SSD3.0 using local mirroring to reinstall the system. | 400 | 仅支持系统盘为ssd3.0的实例使用本地镜像重装系统 |
| RootDiskGbInvalidParameterValue | An invalid or out-of-range value was supplied for the "RootDiskGb" parameter. | 400 | “系统卷容量”参数的取值无效或者超出有效范围 |
| ImageIdInvalidParameterValue | An invalid or out-of-range value was supplied for the "ImageId" parameter. | 400 | “镜像ID”参数的取值无效或者超出有效范围 |
| InternalError | 暂无 | 400 | 暂无 |
| ImageHaveInvalidZone | The specified local mirror is not in the zone. | 400 | 指定的镜像不在此区域内 |
| SubOrderBindedInstance | subOrder already bound instance | 400 | 子订单已经绑定实例 |
| InstanceStateNotSupported | The InstanceState for this action should be "Stopped" | 400 | 本操作执行时“实例状态”应该是“关闭” |
| AssembledImageNotSupportReinstallSystem | You cannot reinstall the system by using an image that contains a data disk snapshot. | 400 | 重装系统不支持包含数据盘快照的镜像 |
| KeyIdInvalidParameterValue | An invalid or out-of-range value was supplied for the "KeyId" parameter. | 400 | “KEYID”参数的取值无效或者超出有效范围 |
| Payment.OrderNotFound | order not found | 400 | 实例对应的订单不存在 |
| InstanceStateNotSupportedMigrate | The current status of the resource does not support this operation. | 400 | 本操作执行时“实例状态”不支持 |
| HostNameInvalidParameterValue | An invalid or out-of-range value was supplied for the "HostName" parameter. | 400 | “主机操作系统名称”参数的取值无效或者超出有效范围 |
| LocalVolumeRollBackImageTypeMismatching | System disk snapshot does not support rollback across operating system versions. | 400 | 系统盘快照不支持跨操作系统版本回滚. |
| InvalidParameter.InstanceKeyLimitExceeded | InvalidParameter.InstanceKeyLimitExceeded | 400 | 每台云服务器最多10个密钥对 |
| RockyLinuxOnlySupport2048ForRsaKey | The specified image only support RSA 2048 bit key pair. | 400 | 该镜像类型仅支持RSA 2048位的密钥 |
| ServiceUnavailable | {"RequestId":"7f30b545-dc1b-40dc-9b76-eeca28393989002","Error":{"Code":"ServiceUnavailable","Message":"I/O error on POST request for \"http://qdone.openstack.sdns.ksyun.com:6004/v2/8e7be2f85d47444c82f0268b40e7b1e1/os-ksc-resources/check\": connect timed out"}} | 400 |
纯净模式
