更新时间：2025-12-09 GMT+08:00
设置Binlog本地保留时长 - SetBinlogClearPolicy
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项 | 访问级别 | 资源类型（*为必须） | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
rds:binlog:setPolicy | permission_management | instance | g:EnterpriseProjectId g:ResourceTag/<tag-key> | - | - |
接口约束
- 实例在创建过程中不能设置。
- 仅支持RDS for MySQL实例。
URI
- 参数说明
表1 参数说明 名称
是否必选
说明
project_id
是
租户在某一Region下的项目ID。
获取方法请参见获取项目ID。
instance_id
是
实例ID。
请求消息
名称 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
binlog_retention_hours | 是 | Integer | 二进制日志保留时间，可设置范围为0~7*24小时。 |
请求示例
设置Binlog本地保留3小时。
PUT https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/fa60258325f6424ca1ba28653629d7b1in01/binlog/clear-policy
{
"binlog_retention_hours": 3
} 响应消息
- 正常响应要素说明
表3 要素说明 名称
参数类型
说明
resp
String
调用正常时，返回“successful”。
- 正常响应样例
{ "resp": "successful" } - 异常响应
请参见异常请求结果。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。
父主题：获取日志信息
