View the backup list

Last Updated: Dec 06, 2017


Query a set of instance backups. The set of backups must be in the Success state to be used to restore an instance.

RDS provides backup files for download.

  • When the DownloadLink is NULL, RDS does not provide a download URL.

  • When DownloadLink is not NULL, the user can use this URL to download the backup file through wget (add double quotes), a browser, or programming. The expiration time for this URL is specified by LinkExpiredTime. Use it before the expiration time. If it has expired, you can see the following error code during the download.

    1. <?xml version="1.0" encoding="UTF-8" ?>
    2. <Error>
    3. <Code>AccessDenied</Code>
    4. <Message>Request has expired.</Message>
    5. <Expires>2012-12-25T09:47:52.000Z</Expires>
    6. <ServerTime>2012-12-25T09:49:00.000Z</ServerTime>
    7. <RequestId>50D9768CA801C2F102005C70</RequestId>
    8. <HostId></HostId>
    9. </Error>

Request parameters

Name Type Required? Description
Action String Yes Required parameter. Value: DescribeBackups.
DBInstanceId String Yes Instance ID.
BackupId Integer No ID of the backup set.
BackupStatus String No Backup set status. Values:
  • Success: the backup is finished.
  • Failed: the backup fails.
BackupMode String No Backup mode. Values:
  • Automated: a common task.
  • Manual: a temporary task.
StartTime String Yes Query start time, for example, 2011-06-11T15:00Z.
EndTime String Yes Query end time, which must be later than the query start time, for example, 2011-06-11T16:00Z.
PageSize Integer No Number of records on every page. Values: 30, 50, and 100. Default value: 30.
PageNumber Integer No Page number, which must be greater than 0 but must not exceed the maximum Integer value. Default value: 1.

Return parameters

Name Type Description
<Public Return Parameters> - For more information, see Public parameters.
TotalRecordCount Integer Total number of records.
PageNumber Integer Page number.
PageRecordCount Integer Number of backup sets displayed on the current page.
Items List<Backup> Array composed of backups.

Backup parameters

Name Type Description
BackupId Integer ID of the backup.
DBInstanceId String Name of an instance.
BackupStatus String Backup status. Values:
  • Success: the backup is finished.
  • Failed: the backup fails.
BackupStartTime String Start time of this backup. Format: YYYY-MM-DD’ T’ hh:mm:ssZ.
BackupEndTime String End time of this backup. Format: YYYYMM-DD’ T’ hh:mm:ssZ.
BackupType String Backup type. Values: FullBackup and IncrementalBackup.
BackupMode String Backup mode. Values: Automated and Manual.
BackupMethod String Backup method. Values: Logical and Physical.
BackupDownloadURL String Download URL. The string is empty if the current backup cannot be downloaded.
BackupSize Long Data file size, in the unit of bytes.
Thank you! We've received your feedback.