Post x amz targetdynamodb_20120810.listbackups

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1453442446.0 KB

List backups associated with an Amazon Web Services account. To list backups for a given table, specify TableName. ListBackups returns a paginated list of results with at most 1 MB worth of items in a page. You can also specify a 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 boundaries are for the time at which the original backup was requested.

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

post/#X-Amz-Target=DynamoDB_20120810.ListBackups

Headers

X-Amz-Target'DynamoDB_20120810.ListBackups' required

Request body

TableNamestring

The backups from the table specified by <code>TableName</code> are listed.

Limitinteger

Maximum number of backups to return at once.

TimeRangeLowerBoundstring date-time

Only backups created after this time are listed. <code>TimeRangeLowerBound</code> is inclusive.

TimeRangeUpperBoundstring date-time

Only backups created before this time are listed. <code>TimeRangeUpperBound</code> is exclusive.

ExclusiveStartBackupArnstring

<code>LastEvaluatedBackupArn</code> is the Amazon Resource Name (ARN) of the backup last evaluated when the current page of results was returned, inclusive of the current page of results. This value may be specified as the <code>ExclusiveStartBackupArn</code> of a new <code>ListBackups</code> operation in order to fetch the next page of results.

BackupType'USER' | 'SYSTEM' | 'AWS_BACKUP' | 'ALL'

The backups from the table specified by <code>BackupType</code> are listed. Where <code>BackupType</code> can be: <ul> <li> <code>USER</code> - On-demand backup created by you. (The default setting if no other backup types are specified.) </li> <li> <code>SYSTEM</code> - On-demand backup automatically created by DynamoDB. </li> <li> <code>ALL</code> - All types of on-demand backups (USER and SYSTEM). </li> </ul>

Response

Success

LastEvaluatedBackupArnstring

The ARN of the backup last evaluated when the current page of results was returned, inclusive of the current page of results. This value may be specified as the <code>ExclusiveStartBackupArn</code> of a new <code>ListBackups</code> operation in order to fetch the next page of results. If <code>LastEvaluatedBackupArn</code> is empty, then the last page of results has been processed and there are no more results to be retrieved. If <code>LastEvaluatedBackupArn</code> is not empty, this may or may not indicate that there is more data to be returned. All results are guaranteed to have been returned if and only if no value for <code>LastEvaluatedBackupArn</code> is returned.