Queries the backup sets of an ApsaraDB for RDS instance.

Note A backup set can be used to restore data only when its BackupStatus is Success.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeBackups

The operation that you want to perform. Set the value to DescribeBackups.

DBInstanceId String Yes rm-uf6wjk5xxxxxxx

The ID of the instance.
BackupId String No 327329803

The ID of the specific backup set to query.
BackupStatus String No Success

The status of the backup sets. Valid values:

  • Success
  • Failed
BackupMode String No Automated

The mode that is used to generate the backup sets. Valid values:

  • Automated
  • Manual
StartTime String No 2011-06-01T16:00Z

The beginning of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mmZ format. The time must be in UTC.

EndTime String No 2011-06-15T16:00Z

The end of the time range to query. The end time must be later than the start time. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mmZ format. The time must be in UTC.

PageSize Integer No 30

The number of entries to return on each page. Valid values:

  • 30
  • 50
  • 100

Default value: 30.

PageNumber Integer No 1

The number of the page to return. Pages start from page 1.

Default value: 1.

Response parameters

Parameter Type Example Description
RequestId String 1A6D328C-84B8-40DC-BF49-6C73984D7494

The ID of the request.
TotalRecordCount String 100

The total number of entries returned.
PageNumber String 1

The page number of the returned page.
PageRecordCount String 30

The number of backup sets returned on the current page.
Items Array

An array that consists of backup sets.
BackupId String 321020562

The ID of the backup set.
DBInstanceId String rm-uf6wjk5xxxxxxx

The ID of the instance.
BackupStatus String Success

The status of the backup set.
BackupStartTime String 2019-02-03T12:20:00Z

The start time of the backup. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mmZ format. The time is displayed in UTC.

BackupEndTime String 2019-02-13T12:20:00Z

The end time of the backup. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mmZ format. The time is displayed in UTC.

BackupType String FullBackup

The type of the backup. Valid values:

  • FullBackup
  • IncrementalBackup
BackupMode String Automated

The mode that is used to generate the backup set. Valid values:

  • Automated
  • Manual
BackupMethod String Physical

The method that is used to create the backup set. Valid values:

  • Logical
  • Physical
BackupDownloadURL String http://rdsbak-hz-v3.oss-cn-hangzhou.aliyuncs.com/xxxxx

The URL from which the backup set can be downloaded over the Internet. If the backup set cannot be downloaded over the Internet, a null string is returned.

BackupIntranetDownloadURL String http://rdsbak-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/xxxxx

The URL from which the backup set can be downloaded over an internal network. If the backup set cannot be downloaded an internal network, a null string is returned.

BackupSize Long 2167808

The size of the backup files in the backup set. Unit: bytes.
HostInstanceID String 5882781

The ID of the instance on which the backup set is generated. This parameter is used to determine whether the backup set is generated on a primary or secondary instance.

StoreStatus String Disabled

Indicates whether the backup set can be deleted. Valid values:

  • Enabled: The backup set can be deleted.
  • Disabled: The backup set cannot be deleted.
MetaStatus String OK

The status of the backup set that is used to restore databases and tables. Valid values:

  • OK: The backup set is normal.
  • LARGE: The backup set contains an abnormally large number of tables and cannot be used to restore databases or tables.
  • EMPTY: The backup set is generated from a failed backup.
Note If a null string is returned, database- and table-level restoration is disabled for the backup set.
ConsistentTime Long 1576506856

The point in time at which the data in the backup set is consistent. The value returned for this parameter is a timestamp.

Note If the instance is running MySQL 5.6, a timestamp is returned. Otherwise, the value 0 is returned.
BackupInitiator String System

The user who created the backup task. Valid values:

  • System
  • User

Examples

Sample requests

http(s)://rds.aliyuncs.com/? Action=DescribeBackups
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<Common request parameters>

Sample success responses

XML format 

