# GetBackupData

Lists recently exported data files, and recent locations used by backup operations. This list includes:

- backups from DREBACKUP
- backups from BackupServer
- backups that occur before DRECOMPACT
- data files exported by the DREEXPORTIDX and DREEXPORTXML index actions

The response includes a `<backup_required>` tag to indicate whether the index has changed since the last backup.

You can configure the number of backups to store and return in the response by using the BackupListLength configuration parameter.

This backup list result is not affected if you initialize or restore your index by using a DREINITIAL action, because it reports the state of the external files, rather than the state of the index.

NOTE: This is an administrative action that can be sent only by users that belong to an authorization role that allows the `Admin` standard role, or which enables the action explicitly. See Authorization Roles Configuration Parameters.

## Example

    http://12.3.4.56:9000/action=GetBackupData

This action retrieves a list of backup and exported data files.

## Optional Parameters

This action accepts the following optional parameters.

Parameter | Description
--- | ---
CheckFiles | Whether to check the state of the backup files.
BackupForRestoreTime | Returns the backup that IDOL Server would use to back up to the specified time.

This action accepts the following standard ACI action parameters.

Parameter | Description
--- | ---
ActionID | A string to use to identify an ACI action.
EncryptResponse | Encrypt the output.
FileName | The file to write output to.
ForceTemplateRefresh | Forces the server to load the template from disk.
Output | Writes output to a file.
ResponseFormat | The format of the action output.
Template | The template to use for the action output.
TemplateParamCSVs | A list of variables to use for the specified template.

_FT_HTML5_bannerTitle.htm