全部产品
Search

搜索本产品

    数据库备份 DBS：CreateAndStartBackupPlan - 创建并启动备份计划

    文档中心

    数据库备份 DBS：CreateAndStartBackupPlan - 创建并启动备份计划

    更新时间：Nov 14, 2024

    该接口用于创建、配置并启动备份计划。

    接口说明

    请确保在使用该接口前，已充分了解数据库备份 DBS 产品的收费方式和价格。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。
    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
      • 对于必选的资源类型，用背景高亮的方式表示。
      • 对于不支持资源级授权的操作，用全部资源表示。
    • 条件关键字：是指云产品自身定义的条件关键字。
    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
    操作访问级别资源类型条件关键字关联操作
    dbs:CreateAndStartBackupPlancreate
    • 全部资源
      *
      无
    		无

    请求参数

    名称类型必填描述示例值
    BackupPlanIdstring否

    备份计划 ID。

    		dbstooi0*******
    Regionstring否

    DBS 支持地域，可调用 DescribeRegions 接口查看。

    		cn-hangzhou
    InstanceClassstring是

    备份计划的规格，取值：

    • micro
    • small
    • medium
    • large
    • xlarge
    说明 规格越高，备份与恢复的性能越高。更多信息，请参见规格说明。
    		micro
    DatabaseTypestring是

    数据库类型，取值：

    • MySQL
    • MSSQL
    • Oracle
    • MariaDB
    • PostgreSQL
    • DRDS
    • MongoDB
    • Redis
    		MySQL
    BackupMethodstring是

    备份方式，取值：

    • logical：逻辑备份
    • physical：物理备份
    • duplication：转储备份
    		logical
    Periodstring否

    指定预付费实例为包年或者包月类型，取值：

    • Year：包年
    • Month：包月
    		Year
    UsedTimeinteger否

    指定购买时长，取值：

    • 当参数 Period 为 Year 时，UsedTime 取值为 1~5。
    • 当参数 Period 为 Month 时，UsedTime 取值为 1~11。
    		1
    PayTypestring否

    支付方式，取值：

    • postpay：后付费（按量付费）
    • prepay：预付费（包年包月）
    说明 默认 prepay，目前只有 BackupMethod 为 duplication 时支持 postpay。
    		postpay
    DatabaseRegionstring否

    数据库地域。

    说明 当 PayType 为 postpay 时，该参数必选。
    		cn-hangzhou
    StorageRegionstring否

    存储地域。

    说明 当 PayType 为 postpay 时，该参数必选。
    		cn-hangzhou
    InstanceTypestring否

    数据库实例类型，取值：

    • RDS
    • PolarDB
    • DDS：阿里云 MongoDB
    • Kvstore：阿里云 Redis
    • Other：通过 IP:Port 接入的数据库
    • dg：无公网 IP:Port 的自建数据库（通过数据库网关 DG 接入）
    说明 当 PayType 为 postpay 时，必选。
    		RDS
    StorageTypestring否

    该参数暂未开放使用。

    		无
    FromAppstring否

    用于备注请求来源，默认值为 OpenApi，无需手动设置。

    		OpenApi
    SourceEndpointInstanceTypestring是

    数据库所在位置，取值：

    • RDS
    • ECS
    • Express：通过专线/VPN 网关/智能网关接入的数据库
    • Agent：通过备份网关接入的数据库
    • DDS：云 MongoDB
    • Other：通过 IP:Port 直连的数据库
    • dg：无公网 IP:Port 的自建数据库（通过数据库网关 DG 接入）
    		RDS
    SourceEndpointRegionstring否

    数据库地域。

    说明 SourceEndpoint.InstanceType 为 RDS、ECS、DDS、Express、Agent 时，该参数必传。
    		cn-hangzhou
    SourceEndpointInstanceIDstring否

    数据库实例 ID。

    说明 SourceEndpoint.InstanceType 为 RDS、ECS、DDS、Express 时，该参数必传。
    		rm-uf6wjk5xxxxxxxxxx
    SourceEndpointIPstring否

    数据库连接地址。

    说明 SourceEndpoint.InstanceType 为 express、agent、other 时，该参数必传。
    		rm-uf6wjk5xxxxxxx.mysql.rds.aliyuncs.com
    SourceEndpointPortinteger否

    数据库端口。

    说明 SourceEndpoint.InstanceType 为 express、agent、other、ECS 时，该参数必传。
    		3306
    SourceEndpointDatabaseNamestring否

    数据库名称。

    说明 数据库类型为 PostgreSQL、MongoDB 时，该参数必传。
    		testRDS
    SourceEndpointUserNamestring否

    数据库账号。

    说明 数据库类型为 Redis，或者数据库所在位置为 agent 且数据库类型为 MSSQL 时该参数非必须，其他场景均必传。
    		testRDS
    SourceEndpointPasswordstring否

    密码。

    说明 数据库类型为 Redis，或者数据库所在位置为 agent 且数据库类型为 MSSQL 时该参数非必须，其他场景均必传。
    		testPassword
    BackupGatewayIdlong否

    备份网关 ID。

    说明
  • SourceEndpoint.InstanceType 为 agent 时，该参数必传。
  • 如何创建备份网关，请参见添加备份网关。
  • 您可以通过 DescribeBackupGatewayList 查看已有备份网关列表。
    •
    		23313123312
    OSSBucketNamestring否

    OSS Bucket 名称。 默认：系统自动生成新的名称。

    		TestOssBucket
    BackupObjectsstring否

    备份对象。

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

    全量备份周期，取值：

    • Monday：周一
    • Tuesday：周二
    • Wednesday：周三
    • Thursday：周四
    • Friday：周五
    • Saturday：周六
    • Sunday：周日
    说明 支持选择多个取值，用英文逗号（,）分开。
    		Monday
    BackupStartTimestring否

    全量备份开始时间，格式为HH:mm（UTC 时间）。

    		14:22
    EnableBackupLogboolean否

    是否开启增量日志备份，取值：

    • true：开启
    • false：关闭
    		true
    BackupLogIntervalSecondsinteger否

    增量时间间隔，以秒（s）为单位。

    说明 仅选择物理备份时需要传入该参数。
    		1000
    BackupRetentionPeriodinteger否

    备份数据保留时间，取值：0~1825，默认为 730 天。

    		730
    DuplicationInfrequentAccessPeriodinteger否

    转为低频访问存储时间，默认为 180 天。

    		180
    DuplicationArchivePeriodinteger否

    转为归档冷备存储时间，默认为 365 天。

    		365
    BackupPlanNamestring是

    自定义备份计划名称。

    		dbstooi0*******
    SourceEndpointOracleSIDstring否

    Oracle SID 名称，数据库类型为 Oracle 时，该参数必传。

    		test
    BackupStorageTypestring否

    内置存储类型：

    • 空（默认）：备份数据存储在用户 OSS 上。
    • system ：备份数据存储在 DBS 的内置 OSS 上。
    		无
    BackupSpeedLimitlong否

    磁盘 IO 限制， 单位为 KB/s。

    说明 该参数仅对 MySQL 物理备份生效。
    		262144
    BackupRateLimitlong否

    网络带宽限制，单位为 KB/s，最大允许 10 GB。

    说明 该参数仅对 MySQL 物理备份生效。
    		262144
    BackupStrategyTypestring否

    全量备份周期，取值：

    • simple：周期备份，和 BackupPeriod、BackupStartTime 配合使用。
    • manual：手动备份。
    说明 默认为 simple。
    		simple
    CrossAliyunIdstring否

    跨阿里云账号备份的 UID。

    		1648821913******
    CrossRoleNamestring否

    跨阿里云账号备份的 RAM 角色名称。

    		test123
    ClientTokenstring否

    用于保证请求的幂等性，防止重复提交请求。

    		ASDASDASDSADASFCZXVZ
    ResourceGroupIdstring否

    资源组 ID。

    		rg-aekzecovzti****

    返回参数

    名称类型描述示例值
    object

    返回参数详情如下。

    HttpStatusCodeinteger

    HTTP 状态码。

    		200
    RequestIdstring

    请求 ID。

    		4F1888AC-1138-4995-B9FE-D2734F61C058
    CreateBackupSetboolean

    是否开启备份集，返回值如下：

    • true：开启
    • false：关闭
    		true
    ErrCodestring

    错误码。

    		Param.NotFound
    Successboolean

    是否请求成功。

    		true
    ErrMessagestring

    错误信息。

    		The specified parameter %s value is not valid.
    BackupPlanIdstring

    备份计划 ID。

    		dbs1hvb0wwwe****
    OrderIdstring

    订单 ID。

    		2056157***

    示例

    正常返回示例

    JSON格式

    {
  "HttpStatusCode": 200,
  "RequestId": "4F1888AC-1138-4995-B9FE-D2734F61C058",
  "CreateBackupSet": true,
  "ErrCode": "Param.NotFound",
  "Success": true,
  "ErrMessage": "The specified parameter %s value is not valid.",
  "BackupPlanId": "dbs1hvb0wwwe****",
  "OrderId": "2056157***"
}

    错误码

    HTTP status code错误码错误信息描述
    403Request.ForbiddenHave no Permissions当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作

    访问错误中心查看更多错误码。

    变更历史

    变更时间变更内容概要操作
    暂无变更历史