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). If the instance is a pay-as-you-go instance and the economical mode is enabled by default for the instance, you must disable the economical mode and enable the standard mode when you stop the instance. This prevents the instance from being unable to restart 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 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:

• 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.
• Call the DescribeInstances operation to query the state of the instance whose system disk is replaced. If the OperationLocks response parameter is empty, 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

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

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

JSON format

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

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

Error codes

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