全部产品
云市场

修改备份对象

更新时间:2019-05-19 07:05:36

描述

修改一个DBS备份计划的备份对象。

请求参数

名称 类型 是否必选 描述
Action String 系统规定参数,取值:ModifyBackupObjects
BackupPlanId String 备份计划ID
BackupObjects String 备份对象,详见下面的BackupObjects参数定义

BackupObjects 参数定义

BackupObjects 的定义格式为 JSON 字符串,且对象配置支持一定的正则表达式。

BackupObjects 的定义如下:

  1. [
  2. {
  3. "DBName":"待备份库名",
  4. "SchemaName":"待备份 Schema 名",
  5. "TableIncludes":[{
  6. "TableName":"待备份表表名"
  7. }],
  8. "TableExcludes":[{
  9. "TableName":"待备份库名不需要备份表的表名"
  10. }]
  11. }
  12. ]

其中:SchemaName 和 NewSchemaName 只用于 MSSQL,其他数据库的库名定义使用 DBName 和 NewDBName 这个参数。

当用户只配置了 DBName,不配置其他子对象的规则,那么表示迁移这个数据库下面的所有对象。

当用户配置了 DBName,且配置了部分对象的规则,那么不配置的对象默认不迁移。各种对象名的定义可以支持如下的正则表达式:

  • 点号 . 表示匹配除 ‘\r\n’ 之外的任何单个字符
  • 星号 表示匹配前面子表达式任意次,h.llo 匹配 hllo, heeeello 等字符串
  • 问号 ? 表示匹配前面子表达式零次或1次,h.?llo 匹配 hllo,hello,但不能匹配 haello
  • [characters] 字符集合,表示匹配方括号内任意一个字符,例如 h[aello] 匹配 hallo, hello
  • [^characters] 负值字符集合,表示不匹配方括号内任意一个字符,例如 h[^ae]llo 匹配 hcllo,hdllo,但是不能匹配 hallo,hello
  • [character1-character2] 字符范围,表示 character1-character2 范围内的字符都可以匹配,例如 [0-9],[a-z]

返回参数

名称 类型 描述
BackupPlanId String 备份计划ID
NeedPrecheck Boolean 本次修改是否会触发预检查,如果为true则需要再调用StartBackupPlan接口启动备份计划

错误码

错误码 错误信息 描述
BackupPlanNotModify modify backup objects fail. 修改备份对象失败