Change the volume specifications via the ModifyVolumeSpec interface.

precautions

For detailed precautions about volume specification changes, see Volume Specification Change.

Debugging

API Explorer

You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.

Go to debug

request parameters

Only the interface-specific request parameters and some common parameters are listed below. For more information, see Common Parameters.

Action string required Example: ModifyVolumeSpec

Operation to perform, value: ModifyVolumeSpec

Version string required Example value: 2020-04-01

The version of the API is: 2020-04-01.

VolumeId string required Example value: vol-hwnpjm4gl8jww4u0****

Volume ID.

TargetVolumeType string required Example value: ESSD_FlexPL

The modified volume specifications currently only support changing ESSD_PL0 volumes to ESSD_FlexPL volumes, which are set as ESSD_FlexPL.

Return Parameters

Only the interface-specific return parameters are listed below. For more information, see Return Structure.

VolumeId string Example: vol-hwnpjm4gl8jww4u0****

Volume ID.

tip

After invoking the ModifyVolumeSpec interface, if you see the volume upgraded to the target specification on the console, it means the volume specification change was successful.

OrderNo string Example value: Order218800001834604****

Order number.

tip

The order number is only returned when modifying the specifications of a subscription volume.

Request example

Back to example

error code

The table below lists error codes related to business logic for this API. For public error codes, refer to the Public Error Codes documentation.

Status code	error code	error message	Create Volume
400	InvalidRequest	The operation is not permitted due to the request is invalid.	Invalid request.
400	InvalidParameters	The request has invalid parameters.	The request contains invalid parameters.
400	MissingVolumeID	The specified parameter VolumeId is missing.	Missing volume ID.
400	InvalidVolumeSize	Invalid volume size.	The volume size is invalid.
400	IncorrectVolumeStatus	The specified volume status is invalid.	The specified volume status is invalid.
400	ErrInvalidCurrentVolumeType	The current volume type is invalid.	The current volume type is invalid.
400	ErrInvalidTargetVolumeType	The target volume type is invalid.	The target volume type is invalid.
404	VolumeNotFound	The specified volume does not exist.	The volume does not exist.
412	ErrInstanceExpired	Instance is already expired.	The ECS instance has expired.
412	ErrVolumeDownGradeTooOften	Only one modification is allowed within one days.	You can only downgrade the specification once per day.
412	QuotaCheckNotPass	The user has exceeded the quota for creating volumes of this type and cannot create more: {{param}}.	The user has exceeded their quota for this type of volume and cannot create more: {{param}}.
500	InternalError	An internal error has occurred.	Internal error. Try again. If multiple attempts fail, submit a ticket.

Elastic Compute Service