ReplaceSystemDisk

Description

Replaces the system disk or the operating system of an ECS instance. When you call this interface, consider the following:

• You cannot change the category of the system disk for your ECS instance.

• If you replace the system disk, the disk ID of the system disk for your ECS instance is replaced.

• The billing method of the system disk remains unchanged. The original system disk is released once the action is completed.

• The instance must be in the Stopped status. If your VPC-Connected instance has the No fees for stopped instances (VPC-Connected) feature enabled, we recommend that you disable the feature when you stop the instance to guarantee a successful restart attempt. For more information, see StopInstance.

• The ECS instance cannot have an unpaid order.

• If the specified instance is locked, the OperationLocks of the instance cannot be "LockReason" : "security".

• You can specify the size of the new system disk by specifying the parameter SystemDisk.Size. The SystemDisk.Size must be equal to or greater than max{20, [size of the current system disk]}. Extra fees are charged for the size that exceeds max{20, [the volume of current system disk]}.

Request parameters

Response parameters

Examples

Request example

https://ecs.aliyuncs.com/?Action=ReplaceSystemDisk
&InstanceId=i-23jggx34b
&ImageId=m-myimage11
&<Common Request Parameters>

Response example

XML format

<ReplaceSystemDiskResponse>
    <DiskId>d-23jbf2v5m</DiskId>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ReplaceSystemDiskResponse>

JSON format

{
  "DiskId": "d-23jbf2v5m",
  "RequestId": "F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}

Error codes