查看PolarDB集群的自动备份策略。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
polardb:DescribeBackupPolicy |
get |
*dbcluster
|
无 | 无 |
请求参数
名称 |
类型 |
必填 |
描述 |
示例值 |
DBClusterId |
string |
是 |
集群 ID。 说明
您可以调用 DescribeDBClusters 接口查看目标地域下所有的集群信息,包括集群 ID。 |
pc-************* |
返回参数
名称 |
类型 |
描述 |
示例值 |
object |
|||
PreferredBackupPeriod |
string |
数据备份周期,取值范围如下:
|
Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday |
DataLevel1BackupRetentionPeriod |
string |
一级备份保留周期,取值范围为 3~14,单位为天。 |
7 |
RequestId |
string |
请求 ID。 |
EADFCE0F-9FB5-4685-B395-1440B****** |
PreferredBackupTime |
string |
执行自动备份的时间段,格式为 |
07:00Z-08:00Z |
BackupRetentionPolicyOnClusterDeletion |
string |
删除集群时是否保留备份:
|
NONE |
PreferredNextBackupTime |
string |
下一次备份的时间,格式为 |
2020-11-16T07:30Z |
DataLevel2BackupRetentionPeriod |
string |
二级备份保留周期,取值范围如下:
说明
创建集群时,默认取值为 0,即关闭二级备份功能。 |
0 |
BackupFrequency |
string |
备份频率,取值如下:
说明
|
Normal |
DataLevel1BackupFrequency |
string |
备份频率,取值如下:
说明
|
Normal |
DataLevel1BackupPeriod |
string |
一级备份周期,取值范围如下:
说明
|
Monday,Tuesday |
DataLevel1BackupTime |
string |
执行自动备份的时间段,格式为 说明
|
15:00Z-16:00Z |
DataLevel2BackupPeriod |
string |
二级备份周期,取值范围如下:
说明
|
Monday,Tuesday |
DataLevel2BackupAnotherRegionRetentionPeriod |
string |
二级备份跨地域备份保留周期。取值范围如下:
说明
创建集群时,默认取值为 0,即关闭二级备份跨地域备份功能。 |
30 |
DataLevel2BackupAnotherRegionRegion |
string |
二级备份跨地域备份区域。跨地域备份支持的地域请参见概述。 |
cn-hangzhou |
BackupPolicyLevel |
string |
当前备份策略等级。取值范围如下:
说明
|
Normal |
AdvancedPolicyOption |
string |
高级备份策略选项。取值范围如下:
说明
|
disable |
AdvancedDataPolicies |
object |
||
AdvancedDataPolicy |
array<object> |
高级备份策略详情。 说明
|
|
object |
|||
OnlyPreserveOneEachHour |
boolean |
每小时备份保留策略。取值如下:
|
true |
RetentionValue |
string |
备份保留天数。 |
7 |
BakType |
string |
备份类型,返回值如下:
|
F |
FilterKey |
string |
调度类型,返回值如下:
说明
仅当 FilterType 为 crontab 时,返回该参数。 |
dayOfWeek |
FilterValue |
string |
备份周期。 |
1,2,3,4,5,6,7 |
DestType |
string |
备份策略目标类型,取值如下:
|
|
FilterType |
string |
高级策略筛选类型,返回值如下:
|
crontab |
SrcRegion |
string |
备份策略源地域。 |
cn-beijing |
AutoCreated |
boolean |
是否为系统自动生成的备份策略,返回值如下:
|
true |
SrcType |
string |
备份策略源类型,返回值如下:
|
level1 |
OnlyPreserveOneEachDay |
boolean |
24 小时备份保留策略。
|
true |
DumpAction |
string |
一级备份转二级备份方式,返回值如下:
|
copy |
PolicyId |
string |
备份策略 ID。 |
71930ac2e9f15e41615e10627c****** |
DestRegion |
string |
备份策略目标地域。 |
cn-hangzhou |
RetentionType |
string |
备份集保留周期类型,返回值如下:
|
delay |
示例
正常返回示例
JSON
格式
{
"PreferredBackupPeriod": "Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday",
"DataLevel1BackupRetentionPeriod": "7",
"RequestId": "EADFCE0F-9FB5-4685-B395-1440B******",
"PreferredBackupTime": "07:00Z-08:00Z",
"BackupRetentionPolicyOnClusterDeletion": "NONE",
"PreferredNextBackupTime": "2020-11-16T07:30Z",
"DataLevel2BackupRetentionPeriod": "0",
"BackupFrequency": "Normal",
"DataLevel1BackupFrequency": "Normal",
"DataLevel1BackupPeriod": "Monday,Tuesday",
"DataLevel1BackupTime": "15:00Z-16:00Z",
"DataLevel2BackupPeriod": "Monday,Tuesday",
"DataLevel2BackupAnotherRegionRetentionPeriod": "30",
"DataLevel2BackupAnotherRegionRegion": "cn-hangzhou",
"BackupPolicyLevel": "Normal",
"AdvancedPolicyOption": "disable",
"AdvancedDataPolicies": {
"AdvancedDataPolicy": [
{
"OnlyPreserveOneEachHour": true,
"RetentionValue": "7",
"BakType": "F",
"FilterKey": "dayOfWeek",
"FilterValue": "1,2,3,4,5,6,7",
"DestType": "",
"FilterType": "crontab",
"SrcRegion": "cn-beijing",
"AutoCreated": true,
"SrcType": "level1",
"OnlyPreserveOneEachDay": true,
"DumpAction": "copy",
"PolicyId": "71930ac2e9f15e41615e10627c******\n",
"DestRegion": "cn-hangzhou",
"RetentionType": "delay"
}
]
}
}
错误码
HTTP status code |
错误码 |
错误信息 |
描述 |
---|---|---|---|
400 | InvalidDBClusterId.Malformed | The specified parameter DBClusterId is not valid. | |
404 | InvalidDBCluster.NotFound | The DBClusterId provided does not exist in our records. | 当前的记录中不存在提供的DBClusterId。 |
404 | InvalidDBClusterId.NotFound | The DBInstanceId provided does not exist in our records. | 当前的记录中不存在提供的DBClusterId。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。