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

Elastic Compute Service

Copy page
Download PDF
Reserved storage capacity
ModifyReservedStorageCapacityEffectiveAt - Change the effective time of the Reserved Storage Capacity package
Copy page
Download PDF
ModifyReservedStorageCapacityEffectiveAt - Change the effective time of the Reserved Storage Capacity package
Call the ModifyReservedStorageCapacityEffectiveAt API to change the effective time of the Reserved Storage Capacity package.​
Instructions​
Only applies to changing the effective time for Reserved Storage Capacity packages that have not taken effect. If the Reserved Storage Capacity package has already taken effect, you cannot change its effective time through this API.​
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​
Below are request parameters specific to this API and some common parameters. For more information, see Public Parameters.​
Action string required Example: ModifyReservedStorageCapacityEffectiveAt​
Action to be performed: ModifyReservedStorageCapacityEffectiveAt​
​
Version string required Example value: 2020-04-01​
The version of the API is: 2020-04-01.​
​
RSCId string required Example value: rsc-3vpnts78dk3x35cj****​
Reserved storage capacity package ID.​
​
EffectiveAt string Optional Example value: 2025-03-29T17:50:00+08:00​
The effective time for the Reserved Storage Capacity package. The date format follows the ISO 8601 standard. The default value is empty, which means immediate effect. If a non-integer-hour effective time is specified, it takes effect at the corresponding whole hour. For instance, if specified time is 2024-11-25 21:50:05, the actual effective time would be 2024-11-25 21:00:00.​
​
​
​
Response Parameters​
This API does not have unique response parameters. For more information, see Response Structure.​
Request example​
​
POST /?Action=ModifyReservedStorageCapacityEffectiveAt&Version=2020-04-01 HTTP/1.1​
Host: open.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20251125T080645Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251125/cn-beijing/storage_ebs/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
"EffectiveAt": "2025-03-29T17:50:00+08:00",​
"RSCId": "rsc-3vpnts78dk3x35cj****"​
}​
​
Back to example​
​
{​
"ResponseMetadata": {​
"RequestId": "202511251606571820061410479B****",​
"Action": "ModifyReservedStorageCapacityEffectiveAt",​
"Version": "2020-04-01",​
"Service": "storage_ebs",​
"Region": "cn-beijing"​
},​
"Result": {}​
}​
​
error code​
The following table lists all error codes related to this API and its business logic. For common error codes, refer to the Public Error Code documentation.​
​
Status code​
error code​
error message​
Create Volume​
400​
ErrInvalidAccountId​
account id invalid​
Account ID is invalid.​
400​
RscMissingRscId​
Missing Rsc id.​
Missing RSC ID.​
400​
InvalidEffectiveTime​
Invalid effective time.​
Invalid effective time.​
400​
RscIdInvalid​
The Rsc id is invalid.​
Invalid RSC ID.​
400​
RscInvalidStatus​
The RSC status is invalid.​
Invalid RSC status.​
​
​
Last updated: 2026.01.09 18:19:57