You can call this operation to modify the performance level of an enhanced SSD (ESSD).
Description
To modify the performance level of an enhanced SSD, take note of the following items:
- You can only upgrade the performance level of a subscription enhanced SSD. However, you can upgrade or downgrade the performance level of a pay-as-you-go enhanced SSD.
- The enhanced SSD must be in the In_Use or Available state.
- If the enhanced SSD is attached to an ECS instance, the instance must be in the Running or Stopped state. The instance cannot be in the expired state or stopped due to an overdue payment.
- If you cannot upgrade the performance level of the enhanced SSD due to its capacity limit, resize the enhanced SSD by calling the ResizeDisk operation and then try again. For more information, see Enhanced SSDs.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | ModifyDiskSpec |
The operation that you want to perform. Set the value to ModifyDiskSpec. |
DiskId | String | Yes | d-bp131n0q38u3a4zi**** |
The ID of the enhanced SSD. |
PerformanceLevel | String | No | PL2 |
The performance level of the enhanced SSD. Default value: PL1. Valid values:
|
DryRun | Boolean | No | false |
Specifies whether to check the validity of the request without actually making the request. Default value: false. Valid values:
|
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
The ID of the request. |
TaskId | String | null |
Note This parameter is in invitational preview and not available.
|
Examples
Sample requests
https://ecs.aliyuncs.com/?Action=ModifyDiskSpec
&DiskId=d-bp131n0q38u3a4zi****
&PerformanceLevel=PL2
&<Common request parameters>
Sample success responses
XML
format
<ModifyDiskSpecResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</ModifyDiskSpecResponse>
JSON
format
{
"RequestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
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. |
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. |
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 | 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 | 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 | 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. |
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. |
400 | InvalidPerformanceLevel.Malformed | The specified parameter PerformanceLevel is not valid. | The error message returned because the specified PerformanceLevel parameter is invalid. |
403 | OperationDenied.PerformanceLevelNotMatch | The specified PerformanceLevel and disk size do not match. | The error message returned because the specified performance level and the disk size do not correspond to each other. |
For a list of error codes, visit the API Error Center.