ReplaceSystemDisk

Description

When you call this interface, consider the following:

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

• The billing method of the system disk remains unchanged. However, the disk ID of the system disk for your ECS instance is replaced. The original system disk is released once the action is completed.

• The instance must be in the Stopped (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.

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

• The ECS instance cannot have an unpaid order.

• 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

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

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

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

Error codes

Error codes specific to this interface are as follows. For more information, see API Error Center.