接口说明

更换系统盘时，您需要注意：

• 不支持更换系统盘的云盘类型。
• 不支持变更系统盘计费方式。
• 实例的状态必须为已停止（Stopped）状态。

  说明 仅适用于专有网络VPC类型实例。如果ECS实例为按量付费计费模式，且开启默认启用节省停机模式，为防止地域范围内的ECS实例库存不足，引起的更换系统盘后无法重启实例。您需要在停止该实例时设置为普通停机模式。具体操作，请参见 StopInstance。
• ECS实例不能被安全锁定，即实例的OperationLocks参数值包含"LockReason": "security"。更多信息，请参见安全锁定时的API行为。
• 系统盘挂载的ECS实例不能有未支付的订单。
• 您可以通过参数SystemDisk.Size重新指定系统盘的容量大小。

更换系统盘后，建议您通过以下任一方式验证是否更换成功：

• 通过DescribeDisks接口查询新系统盘的状态。如果已挂载实例，则表示更换系统盘的操作已完成。
• 通过DescribeInstances接口查询更换系统盘的实例的状态。如果返回值OperationLocks为空，则表示更换系统盘的操作已完成。

请求参数

()`~!@#$%^&*-_+=|{}[]:;'<>,.?/

返回数据

示例

请求示例

https://ecs.aliyuncs.com/?Action=ReplaceSystemDisk
&InstanceId=i-bp67acfmxazb4ph****
&ImageId=m-bp67acfmxazb4ph****
&SystemDisk.Size=80
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&PasswordInherit=false
&KeyPairName=testKeyPairName
&SecurityEnhancementStrategy=Active
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ReplaceSystemDiskResponse>
    <DiskId>d-bp67acfmxazb4ph****</DiskId>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ReplaceSystemDiskResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "337568C5-64F3-4B76-8CDD-D3D8C57B5B8C",
  "DiskId" : "d-bp67acfmxazb4ph****"
}

错误码

访问错误中心查看更多错误码。