全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
云服务器 ECS

ReplaceSystemDisk

更新时间:2017-11-20 16:36:03

描述

更换 ECS 实例的系统盘。您可以通过更换系统盘更换 ECS 实例的操作系统。

使用该接口时,需要注意的是:

  • 更换系统盘时,会改变 ECS 实例的系统盘磁盘 ID。
  • 更换系统盘时,不改变系统盘的磁盘种类和付费方式,同时原系统盘将被释放。
  • 更换系统盘时,实例的状态必须为已停止(Stopped)状态,且实例的 OperationLocks 中没有标记 "LockReason" : "security" 的锁定状态,且实例不能为欠费状态。
  • 可以通过指定参数 SystemDisk.Size 重新指定系统盘的容量大小,其中参数 SystemDisk.Size 的值必须大于等于 max{40, 更换前的系统盘容量}。超过 max{40, 更换前的系统盘容量} 的磁盘容量部分,将收取额外费用。

请求参数

名称 类型 是否必需 描述
Action String 系统规定参数。取值:ReplaceSystemDisk
InstanceId String 指定实例的 ID。
ImageId String 重置系统时使用的镜像 ID。
Password String 实例的密码。
  • 长度为 [8, 30] 个字符,必须同时包含三类不同的字符(大、小写字母,数字和特殊符号)。
  • 支持以下特殊字符:( ) ` ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ‘ < > , . ? /
如果传入 Password 参数,请务必使用 HTTPS 协议调用 API,避免密码泄露。
KeyPairName String 密钥对名称。
  • Windows ECS 实例,忽略该参数。默认为空。即使填写了该参数,仍旧只执行 Password 的内容。
  • Linux ECS 实例的密码登录方式会被初始化成禁止。
SystemDisk.Size String 新的系统盘容量,单位为 GB。取值范围为:
  • [Max{40, ImageId.size}, 500]。
默认值:Max{40, ImageId.size}
ClientToken String 用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不能超过 64 个 ASCII 字符。
具体参见附录:如何保证幂等性
SecurityEnhancementStrategy String 是否开启安全加固,取值范围:
  • Active:启用安全加固,只对系统镜像生效
  • Deactive:不启用安全加固,对所有镜像类型生效

返回参数

名称 类型 描述
DiskId String 新系统盘的磁盘 ID

错误码

错误代码 错误信息 HTTP 状态码 说明
InvalidDiskCategory.ValueNotSupported The specified parameter “DiskCategory” is not valid. 400 指定的 DiskCategory 不合法。
InvalidParameter.Conflict The specified image does not support the specified instance type. 400 指定的镜像不支持创建这一类规格的实例。
InvalidPassword.Malformed The specified parameter “Password” is not valid. 400 指定的 Password 格式不合法。
InvalidSystemDiskSize The specified parameter SystemDisk.Size is invalid. 400 指定的参数 SystemDisk.Size 不合法。
InvalidSystemDiskSize.ImageNotSupportResize The specified image does not support resize. 400 指定的镜像不支持磁盘扩容。
InvalidSystemDiskSize.ValueNotSupported The specified parameter SystemDisk.Size is invalid. 400 指定的参数 SystemDisk.Size 不合法。
OperationDenied The specified image contains the snapshot of the data disk,does not support this operation. 400 包含数据盘快照的镜像不能进行更换系统盘操作。
ChargeTypeViolation The operation is not permitted due to charge type of the instance. 403 指定实例的付费方式不支持更换系统盘。
DiskCreatingSnapshot The operation is denied due to a snapshot of the specified disk is not completed yet. 403 指定的磁盘正在创建快照。
ImageNotSubscribed The specified image has not be subscribed. 403 指定的镜像未在镜像市场订阅。
ImageNotSupportInstanceType The specified image don not support the InstanceType instance. 403 指定镜像不支持该实例类型。
ImageRemovedInMarket The specified market image is not available, Or the specified user defined image includes product code because it is based on an image subscribed from marketplace, and that image in marketplace includeing exact the same product code has been removed. 403 指定的镜像已经从镜像市场中下架。
IncorrectInstanceStatus The current status of the resource does not support this operation. 403 指定的实例状态不正确。
INST_HAS_UNPAID_ORDER The instance has unpaid order. 403 该实例有未支付的订单。
InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). 403 指定的实例已欠费。
InstanceLockedForSecurity The instance is locked due to security. 403 指定的实例被安全锁定。
IoOptimized.NotSupported The specified image is not support IoOptimized Instance. 403 镜像必须支持 I/O 优化实例。
QuotaExceed.BuyImage The specified image is from the image market,You have not bought it or your quota has been exceeded. 403 指定镜像没有购买或超过限制。
InvalidImageId.NotFound The specified ImageId does not exist. 404 指定的镜像不存在。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的实例不存在。
InvalidSystemDiskSize.LessThanImageSize The specified parameter SystemDisk.Size is less than the image size. 404 指定的参数 SystemDisk.Size 小于镜像大小。
InvalidSystemDiskSize.LessThanMinSize The specified parameter SystemDisk.Size is less than the min size. 404 指定的参数 SystemDisk.Size 小于磁盘大小下限。
InvalidSystemDiskSize.MoreThanMaxSize The specified SystemDisk.Size parameter exceeds the maximum size. 404 指定的参数 SystemDisk.Size 大于磁盘大小上限。
NoSuchResource The specified resource is not found. 404 指定资源不存在。
OperationDenied Internal Error. 500 内部错误

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=ReplaceSystemDisk
  2. &InstanceId=i-23jggx34b
  3. &ImageId=m-myimage11
  4. &<公共请求参数>

返回示例

XML 格式

  1. <ResetDiskResponse>
  2. <DiskId>d-23jbf2v5m</DiskId>
  3. <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
  4. </ResetDiskResponse>

JSON 格式

  1. {
  2. "RequestId":"337568C5-64F3-4B76-8CDD-D3D8C57B5B8C",
  3. "DiskId":"d-j6cam2z21u4ks3dj6flb"
  4. }
本文导读目录