修改备份对象_备份计划_API参考_数据库备份 DBS-阿里云

描述

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

请求参数

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

BackupObjects 参数定义

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

BackupObjects 的定义如下：

[
    {
        "DBName":"待备份库名",
        "SchemaName":"待备份 Schema 名",
        "TableIncludes":[{
            "TableName":"待备份表表名"
        }],
        "TableExcludes":[{
            "TableName":"待备份库名不需要备份表的表名"
        }]
    }
]

其中：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.	修改备份对象失败