Skip to content

list_backups

Operation

list_backups

list_backups(request: ListBackupsInput | ListBackupsInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[ListBackupsInputDict]) -> ListBackupsOutput

List DynamoDB backups that are associated with an Amazon Web Services account and weren't made with Amazon Web Services Backup. To list these 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.

If you want to retrieve the complete list of backups made with Amazon Web Services Backup, use the Amazon Web Services Backup list API.

Parameters:

Name Type Description Default
request ListBackupsInput | ListBackupsInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[ListBackupsInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
ListBackupsOutput

An instance of ListBackupsOutput.

list_backups async

list_backups(request: ListBackupsInput | ListBackupsInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[ListBackupsInputDict]) -> ListBackupsOutput

List DynamoDB backups that are associated with an Amazon Web Services account and weren't made with Amazon Web Services Backup. To list these 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.

If you want to retrieve the complete list of backups made with Amazon Web Services Backup, use the Amazon Web Services Backup list API.

Parameters:

Name Type Description Default
request ListBackupsInput | ListBackupsInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[ListBackupsInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
ListBackupsOutput

An instance of ListBackupsOutput.

Input

Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.

ListBackupsInputDict

Bases: TypedDict

Dictionary form of ListBackupsInput.

Attributes

backup_type instance-attribute
backup_type: str | None

The backups from the table specified by BackupType are listed.

Where BackupType can be:

  • USER - On-demand backup created by you. (The default setting if no other backup types are specified.)

  • SYSTEM - On-demand backup automatically created by DynamoDB.

  • ALL - All types of on-demand backups (USER and SYSTEM).

exclusive_start_backup_arn instance-attribute
exclusive_start_backup_arn: str | None

LastEvaluatedBackupArn 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 ExclusiveStartBackupArn of a new ListBackups operation in order to fetch the next page of results.

limit instance-attribute
limit: int | None

Maximum number of backups to return at once.

table_name instance-attribute
table_name: str | None

Lists the backups from the table specified in TableName. You can also provide the Amazon Resource Name (ARN) of the table in this parameter.

time_range_lower_bound instance-attribute
time_range_lower_bound: datetime | None

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

time_range_upper_bound instance-attribute
time_range_upper_bound: datetime | None

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

ListBackupsInput dataclass

Bases: _SerdeShape

Dataclass for ListBackupsInput structure.

Attributes

backup_type class-attribute instance-attribute
backup_type: str | None = ...

The backups from the table specified by BackupType are listed.

Where BackupType can be:

  • USER - On-demand backup created by you. (The default setting if no other backup types are specified.)

  • SYSTEM - On-demand backup automatically created by DynamoDB.

  • ALL - All types of on-demand backups (USER and SYSTEM).

exclusive_start_backup_arn class-attribute instance-attribute
exclusive_start_backup_arn: str | None = ...

LastEvaluatedBackupArn 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 ExclusiveStartBackupArn of a new ListBackups operation in order to fetch the next page of results.

limit class-attribute instance-attribute
limit: int | None = ...

Maximum number of backups to return at once.

table_name class-attribute instance-attribute
table_name: str | None = ...

Lists the backups from the table specified in TableName. You can also provide the Amazon Resource Name (ARN) of the table in this parameter.

time_range_lower_bound class-attribute instance-attribute
time_range_lower_bound: datetime | None = ...

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

time_range_upper_bound class-attribute instance-attribute
time_range_upper_bound: datetime | None = ...

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

Output

ListBackupsOutput dataclass

Bases: _SerdeShape

Dataclass for ListBackupsOutput structure.

Attributes

backup_summaries class-attribute instance-attribute
backup_summaries: list[BackupSummary] | None = ...

List of BackupSummary objects.

last_evaluated_backup_arn class-attribute instance-attribute
last_evaluated_backup_arn: str | None = ...

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 ExclusiveStartBackupArn of a new ListBackups operation in order to fetch the next page of results.

If LastEvaluatedBackupArn is empty, then the last page of results has been processed and there are no more results to be retrieved.

If LastEvaluatedBackupArn 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 LastEvaluatedBackupArn is returned.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.