开发者社区 问答 正文

API参考 - API参考 -备份恢复 -ModifyBackupPolicy


修改备份策略,RDS根据用户设置的系统配置,定期做实例备份。
实例需满足以下条件,否则操作将失效:

  • 实例为非只读实例。
  • 实例状态为运行中。


请求参数

[tr=rgb(51, 205, 229)][td]名称 类型是否必须描述ActionString是
要执行的操作。取值:
ModifyBackupPolicy。DBInstanceIdString是
实例ID。BackupPolicyModeString是
备份策略模式:
  • DataBackupPolicy:数据备份策略;
  • DuplicationPolicy:转储策略;
  • LogBackupPolicy:日志备份策略。
PreferredBackupTimeString是
备份时间。
格式:HH:mmZ-HH:mmZ。
BackupPolicyMode为DataBackupPolicy时,该参数必传。PreferredBackupPeriodString是
备份周期:
  • Monday:周一;
  • Tuesday:周二;
  • Wednesday:周三;
  • Thursday:周四;
  • Friday:周五;
  • Saturday:周六;
  • Sunday:周日。

如果传递多个参数,参数间用英文逗号(,)分割。
BackupPolicyMode为DataBackupPolicy时,该参数必传。BackupRetentionPeriodString否
数据备份保留天数(7天到730天),默认为:7天。
BackupPolicyMode为LogBackupPolicy时,该参数必传。BackupLogString否
日志是否可用:
  • Enable:可用;
  • Disabled:不可用。

默认为Enable。
BackupPolicyMode为DataBackupPolicy时,该参数必传。EnableBackupLogString否
是否开启日志备份:
  • True:开启;
  • False:关闭。

BackupPolicyMode为LogBackupPolicy时,该参数必传。LogBackupFrequencyString否日志备份频率:
  • 为空:表示与数据备份频率一致。默认值。
  • LogInterval:目前表示每30分钟备份一次。

该参数仅适用于SQL Server。LocalLogRetentionHoursString否
日志备份本地保留小时数。
取值为0~7*24,0表示不保留,默认为18。
BackupPolicyMode为LogBackupPolicy时,该参数必传。LocalLogRetentionSpaceString否
本地日志最大空间使用率。
取值为0~50,此为循环空间,默认为30。
BackupPolicyMode为LogBackupPolicy时,该参数必传。HighSpaceUsageProtectionString否
实例使用空间>= 90%,或者剩余空间< 5GB时,是否无条件清理Binlog:
  • Disable:不清理;
  • Enable:清理。

默认为Enable。
BackupPolicyMode为LogBackupPolicy时,该参数必传。DuplicationString否
是否开启备份文件转储至OSS。
  • Disable:关闭;
  • Enable:开启。

默认为Disable。DuplicationContentString否
数据备份或日志备份。
  • DATA:数据备份;
  • LOG:日志备份;
  • DATA&LOG:数据和日志同时备份。

Duplication=Enable时,该参数必填。DuplicationLocationString否
RAM授权RDS访问您的OSS,日志文件才能转储至OSS。
授权方法如下:

{"Storage":"OSS","Location": {"Bucket": 'xxx', "Location":'cn-hangzhou',"OSSEndPoint":"oss-test","Object":"obje1"}
如果Duplication=Enable,该参数必填。

返回参数

[tr=rgb(51, 205, 229)][td]参数 类型描述requestIdString请求ID。

示例


请求示例

https: //rds.aliyuncs.com/?Action=ModifyBackupPolicy &DBInstanceId=riauvjz6zajfiq6ba1370329449201 &PreferredBackupTime=00:00Z—01:00Z &PreferredBackupPeriod=Monday &<公共请求参数>
返回示例

  • XML格式

    <CreateBackupResponse><RequestId>DA147739-AEAD-4417-9089-65E9B1D8240D</RequestId></CreateBackupResponse>

  • JSON格式

    {"RequestId":"DA147739-AEAD-4417-9089-65E9B1D8240D"}

展开
收起
梨好橙 2018-09-14 23:38:59 1395 分享 版权
阿里云 AI 助理回答

修改RDS实例备份策略的操作指南

概述

您希望修改阿里云RDS实例的备份策略,以实现定期自动备份。此操作允许您自定义备份的时间、周期、保留天数及日志备份等设置,确保数据安全与恢复的灵活性。请遵循以下步骤进行配置,同时注意操作前提和参数要求。

操作步骤

  1. 确认实例状态

    • 确保您的RDS实例为非只读实例且当前状态为运行中。如果实例不满足这些条件,修改备份策略的操作将无法执行。
  2. 准备请求参数

    • Action: 必须设置为ModifyBackupPolicy
    • DBInstanceId: 提供您要修改备份策略的RDS实例ID。
    • BackupPolicyMode: 选择备份策略模式,如DataBackupPolicy(数据备份策略)、DuplicationPolicy(转储策略)或LogBackupPolicy(日志备份策略)。
    • PreferredBackupTime: 根据需要设定备份时间,格式为HH:mmZ-HH:mmZ,例如00:00Z-01:00Z
    • PreferredBackupPeriod: 定义备份周期,用英文逗号分隔,如Monday,Tuesday
    • BackupRetentionPeriod: 设置数据备份保留天数(7到730天),默认为7天。
    • BackupLog/EnableBackupLog: 控制日志备份的可用性,可选EnableDisable
    • LogBackupFrequency: 日志备份频率,可以为空表示与数据备份一致,或指定如LogInterval(SQL Server特有)。
    • LocalLogRetentionHours: 设定本地日志保留小时数,默认18小时。
    • LocalLogRetentionSpace: 配置本地日志最大循环空间使用率,默认30%。
    • HighSpaceUsageProtection: 当实例空间使用率达到阈值时是否清理Binlog,可选EnableDisable
    • Duplication: 是否开启备份文件转储至OSS,可选EnableDisable
    • DuplicationContent: 指定转储内容为数据备份或日志备份,如DATALOG

注意事项

  • 权限验证:调用API前,请确保您的账号具有rds:ModifyBackupPolicy权限。
  • 参数兼容性:不同数据库引擎可能对某些参数有不同的支持情况,请参考官方文档确认。
  • 资源限制:账户余额需充足,且在修改策略前检查是否有其他配置冲突,如高级备份策略不可通过OpenAPI直接修改。

示例

假设您要为一个MySQL实例设置每天凌晨1点至2点进行数据备份,保留7天,并开启日志备份,日志本地保留18小时,您可以构造如下请求参数(具体值请根据实际情况调整):

Action=ModifyBackupPolicy
&DBInstanceId=rm-uf6wjk5****
&BackupPolicyMode=DataBackupPolicy
&PreferredBackupTime=01:00Z-02:00Z
&BackupRetentionPeriod=7
&EnableBackupLog=True
&LocalLogRetentionHours=18

引用与参考

此回答依据了提供的知识库参考资料中的关键信息。

通过以上步骤,您可以有效修改RDS实例的备份策略,确保数据得到妥善保护。如有进一步疑问或遇到问题,建议查阅阿里云官方文档或联系技术支持获取帮助。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答