查看备份列表

DescribeDBBackups 查看备份列表

查看数据库备份列表。

请求方式

GET

请求参数

英文名称	中文名称	类型	是否必须	备注
Action	调用接口名称	String	是	取固定值：DescribeDBBackups
Version	API版本号	String	是	取固定值：2016-07-01
DBInstanceIdentifier	实例Id	String	是
BackupType	数据库快照类型	String	否	数据库快照类型，取值范围：AutoBackup（自动产生的备份）、Snapshot（手动发起的备份）
Keyword	备份搜索关键字	String	否	备份搜索关键字（根据备份名字）
Marker	获取记录开始偏移量	String	否	默认：0，获取记录开始偏移量 default=0
MaxRecords	每页结果中包含的最大条数	Integer	否	默认：10，每页结果中包含的最大条数 区间 [10,100]

返回值

英文名称	中文名称	类型	备注
RequestId	请求id	String
Data		Object
Data.DBBackup	返回的备份列表	List
Data.TotalCount	备份总条数	Integer
Data.MaxRecords	每页展示条数	Integer
Data.Marker	下次查询开始条数	Integer

Data.DBBackup：

英文名称	中文名称	类型	备注
DBInstanceIdentifier	所属实例id	String
DBBackupIdentifier	备份id	String
Engine	数据库引擎	String
EngineVersion	数据库引擎版本	String
BackupCreateTime	备份创建时间	String
BackupUpdatedTime	备份修改时间	String
DBBackupName	备份名称	String
BackupMode	备份模式，全量FULL_AMOUNT_BACKUP，INCREMENTAL_BACKUP	String
BackupType	备份类型，手动Snapshot，自动AutoBackup	String
Status	备份状态	String
BackupSize	备份大小，单位MB	String
BackupLocationRef	备份远端地址	String
RemotePath	备份下载URL	String
MD5	MD5码	String

请求示例

http://krds.{{region}}.api.ksyun.com/?Action=DescribeDBBackups&Version=2016-07-01&DBInstanceIdentifier=f241bdf4-ee5a-4974-ac5d-4f5f256b339a

示例返回

{
    "Data": {
        "DBBackup": [
            {
                "DBInstanceIdentifier": "f241bdf4-ee5a-4974-ac5d-4f5f256b339a",
                "DBBackupIdentifier": "96388ab7-5807-4e9c-a9b7-78d4488c7208",
                "Engine": "mysql",
                "EngineVersion": "5.7",
                "BackupCreateTime": "2021-08-04T11:31:53+0800",
                "BackupUpdatedTime": "2021-08-04T11:32:00+0800",
                "DBBackupName": "kingsoft_test_create",
                "Description": "测试",
                "BackupMode": "FULL_AMOUNT_BACKUP",
                "BackupType": "Snapshot",
                "Status": "COMPLETED",
                "BackupSize": 1.62,
                "BackupLocationRef": "/ks3nosplit/snapshot/9be54af7-1bf0-4227-b122-ac9cc908b8c2/96388ab7-5807-4e9c-a9b7-78d4488c7208",
                "RemotePath": "http://ks3-cn-beijing.ksyun.com/krds-beijing6-vpc/rds/openstack/lxc_data/a8a23bb584db408db24efd22a3bfd0b1/snapshot/9be54af7-1bf0-4227-b122-ac9cc908b8c2/96388ab7-5807-4e9c-a9b7-78d4488c7208/96388ab7-5807-4e9c-a9b7-78d4488c7208.xbstream?AccessKeyId=bCPubcaLG5jstVnENKm%2F&Expires=1628059446&Signature=rhkfxwSVtjyVhG7JorrEJzqxzSU%3D",
                "MD5": "aed91d2cb5bc8e08b419dd9b462cddca"
            },
            {
                "DBInstanceIdentifier": "f241bdf4-ee5a-4974-ac5d-4f5f256b339a",
                "DBBackupIdentifier": "faf13789-eb40-4514-9406-9bb8e9af09da",
                "Engine": "mysql",
                "EngineVersion": "5.7",
                "BackupCreateTime": "2021-08-04T02:05:15+0800",
                "BackupUpdatedTime": "2021-08-04T02:05:24+0800",
                "DBBackupName": "autobackup-20210804020514",
                "BackupMode": "FULL_AMOUNT_BACKUP",//FULL_AMOUNT_BACKUP:全量；INCREMENTAL_BACKUP:增量
                "BackupType": "AutoBackup", //Snapshot:手动；AutoBackup:自动
                "Status": "COMPLETED",
                "BackupSize": 1.49,
                "BackupLocationRef": "/ks3nosplit/backup/9be54af7-1bf0-4227-b122-ac9cc908b8c2/faf13789-eb40-4514-9406-9bb8e9af09da",
                "RemotePath": "http://ks3-cn-beijing.ksyun.com/krds-beijing6-vpc/rds/openstack/lxc_data/a8a23bb584db408db24efd22a3bfd0b1/backup/9be54af7-1bf0-4227-b122-ac9cc908b8c2/faf13789-eb40-4514-9406-9bb8e9af09da/faf13789-eb40-4514-9406-9bb8e9af09da.xbstream?AccessKeyId=bCPubcaLG5jstVnENKm%2F&Expires=1628059446&Signature=%2Ft12X94XwoL0spU02XlxgtxNHK8%3D",
                "MD5": "0c77d19347c4435bb805b2c415099684"
            }
        ],
        "TotalCount": 2,
        "MaxRecords": 10
    },
    "RequestId": "b51dabb8-04a1-4277-b91a-ae121e33d00d"
}