You can call the DeleteDBInstance operation to release an ApsaraDB RDS instance.
Before you call this operation, make sure that the following requirements are met:
- The instance must be in the Running state.
- The read/write splitting feature must be disabled for the instance.
- The instance must be a primary, read-only, disaster recovery, or temporary instance. If the instance is a primary instance, it must use the pay-as-you-go billing method.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DeleteDBInstance |
The operation that you want to perform. Set the value to DeleteDBInstance. |
DBInstanceId | String | Yes | rm-uf6wjk5xxxxxxxxxx |
The ID of the instance. |
ReleasedKeepPolicy | String | No | Lastest |
The policy based on which ApsaraDB RDS retains archived backup files after the instance is released. Valid values:
Note This parameter is supported only when the instance runs the MySQL database engine.
|
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RegionId | String | ap-southeast-1 |
The ID of the region to which the instance belongs. |
RequestId | String | 65BDA532-28AF-4122-AA39-B382721EEE64 |
The ID of the request. |
Examples
Sample requests
http(s)://rds.aliyuncs.com/? Action=DeleteDBInstance
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&<Common request parameters>
Sample success responses
XML
format
<DeleteDBInstanceResponse>
<RequestId>65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>
<RegionId>ap-southeast-1</RegionId>
</DeleteDBInstanceResponse>
JSON
format
{
"RequestId":"65BDA532-28AF-4122-AA39-B382721EEE64",
"RegionId":"ap-southeast-1"
}
Error codes
For a list of error codes, visit the API Error Center.