全部产品
Search
文档中心

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

更新时间:Sep 11, 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

指定购买时长,取值:

  • 当参数 PeriodYear 时,UsedTime 取值为 1~5。
  • 当参数 PeriodMonth 时,UsedTime 取值为 1~11。
1
PayTypestring

支付方式,取值:

  • postpay:后付费(按量付费)
  • prepay:预付费(包年包月)
说明 默认 prepay,目前只有 BackupMethodduplication 时支持 postpay
postpay
DatabaseRegionstring

数据库地域。

说明 PayTypepostpay 时,该参数必选。
cn-hangzhou
StorageRegionstring

存储地域。

说明 PayTypepostpay 时,该参数必选。
cn-hangzhou
InstanceTypestring

数据库实例类型,取值:

  • RDS
  • PolarDB
  • DDS:阿里云 MongoDB
  • Kvstore:阿里云 Redis
  • Other:通过 IP:Port 接入的数据库
  • dg:无公网 IP:Port 的自建数据库(通过数据库网关 DG 接入)
说明 PayTypepostpay 时,必选。
RDS
StorageTypestring

该参数暂未开放使用。

FromAppstring

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

OpenApi
SourceEndpointInstanceTypestring

数据库所在位置,取值:

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

数据库地域。

说明 SourceEndpoint.InstanceTypeRDSECSDDSExpressAgent 时,该参数必传。
cn-hangzhou
SourceEndpointInstanceIDstring

数据库实例 ID。

说明 SourceEndpoint.InstanceTypeRDSECSDDSExpress 时,该参数必传。
rm-uf6wjk5xxxxxxxxxx
SourceEndpointIPstring

数据库连接地址。

说明 SourceEndpoint.InstanceTypeexpressagentother 时,该参数必传。
rm-uf6wjk5xxxxxxx.mysql.rds.aliyuncs.com
SourceEndpointPortinteger

数据库端口。

说明 SourceEndpoint.InstanceTypeexpressagentotherECS 时,该参数必传。
3306
SourceEndpointDatabaseNamestring

数据库名称。

说明 数据库类型为 PostgreSQLMongoDB 时,该参数必传。
testRDS
SourceEndpointUserNamestring

数据库账号。

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

密码。

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

备份网关 ID。

说明
  • SourceEndpoint.InstanceTypeagent 时,该参数必传。
  • 如何创建备份网关,请参见添加备份网关
  • 您可以通过 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控制台进行授权后再执行操作

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

    变更历史

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