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 For VPC-type instances only: You must disable the No Fees for Stopped Instances (VPC-Connected) feature when you stop an instance. This prevents the instance from failing 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 due to security reasons. If the value of LockReason in OperationLocks is security in the response when you query details of an instance, the instance is locked due to 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 status of the new system disk. If the disk is attached to an instance, the system disk is replaced.
• You can call the DescribeInstances operation to query the status 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.