调用DeleteDBInstance接口释放RDS实例。
调用该接口时,实例必须满足以下条件,否则将操作失败:
- 实例状态为运行中。
- 实例已关闭读写分离。
- 实例类型为主实例(按量付费类型)、只读实例、灾备实例、临时实例。
说明 你也可以通过RDS管理控制台手动释放实例,具体请参见释放实例。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DeleteDBInstance |
系统规定参数。取值:DeleteDBInstance。 |
DBInstanceId | String | 是 | rm-uf6wjk5**** |
实例ID。可调用DescribeDBInstances获取。 |
ReleasedKeepPolicy | String | 否 | Lastest |
实例释放后的归档备份保留策略。取值:
说明 仅RDS MySQL本地盘实例支持。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RegionId | String | ap-southeast-1 |
地域ID。 |
RequestId | String | 65BDA532-28AF-4122-AA39-B382721EEE64 |
请求ID。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=DeleteDBInstance
&DBInstanceId=rm-uf6wjk5****
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DeleteDBInstanceResponse>
<RequestId>65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>
<RegionId>ap-southeast-1</RegionId>
</DeleteDBInstanceResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "65BDA532-28AF-4122-AA39-B382721EEE64",
"RegionId" : "ap-southeast-1"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | EngineMigration.ActionDisabled | Specified action is disabled while custins is in engine migration. | 实例在引擎迁移中时,指定的操作被禁用。 |
403 | OperationDenied.PrePayTypeNotSupported | The operation is not permitted due to pay type of instance. | 预付费实例,不允许直接删除 |
访问错误中心查看更多错误码。