You can call this operation to upgrade the performance level of an ESSD.

Description

To upgrade the performance level of an ESSD, make sure that:

  • The ESSD is in the In Use or Available state.
  • If the ESSD is attached to an ECS instance, the ECS instance is in the Running or Stopped state.
  • The new performance level of the ESSD takes effect immediately after you call this operation. The ESSD is then billed based on the unit price specific to the new performance level.
  • If you cannot upgrade the performance level of the ESSD due to its capacity limit, resize the ESSD by calling the ResizeDisk operation and then perform the upgrade again. For more information, see ESSD.

Debugging

Alibaba Cloud provides OpenAPI Explorer to simplify API usage. You can use OpenAPI Explorer to search for APIs, call APIs, and dynamically generate SDK example code.

Request parameters

Parameter Type Required Example Description
DiskId String Yes d-bp131n0q38u3a4zi*****

The ID of the ESSD.
PerformanceLevel String Yes PL2

The performance level you want to upgrade the ESSD to. Default value: PL1. Valid values:

  • PL1: indicates that a single ESSD delivers up to 50,000 random read/write IOPS.
  • PL2: indicates that a single ESSD delivers up to 100,000 random read/write IOPS.
  • PL3: indicates that a single ESSD delivers up to 1,000,000 random read/write IOPS.
Note The new performance level cannot be lower than the original one.
Action String No ModifyDiskSpec

The operation that you want to perform. For API requests using the HTTP and HTTPS methods, Action is required. Set this parameter to ModifyDiskSpec.

Response parameters

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

The ID of the request.

Examples

Sample request

https://ecs.aliyuncs.com/?Action=ModifyDiskSpec
&PerformanceLevel=PL2
&<Common request parameters>

Sample success response

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.
403 DiskInArrears The specified operation is denied as your disk owing fee. The error message returned because the specified disk has overdue payments.
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. The error message returned because the specified InstanceId parameter does not exist.
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 is being created for the specified disk.
403 OperationDenied The type of the disk does not support the operation. The error message returned because the operation is not supported by the specified data disk type.

View error codes