# RestoreFromArchiveJob

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.RestoreFromArchiveJob/

Struct for a restoring documents from archive job.

- **Full name:** `MFiles.RestoreFromArchiveJob`
- **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-source_file"></a>`source_file` | `string` | 1 | Full path to the archive file on server. |
| <a id="f-impersonation"></a>`impersonation` | [`Impersonation`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.Impersonation/index.md) | 2 | Impersonation information for accessing the archive target file on server. |
| <a id="f-restore_full_archive"></a>`restore_full_archive` | `bool` | 3 | True to restore the entire contents of the archive. False to restore a specific document only. |
| <a id="f-restore_object_id"></a>`restore_object_id` | `int32` | 4 | If bEntireContents is false, specifies the document to restore. |
| <a id="f-options"></a>`options` | [`OBJRESTORINGFLAGS`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.OBJRESTORINGFLAGS/index.md) | 5 | Bit flags that control the execution of this restoring job. |
| <a id="f-acl_override"></a>`acl_override` | [`AccessControlList`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.AccessControlList/index.md) | 6 | The overriding ACL. Can be unset. |
| <a id="f-restore_structure_items"></a>`restore_structure_items` | repeated [`MetadataStructureSelector`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.MetadataStructureSelector/index.md) | 7 | If not empty, specifies the metadata structure items to restore. |
| <a id="f-cloud_storage_connection_string"></a>`cloud_storage_connection_string` | `string` | 8 | Transport connection string. |
| <a id="f-cloud_storage_password"></a>`cloud_storage_password` | `string` | 9 | Package encryption password. |
| <a id="f-configuration_id"></a>`configuration_id` | `string` | 10 | Configuration id of this restoring job. |

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

## Used by methods

- [IRPCVaultAdmin.RestoreFromArchive](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCVaultAdmin/RestoreFromArchive/index.md): Imports the contents of an archive (or one object of it) into the vault, or previews the import.

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

## Used in fields

- [`JobDataUnion.restore_from_archive`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.JobDataUnion/index.md#f-restore_from_archive): Restoring documents from archive job.
- [`RestoreFromArchiveRequest.restorefromarchivejob`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCVaultAdmin/RestoreFromArchive/index.md#request): The archive to import (a file on the server or cloud storage), what to import and the import options.