Configure automatic storage expansion -

This operation is supported for ApsaraDB RDS for MySQL instances that run RDS High-availability Edition and use standard SSDs or enhanced SSDs (ESSDs) and ApsaraDB RDS for PostgreSQL instances that use standard SSDs or ESSDs. If the available storage reaches the specified threshold, ApsaraDB RDS increases the storage capacity of the instance to meet your storage requirements. In most cases, no transient connections occur during the expansion process. For more information, see Configure automatic storage expansion for an ApsaraDB RDS for MySQL instance and Configure automatic storage expansion for an ApsaraDB RDS for PostgreSQL instance.

Note If an automatic storage expansion is triggered, ApsaraDB RDS increases the storage capacity based on the larger value between 15% of the purchased storage capacity and 5 GB.

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	Yes	ModifyDasInstanceConfig	The operation that you want to perform. Set the value to ModifyDasInstanceConfig.
ClientToken	String	No	ETnLKlblzczshOTUbOCz*****	The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the generated token is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length.
DBInstanceId	String	Yes	rm-uf6wjk5*****	The ID of the instance.
StorageAutoScale	String	Yes	Enable	Specifies whether to enable automatic storage expansion. Valid values: Enable Disable
StorageThreshold	Integer	No	50	The threshold in percentage based on which an automatic storage expansion is triggered. If the available storage reaches the threshold, ApsaraDB RDS increases the storage capacity of the instance. Valid values: 10 20 30 40 50 Note If you set the StorageAutoScale parameter to Enable, you must specify this parameter.
StorageUpperBound	Integer	No	1000	The maximum storage capacity that is allowed by automatic storage expansion. The value of this parameter must be equal to or greater than the current storage capacity of the instance. Valid value for instances with ESSDs: 32000. Unit: GB Valid value for instances with standard SSDs: 6000. Unit: GB Note If you set the StorageAutoScale parameter to Enable, you must specify this parameter.

Response parameters


Parameter	Type	Example	Description
RequestId	String	C3C247D4-1643-4C5D-87C2-C829543FC626	The ID of the request.

Examples

Sample requests

http(s)://rds.aliyuncs.com/?Action=ModifyDasInstanceConfig
&DBInstanceId=rm-uf6wjk5*****
&StorageAutoScale=Enable
&StorageThreshold=50
&StorageUpperBound=1000
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyDasInstanceConfigResponse>
<RequestId>C3C247D4-1643-4C5D-87C2-C829543FC626</RequestId>
</ModifyDasInstanceConfigResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "C3C247D4-1643-4C5D-87C2-C829543FC626"
}

Error codes


HTTP status code	Error code	Error message	Description
400	AccessHDMInstanceFailed	The specified instance access HDM failed.	The error message returned because the specified instance fails to access HDM.

For a list of error codes, visit the Error Center.