全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

查看备份列表

最近更新时间:2022-01-19 17:03:32

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"
}
文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