# RestoreJob

Location: [gRPC API](https://developer.m-files.com/APIs/gRPC-API/index.md) > [Reference](https://developer.m-files.com/APIs/gRPC-API/Reference/index.md) > [Messages](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/index.md)

HTML version: https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.RestoreJob/

Struct for a restore job.

- **Full name:** `MFiles.RestoreJob`
- **Proto file:** [`mfiles/structs.proto`](https://developer.m-files.com/APIs/gRPC-API/downloads/proto/mfiles/structs.proto)

<a id="fields"></a>

## Fields

| Field | Type | Number | Description |
|---|---|---|---|
| <a id="f-full_backup_file"></a>`full_backup_file` | `string` | 1 | Full path to the backup file on server (full backup). |
| <a id="f-differential_backup_file"></a>`differential_backup_file` | `string` | 2 | Full path to the backup file on server (differential backup, optional). |
| <a id="f-target_vault"></a>`target_vault` | [`Vault`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.Vault/index.md) | 3 | The definition of the vault. If the GUID field is GUID_NULL, the restored vault uses the GUID specified in the backup files. Otherwise, it uses the given GUID (= restore to a different identity). |
| <a id="f-overwrite_existing_files"></a>`overwrite_existing_files` | `bool` | 4 | If true, existing target files are overwritten. If false, restore fails if a target file already exists. |
| <a id="f-impersonation"></a>`impersonation` | [`Impersonation`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.Impersonation/index.md) | 5 | Impersonation information for accessing the backup file on server. |
| <a id="f-vault_attach_options"></a>`vault_attach_options` | [`AttachVaultOptions`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.AttachVaultOptions/index.md) | 6 | Options for controlling the attaching of the vault. |

<a id="used-by-methods"></a>

## Used by methods

- [IRPCVaultsAdmin.RestoreVault](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCVaultsAdmin/RestoreVault/index.md): Restores a vault from backup files on the server and attaches it.

<a id="used-in-fields"></a>

## Used in fields

- [`JobDataUnion.restore`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.JobDataUnion/index.md#f-restore): Restore job.
- [`RestoreVaultRequest.restore_job`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCVaultsAdmin/RestoreVault/index.md#request): The backup files to restore and the definition of the restored vault. If `target_vault.vault.guid` is the null GUID, the vault keeps the GUID stored in the backup.