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, note the following content:

  • 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 Unattached 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 expired or stopped due to an overdue payment.
  • The new performance level of the enhanced SSD takes effect immediately after you call this operation. The enhanced SSD is then billed based on the unit price specific to the new performance level.
  • 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 SSD (ESSD).

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String No ModifyDiskSpec

The operation that you want to perform. If you use a custom HTTP URL or HTTPS URL to make an API request, you must specify the Action parameter. Set the value to ModifyDiskSpec.

DiskId String Yes d-bp131n0q38u3a4zi*****

The ID of the enhanced SSD.

PerformanceLevel String Yes PL2

The performance level of the enhanced SSD. Default value: PL1. Valid values:

  • PL1: A single enhanced SSD delivers up to 50,000 random read/write IOPS.
  • PL2: A single enhanced SSD delivers up to 100,000 random read/write IOPS.
  • PL3: A single enhanced SSD delivers up to 1,000,000 random read/write IOPS.

Response parameters

Parameter Type Example Description
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

The ID of the request.

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 disk ID 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 the specified disk has an overdue payment.
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. Ensure that the disk is available and 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 of the specified disk is being created.
403 OperationDenied The type of the disk does not support the operation. The error message returned because the disk category does not support the specified 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.