> For the complete documentation index, see [llms.txt](https://help.basespace.illumina.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.basespace.illumina.com/manage-data/archival-storage.md).

# Archival Storage

Archival storage moves data into long-term archives with lower data storage rates. It is intended for data that must be retained and do not require immediate access.

Data transfer to and from archival storage incurs additional fees per Terabyte transferred in the move. Restoring data that have been archived for a short period of time can result in higher storage costs.

| **Storage Product**  | **Cost**                      | **Details**                                     |
| -------------------- | ----------------------------- | ----------------------------------------------- |
| Standard Storage     | 22.5 BICs per TB per month    | Default, instant free access                    |
| Archive Storage      | 2.0 BICs per TB per month     | Around 2 days to restore, costs below           |
| Transfer to Archive  | 20.0 BICs per TB per transfer | Cost to move 1 TB from Standard to Archive      |
| Restore from Archive | 30.0 BICs per TB per restore  | Cost to move 1 TB from Archive back to Standard |

{% hint style="info" %}
Archived data will still be reflected in overall run and project file size. To see a breakdown of your storage, vist the Usage Explorer using the link in the Usage & Storage settings page.
{% endhint %}

For more information about storage costs, see the illumina.com [BIC information page](https://www.illumina.com/products/by-type/informatics-products/icredits.html).

The following data can be archived:

* Runs—Includes all files within the Data folder.
* FASTQ and data set files—Includes all files within the data set.

{% hint style="info" %}
Archived data appear in the run and data set lists. Filter the run or FASTQ lists to view only active or archived data.
{% endhint %}

## Requirements

* The run must be in a terminal (Complete, Stopped, or Failed) state.
* BaseSpace Sequence Hub must be configured for New mode. Contact your workgroup owner or administrator if your workgroup is using Classic mode.
* Data that are shared, in the trash, already archived, or files-only deleted are not eligible to be archived.

## How to Archive Data

Archive data that you do not need immediate access to. Archiving can take several days to complete and incurs additional costs.

1. Open the page for the data you want to archive. To archive multiple items, select the items on the Runs list, FASTQs tab, or Other Datasets tab. You can select up to 250 items at one time.
2. From the File menu, point to Archive, and then select Archive Data. BaseSpace Sequence Hub reviews the selections and excludes ineligible data.
3. In the Archive Data dialog, verify the items, and then select Archive Data. BaseSpace Sequence Hub moves the data to archival storage. Data are not available and cannot be restored until archiving is complete.

How to Restore Data

Data are available to restore when the archive process is complete. Restoration can take several days to complete and incurs additional costs.

1. Open the page for the data you want to restore. To restore multiple runs, select the items on the Runs list, FASTQs tab, or Other Datasets tab. You can select up to 250 items at one time.
2. From the File menu, point to Archive, and then select Restore Data.
3. In the Restore Data dialog, verify the items, and then select Restore Data. The restored data are available for use and charged at standard storage rates.

Sharing and transferring restored data or assets that contain restored data are currently disabled. These functions are intended for a future update.

## Manage Archived Data

BaseSpace Sequence Hub provides some read-only information about archived data.

* For archived runs, only the summary, metrics, and sample sheet details are available.
* Archived files cannot be downloaded.
* Biosample data and yield calculations exclude archived data.
* Projects that include archived data cannot be shared or transferred.

### Using the Basespace CLI

The CLI supports archive and restore using the commands bs archive and bs unarchive.

Use the following commands to archive and restore data:

`bs archive run -i :id`

`bs archive dataset -i :id`

`bs unarchive run -i :id`

`bs unarchive dataset -i :id`

## Frequently asked questions

### Why do I want to archive my data in BaseSpace Sequence Hub?

Archiving data moves data to a special tier of storage specifically designated for infrequently accessed data. This type of storage offers a significant cost savings over the Standard Storage options for data that needs to be accessed on-demand.

### When should I archive my data rather than delete it?

You should archive data when you no longer need to access the data frequently but still need to keep the data for an extended period of time. Archiving the data allows for retrieval while saving storage cost.

### What would my storage cost be if I start moving my data to Archival Storage?

The costs for storage products are described in the table above.

| Scenario                                            | Calculation                                                                                                                                                                                                                                        | Cost                          |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| Maintain data in Standard storage for 2 years       | 2 TB × 22.5 BICs/TB/month × 24 months                                                                                                                                                                                                              | **1,080 BICs**                |
| Archive data after 1 month, keep for 23 more months | <p><strong>Standard storage (1 month):</strong> 2 TB × 22.5 BICs/TB/month × 1 month = 45<br><strong>Move to archive:</strong> 2 TB × 20 BICs/TB = 40<br><strong>Archival storage (23 months):</strong> 2 TB × 2 BICs/TB/month × 23 months = 92</p> | **177 BICs** (903 BICs saved) |

*The prices listed in this article reflect the pricing at the time of publication. For the latest prices, see the BICs page or Archival Storage page.*

### Can I access my files when my data is in Archival Storage?

Once data has been archived, you will need to restore the data before the files can be accessed again.

### Can I delete files that are in Archival Storage?

Yes, you can delete files without needing to restore first. Regardless of whether they are in standard or archived state, deleting data means moving the data to the trash and still account for storage until you empty the trash.

### How long should I keep my data in Archival Storage minimally to save storage cost?

In general, restoring data from Archival Storage within 3 months of archiving results in higher storage cost.

### Is there a minimum amount of time the data needs to stay in Archival Storage before it can be restored or deleted?

No. There are no early restore or early deletion fees.

### When can I restore my data from Archival Storage?

As soon as all of your data shows as "Archived", you can restore it. You cannot change the status of "Archiving" or "Unarchiving" data, other than by waiting for the operation to complete.

### How long does it take to Archive and UnArchive data

Both archiving and unarchiving can take several days, depending on the number of files and other factors. Unarchive typically takes at least 2 days for any size of run or dataset.

### How will I know what data is archived?

For a specific run or dataset, the File Status will be listed as either "Archived", "Archiving", "Unarchiving", or "Active". You can Archive Active data, and Unarchive Archived data. Archiving and Unarchiving states cannot be changed, they will move to one of the other states when the change is complete.

The master Run list will has File Status filter, allowing archived runs to be shown or hidden in the list, for example.

For datasets, the menu “Project > FASTQs” and “Project > Other Datasets lists” will have a File Status filter. File Status is not displayed as a column in the master list and can be accessed from the Filters list.

### Who can archive and restore data?

The ability to archive and restore data is restricted by the following criteria:

The data must be owned by a Workgroup. This means users of free trial or Basic tier, or data stored in individual accounts cannot archive or restore data.

### Which subscription tiers can use these Archive and Restore features?

These Archive and Restore features are available to both Professional and Enterprise subscription customers. They are not available for Free Trials, Basic tier, or individual accounts.

### Is there a way to archive or restore using CLI?

Yes. For more information, [see the above section](#basespace-cli).

### Where and how can I archive files?

To archive a run using BaseSpace Sequence Hub UI:

1. From the Run Master List, select at least one run (bulk archive is supported)
2. Select File > Archive > Archive Data
3. Review the modal summarizing the number of runs and total size of data to be archived.
4. Confirm the archive operation to begin the archive process.

For detailed information on how to use the archive feature, see the BSSH Archival Storage documentation.

### How does your pricing compare to AWS?

Our pricing model is different from AWS. We use a simplified model with a single, one-off fee for archiving and restoring data, along with a low monthly rate. AWS has additional charges for many transactions that are included in our rates, such as per-file access and early deletion fees. We aim to keep pricing competitive, through our all-inclusive and straightforward base monthly rate. With simple and easy archive and restore functionality, you don’t need to move data to AWS to archive when you can keep your data in the BaseSpace Sequence Hub.
