全部产品
Search

搜索本产品

    数据库备份 DBS：ConfigureBackupPlan - 配置备份计划

    文档中心

    数据库备份 DBS：ConfigureBackupPlan - 配置备份计划

    更新时间：Nov 14, 2024

    该接口用于配置一个DBS备份计划。

    调试

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

    授权信息

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

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

    请求参数

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

    备份计划 ID，可通过调用 DescribeBackupPlanList 接口获取该参数的值。

    		dbstooi0*******
    SourceEndpointInstanceTypestring是

    数据库所在位置，可通过调用 DescribeBackupPlanList 接口获取该参数的值。取值如下：

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

    数据库地域，可通过调用 DescribeBackupPlanList 接口获取该参数的值。

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

    数据库实例 ID，可通过调用 DescribeBackupPlanList 接口获取该参数的值。

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

    数据库连接地址，可通过调用 DescribeBackupPlanList 接口获取该参数的值。

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

    数据库端口，可通过调用 DescribeBackupPlanList 接口获取该参数的值。

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

    数据库名称，可通过调用 DescribeBackupPlanList 接口获取该参数的值。

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

    数据库账号。

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

    密码。

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

    备份网关 ID，可通过调用 DescribeBackupPlanList 接口获取该参数的值。

    说明 SourceEndpointInstanceType 为 agent 时，该参数必传。
    		23313123312
    OSSBucketNamestring否

    OSS Bucket 名称。

    说明 系统默认自动生成新的名称。
    		TestOssBucket
    BackupObjectsstring否

    备份对象，可通过调用 DescribeBackupPlanList 接口获取该参数的值。

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

    全量备份周期，取值：

    • Monday：周一
    • Tuesday：周二
    • Wednesday：周三
    • Thursday：周四
    • Friday：周五
    • Saturday：周六
    • Sunday：周日
    		Monday
    BackupStartTimestring否

    全量备份开始时间，格式为HH:mmZ（UTC 时间）。可通过调用 DescribeBackupPlanList 接口获取该参数的值。

    		14:22
    EnableBackupLogboolean否

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

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

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

    说明 仅支持物理备份。
    		1000
    BackupRetentionPeriodinteger否

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

    		730
    DuplicationInfrequentAccessPeriodinteger否

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

    		180
    DuplicationArchivePeriodinteger否

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

    		365
    BackupPlanNamestring是

    自定义备份计划名称，可通过调用 DescribeBackupPlanList 接口获取该参数的值。

    		dbstooi0*******
    SourceEndpointOracleSIDstring否

    Oracle SID 名称。

    说明 数据库类型为 Oracle 时，该参数必传。
    		test
    BackupStorageTypestring否

    内置存储类型：

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

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

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

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

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

    全量备份周期，取值：

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

    跨阿里云账号备份的 UID，可通过调用 DescribeRestoreTaskList 接口获取该参数的值。

    		2xxx7778xxxxxxxxxx
    CrossRoleNamestring否

    跨阿里云账号备份的 RAM 角色名称，可通过调用 DescribeRestoreTaskList 接口获取该参数的值。

    		test123
    AutoStartBackupboolean否

    是否开启自动备份。

    • true：开启
    • false：不开启
    		false
    ClientTokenstring否

    用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过 64 个 ASCII 字符，且该参数值中不能包含非 ASCII 字符。

    		ETnLKlblzczshOTUbOCzxxxxxxx
    ResourceGroupIdstring否

    资源组 ID。

    		rg-aekzecovzti****

    返回参数

    名称类型描述示例值
    object

    详情信息如下。

    HttpStatusCodeinteger

    HTTP 状态码。

    		200
    RequestIdstring

    请求 ID。

    		F1FB49D4-B504-47F1-9F43-D7EAB33F****
    ErrCodestring

    错误码。

    		Param.NotFound
    Successboolean

    请求是否成功，返回值如下：

    • true：请求成功
    • false：请求失败
    		true
    ErrMessagestring

    错误信息。

    		The specified parameter %s value is not valid.
    BackupPlanIdstring

    备份计划 ID。

    		dbstooi01ex****

    示例

    正常返回示例

    JSON格式

    {
  "HttpStatusCode": 200,
  "RequestId": "F1FB49D4-B504-47F1-9F43-D7EAB33F****",
  "ErrCode": "Param.NotFound",
  "Success": true,
  "ErrMessage": "The specified parameter %s value is not valid.     ",
  "BackupPlanId": "dbstooi01ex****"
}

    错误码

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

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

    变更历史

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