You need to enable JavaScript to run this app.
Elastic Compute Service

Elastic Compute Service

Copy page
Download PDF
Volumes
ModifyVolumeAttribute - Modify volume attributes
Copy page
Download PDF
ModifyVolumeAttribute - Modify volume attributes
Call the ModifyVolumeAttribute interface to modify volume attributes.​
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.
​
request parameters​
Only unique request parameters for this interface and some common parameters are listed below. For more information, see Common Parameters.​
Action string required Example value: ModifyVolumeAttribute​
Operation to perform, value: ModifyVolumeAttribute.​
​
Version string required Example value: 2020-04-01​
The version of the API is: 2020-04-01.​
​
VolumeName string required Example: dtest3-volume-1​
Cloud disk name.​
​
Description string optional example value: test​
Volume description information.​
​
DeleteWithInstance boolean Optional Example: true​
When releasing the instance, choose whether to release the volume with the instance. Details are as follows:​
  • true: Released with the instance.​
  • false: Not released with the instance.​
​
DeleteProtection boolean Optional Example: true​
Enable volume delete protection.​
​
DeleteProtectionRetentionDays integer optional example value: 3​
Snapshot data associated with delete protection is retained permanently by default. You can also select a specific retention period between 1 and 65,536 days (default is 30 days). Once the set period ends, the snapshot will be deleted automatically.​
​
VolumeId string required Example: vol-3thhlu8byl4bwbha****​
Volume ID.​
​
​
​
Response parameters​
This interface does not have unique response parameters. For more information, see Response Structure.​
Request example​
​
GET /?Action=ModifyVolumeAttribute&Version=2020-04-01&VolumeId=vol-3tir92lne23vj0x1****&VolumeName=dtest3-volume-1&DeleteWithInstance=true HTTP/1.1​
Host: open.volcengineapi.com​
Region: cn-beijing​
ServiceName: storage_ebs​
​
Back to example​
​
{​
"ResponseMetadata": {​
"RequestId": "202106232008120102251331430A0D****",​
"Action": "ModifyVolumeAttribute",​
"Version": "2020-04-01",​
"Service": "storage_ebs",​
"Region": "cn-beijing"​
},​
"Result": {}​
}​
​
error code​
The table below lists error codes related to this interface and business logic. For public error codes, see the public error codes documentation.​
​
Status code​
error code​
error message​
Create Volume​
400​
MissingVolumeID​
The specified parameter VolumeId is missing.​
Missing volume ID.​
404​
VolumeNotFound​
The specified volume does not exist.​
The specified volume does not exist.​
​
​
Last updated: 2026.03.23 16:42:27