Amazon DynamoDB
API Reference


List backups associated with an AWS account. To list backups for a given table, specify TableName. ListBackups returns a paginated list of results with at most 1MB worth of items in a page. You can also specify a limit for the maximum number of entries to be returned in a page.

In the request, start time is inclusive but end time is exclusive. Note that these limits are for the time at which the original backup was requested.

You can call ListBackups a maximum of 5 times per second.

Request Syntax

{ "ExclusiveStartBackupArn": "string", "Limit": number, "TableName": "string", "TimeRangeLowerBound": number, "TimeRangeUpperBound": number }

Request Parameters

The request accepts the following data in JSON format.


In the following list, the required parameters are described first.


LastEvaluatedBackupARN returned by the previous ListBackups call.

Type: String

Length Constraints: Minimum length of 37. Maximum length of 1024.

Required: No


Maximum number of backups to return at once.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 100.

Required: No


The backups from the table specified by TableName are listed.

Type: String

Length Constraints: Minimum length of 3. Maximum length of 255.

Pattern: [a-zA-Z0-9_.-]+

Required: No


Only backups created after this time are listed. TimeRangeLowerBound is inclusive.

Type: Timestamp

Required: No


Only backups created before this time are listed. TimeRangeUpperBound is exclusive.

Type: Timestamp

Required: No

Response Syntax

{ "BackupSummaries": [ { "BackupArn": "string", "BackupCreationDateTime": number, "BackupName": "string", "BackupSizeBytes": number, "BackupStatus": "string", "TableArn": "string", "TableId": "string", "TableName": "string" } ], "LastEvaluatedBackupArn": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.


List of BackupSummary objects.

Type: Array of BackupSummary objects


Last evaluated BackupARN.

Type: String

Length Constraints: Minimum length of 37. Maximum length of 1024.


For information about the errors that are common to all actions, see Common Errors.


An error occurred on the server side.

HTTP Status Code: 500

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: