调用PurgeDBInstanceLog接口清理RDS实例本地日志。
RDS实例有自动上传日志备份机制,但是在实例空间不足时,您可以使用本接口手动上传日志备份,提前释放存储空间。上传后系统会自动清理本地重复的日志备份。
调用本接口会将本地日志备份上传到OSS上(SQL Server会先收缩事务日志再上传),然后清理本地日志备份,释放存储空间。关于日志备份的更多信息,请参见备份MySQL数据或备份SQL Server数据。
说明
- 该接口仅适用于MySQL、SQL Server实例。
- 上传日志备份不会影响数据恢复功能。
- 释放的是存储空间,不是备份空间,因此不会降低备份空间使用量。
- 日志备份上传到的OSS由RDS提供,不需要您购买,同时也不支持访问此OSS。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | PurgeDBInstanceLog | 系统规定参数,取值:PurgeDBInstanceLog。 |
DBInstanceId | String | 是 | rm-uf6wjk5xxxxxxx | 待清理或收缩日志的实例ID。 |
ClientToken | String | 否 | ETnLKlblzczshOTUbOCzxxxxxxxxxx | 用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 65BDA532-28AF-4122-AA39-B382721EEE64 | 请求ID。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=PurgeDBInstanceLog &DBInstanceId=rm-uf6wjk5xxxxxxx &<公共请求参数>
正常返回示例
XML
格式
<PurgeDBInstanceLogResponse> <RequestId> 65BDA532-28AF-4122-AA39-B382721EEE64</RequestId></PurgeDBInstanceLogResponse>
JSON
格式
{ "RequestId": " 65BDA532-28AF-4122-AA39-B382721EEE64" }
错误码
访问错误中心查看更多错误码。