CreateBackup
该接口用于为RDS实例创建一个备份集
服务地址:
华东1 金融云
输入参数
只看必填
DBInstanceId实例ID
DBName数据库列表
BackupStrategy备份策略
BackupMethod备份类型
BackupType备份方式
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

适用引擎

  • RDS MySQL
  • RDS PostgreSQL
  • RDS SQL Server
  • RDS MariaDB

功能说明

本接口调用的是 RDS 自带的备份功能接口,您也可以使用 DBS。更多信息,请参见DBS API 概览

注意事项

调用该接口时,实例必须满足以下条件,否则将操作失败:

  • 实例状态为运行中。
  • 没有正在执行中的备份任务。
  • 单个实例一天内可创建的备份集数量不超过 20 个。

相关功能文档

请求参数

字段名称字段详情
DBInstanceIdstring

实例 ID。可调用 DescribeDBInstances 获取。

示例值:rm-uf6wjk5****参考取值来源:
    CloneDBInstance
    CreateDBInstance
    ReceiveDBInstance
    ModifyDBInstanceSpec
    RecoveryDBInstance
    DescribeDBInstances
    CalculateDBInstanceWeight
    MigrateDBNodes
    UpgradeDBInstanceMajorVersion
    TransformDBInstancePayType
    EvaluateLocalExtendDisk
    RestoreDdrTable
    RebuildReplicationLink
DBNamestring

数据库列表,多个数据库之间用英文逗号(,)隔开。展开详情

示例值:rds_mysql
BackupStrategystring

备份策略,取值:展开详情

示例值:db
BackupMethodstring

备份类型,取值:展开详情

示例值:Physical参考取值来源:
    DescribeDetachedBackups
BackupTypestring

备份方式,取值:展开详情

示例值:Auto参考取值来源:
    DescribeBackups

请求说明

如何填写可选参数

该 API 存在四个可选参数:BackupMethod、BackupStrategy、BackupType 和 DBName,对于不同引擎和使用场景,需要搭配不同的可选参数。

MySQL

  • 物理备份、快照备份:仅需填写 BackupMethod,默认备份所有库,不支持单库备份。
  • 逻辑备份:
    • 单库:需填写 BackupMethod、BackupStrategy 和 DBName。
    • 整实例:需填写 BackupMethod 和 BackupStrategy。

SQL Server

  • 快照备份:仅需填写 BackupMethod,默认备份所有库,不支持单库备份。
  • 物理备份:
    • 单库全量:四个可选参数均需填写
    • 整实例全量:需填写 BackupMethod、BackupType 和 BackupStrategy。
    • 系统自动判断增量或全量备份:需填写 BackupMethod 和 BackupType。
  • 逻辑备份:不支持。

PostgreSQL

  • 物理备份、快照备份:仅需填写 BackupMethod,默认备份所有库,不支持单库备份。
  • 逻辑备份:不支持。

MariaDB

  • 快照备份:仅需填写 BackupMethod,默认备份所有库,不支持单库备份。
  • 物理备份、逻辑备份:不支持。

返回参数

字段名称字段详情
BackupJobIdstring

备份任务 ID。

示例值:507****
RequestIdstring

请求 ID。

示例值:2C125605-266F-41CA-8AC5-3A643D4F42C5
变更历史
暂无变更历史