ReplaceSystemDisk

Description

When you call this operation, take note of the following items:

• You cannot change the category of the system disk.
• You cannot change the billing method of the system disk.
• The instance must be in the Stopped (Stopped) state.

  Note This item is applicable only to instances in virtual private clouds (VPCs): You must disable the No Fees for Stopped Instances (VPC-Connected) feature when you stop an instance. This prevents the instance from being unable to be restarted due to insufficient ECS resources after the system disk is replaced. For more information, see StopInstance.
• The instance must not be locked for security reasons. If the value of LockReason in OperationLocks is security in the response when you query the details of an instance, the instance is locked for security reasons. For more information, see API behavior when an instance is locked for security reasons.
• You cannot have overdue payments for the instance to which the system disk is attached.
• You can configure the SystemDisk.Size parameter to re-specify the capacity of the new system disk.

After you call this operation, you can use one of the following methods to check whether the system disk is replaced:

• You can call the DescribeDisks operation to query the state of the new system disk. If the new system disk is in the In_use state, the system disk is replaced.
• You can call the DescribeInstances operation to query the state of the instance whose system disk is replaced. If OperationLocks is empty for the instance in the response, the system disk is replaced.

Request parameters

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

Response parameters

Examples

Sample requests

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
&<Common request parameters>

Sample success responses

XML format

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

JSON format

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

Error codes

For a list of error codes, visit the API Error Center.