<DescribeBackupsResponse>
      <Items>
            <Backup>
                  <StoreStatus>Disabled</StoreStatus>
                  <HostInstanceID>5882781</HostInstanceID>
                  <BackupLocation>OSS</BackupLocation>
                  <BackupIntranetDownloadURL>http://rdsbak-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/custins10430291/hins5882781_data_20190213201955.tar.gz?OSSAccessKeyId=xxxxxxxx&amp;Expires=1231230&amp;Signature=zIBwxxxxxxx5ga3p%2BVxxxxxxxx%3D</BackupIntranetDownloadURL>
                  <BackupType>FullBackup</BackupType>
                  <DBInstanceId>rm-uf6wjk5xxxxxxx</DBInstanceId>
                  <BackupEndTime>2019-02-13T12:22:53Z</BackupEndTime>
                  <BackupMethod>Physical</BackupMethod>
                  <BackupId>321020562</BackupId>
                  <BackupStartTime>2019-02-13T12:20:37Z</BackupStartTime>
                  <BackupDownloadURL>http://rdsbak-hz-v3.oss-cn-hangzhou.aliyuncs.com/custins10430291/hins5882781_data_20190213201955.tar.gz?OSSAccessKeyId=xxxxxxx&amp;Expires=1231230&amp;Signature=zIBwxxxxxxxxUs5ga3p%2BVxxxxxxxk%3D</BackupDownloadURL>
                  <MetaStatus></MetaStatus>
                  <BackupDBNames>spdb,sys,test20181221,test-20181228,test_20181115,test_20181116</BackupDBNames>
                  <BackupMode>Automated</BackupMode>
                  <BackupSize>2167808</BackupSize>
                  <BackupStatus>Success</BackupStatus>
                  <BackupScale>DBInstance</BackupScale>
            </Backup>
      </Items>
      <TotalBackupSize>8672256</TotalBackupSize>
      <PageNumber>1</PageNumber>
      <TotalRecordCount>1</TotalRecordCount>
      <RequestId>B0E0F374-919F-4BD9-BCAC-AE68122A0D68</RequestId>
      <PageRecordCount>1</PageRecordCount>
</DescribeBackupsResponse>

JSON format 

{
    "Items": {
        "Backup": [
            {
                "StoreStatus": "Disabled",
                "HostInstanceID": 5882781,
                "BackupLocation": "OSS",
                "BackupIntranetDownloadURL": "http://rdsbak-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/custins10430291/hins5882781_data_20190213201955.tar.gz?OSSAccessKeyId=xxxxxxxx&Expires=1231230&Signature=zIBwxxxxxxx5ga3p%2BVxxxxxxxx%3D",
                "BackupType": "FullBackup",
                "DBInstanceId": "rm-uf6wjk5xxxxxxx",
                "BackupEndTime": "2019-02-13T12:22:53Z",
                "BackupMethod": "Physical",
                "BackupId": 321020562,
                "BackupStartTime": "2019-02-13T12:20:37Z",
                "BackupDownloadURL": "http://rdsbak-hz-v3.oss-cn-hangzhou.aliyuncs.com/custins10430291/hins5882781_data_20190213201955.tar.gz?OSSAccessKeyId=xxxxxxx&Expires=1231230&Signature=zIBwxxxxxxxxUs5ga3p%2BVxxxxxxxk%3D",
                "MetaStatus": "",
                "BackupDBNames": "spdb,sys,test20181221,test-20181228,test_20181115,test_20181116",
                "BackupMode": "Automated",
                "BackupSize": 2167808,
                "BackupStatus": "Success",
                "BackupScale": "DBInstance"
            }
        ]
    },
    "TotalBackupSize": "8672256",
    "PageNumber": 1,
    "TotalRecordCount": 1,
    "RequestId": "B0E0F374-919F-4BD9-BCAC-AE68122A0D68",
    "PageRecordCount": 1
}

Error codes

For a list of error codes, visit the API Error Center.