You can call this operation to resize a system disk or data disk.
Description
- You can resize the following categories of disks: basic disks (
cloud
), ultra disks (cloud_efficiency
), standard SSDs (cloud_ssd
), and enhanced SSDs (ESSDs) (cloud_essd
). - You cannot resize a disk when a snapshot is being created for the disk.
- The instance to which the disk to be resized is attached must be in the Running (
Running
) or Stopped (Stopped
) state. - After you resize a disk, its partitions and file systems are not changed. You must manually allocate the storage space on the disk after it is resized.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | ResizeDisk |
The operation that you want to perform. Set the value to ResizeDisk. |
DiskId | String | Yes | d-bp67acfmxazb4p**** |
The ID of the disk to be resized. |
NewSize | Integer | Yes | 1900 |
The new disk capacity. Unit: GiB. Valid values:
The new disk capacity must be greater than the original disk capacity. |
Type | String | No | offline |
The method used to resize the disk. Default value: offline. Valid values:
|
ClientToken | String | No | 123e4567-e89b-12d3-a456-426655440000 |
The client token that is used to ensure the idempotence of the request. You can use the client to generate the value, but you must make sure that it is unique among different requests. The ClientToken value must contain only ASCII characters and cannot exceed 64 characters in length. For more information, see How to ensure idempotence. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | F3CD6886-D8D0-4FEE-B93E-1B73239673DE |
The ID of the request. |
Examples
Sample requests
https://ecs.aliyuncs.com/?Action=ResizeDisk
&DiskId=d-bp67acfmxazb4p****
&NewSize=1900
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<Common request parameters>
Sample success responses
XML
format
<ResizeDiskResponse>
<RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ResizeDiskResponse>
JSON
format
{
"RequestId": "F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
403 | InvalidDataDiskSize.ValueNotSupported | The specified DataDisk.n.Size beyond the permitted range, or the capacity of snapshot exceeds the size limit of the specified disk category. | The error message returned because the specified DataDisk.N.Size parameter or the snapshot capacity exceeds the maximum capacity that is allowed for the specified disk category. |
404 | InvalidDiskId.NotFound | The specified disk does not exist. | The error message returned because the specified DiskId parameter does not exist. Check whether the disk ID is correct. |
404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | The error message returned because the specified instance ID does not exist. Check whether the instance ID is correct. |
403 | OperationDenied | The type of the disk does not support the operation. | The error message returned because the specified disk category does not support this operation. |
403 | OperationDenied | The status of the disk or the instance that the disk is attaching with does not support the operation. | The error message returned because the operation is not supported while the disk or instance is in the current state. |
403 | InvalidDiskSize.TooSmall | Specified new disk size is less than the original disk size. | The error message returned because the specified new disk capacity is smaller than the original disk capacity. |
403 | InvalidDiskSize.TooLarge | Specified new disk size is beyond the permitted range. | The error message returned because the specified new disk capacity exceeds the capacity limit. |
403 | InstanceExpiredOrInArrears | The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). | The error message returned because the subscription instance has expired. Renew the instance first. |
403 | DiskError | IncorrectDiskStatus | The error message returned because the status of the specified disk is invalid. |
403 | DiskInArrears | The specified operation is denied as your disk owing fee. | The error message returned because you have an overdue payment for the disk. |
403 | IncorrectInstanceStatus | The current status of the resource does not support this operation. | The error message returned because the operation is not supported while the resource is in the current state. |
500 | InternalError | The request processing has failed due to some unknown error. | The error message returned because an internal error has occurred. Try again later. If the problem persists, submit a ticket. |
403 | DiskCreatingSnapshot | The operation is denied due to a snapshot of the specified disk is not completed yet. | The error message returned because a snapshot is being created from the specified disk. |
400 | InvalidDataDiskCategory.ValueNotSupported | %s | The error message returned because the specified data disk category is invalid. |
400 | InvalidParameter.Conflict | %s | The error message returned because a specified parameter is invalid. Check whether the parameter conflicts with another parameter. |
400 | InvalidDataDiskSize.ValueNotSupported | %s | The error message returned because the specified data disk capacity is invalid. |
400 | InvalidSystemDiskSize.ValueNotSupported | %s | The error message returned because the specified system disk size is invalid. |
403 | InvalidDiskSize | Specified new disk size is less than or equal the original disk size. | The error message returned because the specified new disk capacity is smaller than or equal to the original disk capacity. |
400 | IncompleteParamter | Some fields can not be null in this request. | The error message returned because some required parameters are not specified. |
403 | Operation.Conflict | The operation may conflicts with others. | The error message returned because the specified operation conflicts with other operations. |
403 | InstanceLockedForSecurity | The instance is locked due to security. | The error message returned because the operation is not supported while the resource is locked for security reasons. |
403 | IncorrectDiskStatus | The current disk status does not support this operation. | The error message returned because the operation is not supported while the disk is in the current state. Make sure that the disk is available and your account has no overdue payments. |
403 | UserNotInTheWhiteList | The user is not in disk white list. | The error message returned because you are not in the whitelist to manage the disk. Try again when you are in the whitelist. |
400 | InvalidRegionId.MalFormed | The specified RegionId is not valid | The error message returned because the specified RegionId parameter is invalid. |
403 | InvalidDiskCategory.NotSupported | The specified disk category is not supported. | The error message returned because the operation is not supported by the specified disk category. |
400 | InvalidParam.Type | The specified type is not supported. | The error message returned because the specified Type parameter is invalid. |
403 | InvalidRegion.NotSupport | The specified region does not support resize online. | The error message returned because online resizing is not supported in the specified region. |
403 | InvalidDiskCategory.NotSupported | The specified disk category does not support resize online. | The error message returned because the specified disk category does not support online resizing. |
403 | IncorrectInstanceStatus | The current status of the resource does not support resize online. | The error message returned because this operation is not supported while the resource is in the current state. |
403 | InvalidInstanceStatus.NotRunning | The status of instance to which the disk attachs must be running when resizing online. | The error message returned because the instance to which the disk is attached is not in the Running state when you resize the disk online. |
403 | IncorrectDiskStatus | The current status of the resource does not support resize online | The error message returned because online resizing is not supported while the resource is in the current state. |
400 | LastOrderProcessing | The previous order is still processing, please try again later. | The error message returned because the previous order is being processed. Try again later. |
403 | InvalidParameter.KMSKeyId.KMSUnauthorized | ECS service have no right to access your KMS. | The error message returned because ECS is not authorized to access your KMS resources. |
500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | The error message returned because an internal error has occurred. Try again later. If the problem persists, submit a ticket. |
403 | SecurityRisk.3DVerification | We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email. | The error message returned because risks are detected in your default credit card or debit card. Use the link in the email for verification. |
400 | InvalidSystemDiskSize.ImageNotSupportResize | The specified image does not support resize. | The error message returned because the specified image does not support resizing. |
For a list of error codes, visit the API Error Center.