4 title: "Trashing and untrashing data"
7 Copyright (C) The Arvados Authors. All rights reserved.
9 SPDX-License-Identifier: CC-BY-SA-3.0
12 Collections have a sophisticated data lifecycle, which is documented in the architecture guide at "Collection lifecycle":{{ site.baseurl }}/architecture/keep-data-lifecycle.html#collection_lifecycle.
14 Arvados supports trashing (deletion) of collections. For a period of time after a collection is trashed, it can be "untrashed". After that period, the collection is permanently deleted, though there may still be ways to recover the data, see "Recovering data":{{ site.baseurl }}/admin/keep-recovering-data.html in the admin guide for more details.
16 # "*Trashing (deleting) collections*":#delete-collection
17 # "*Recovering trashed collections*":#trash-recovery
19 {% include 'tutorial_expectations' %}
21 h2(#delete-collection). Trashing (deleting) collections
23 A collection can be trashed using workbench or the arv command line tool.
25 h3. Trashing a collection using workbench
27 To trash a collection using workbench, go to the Data collections tab in the project, and use the <i class="fa fa-fw fa-trash-o"></i> trash icon for this collection row.
29 h3. Trashing a collection using arv command line tool
32 arv collection delete --uuid=zzzzz-4zz18-xxxxxxxxxxxxxxx
35 h2(#trash-recovery). Recovering trashed collections
37 A collection can be untrashed / recovered using workbench or the arv command line tool.
39 h3. Untrashing a collection using workbench
41 To untrash a collection using workbench, go to trash page on workbench by clicking on the "Trash" icon in the top navigation in workbench and use the recycle icon or selection dropdown option.
43 !{display: block;margin-left: 25px;margin-right: auto;border:1px solid lightgray;}{{ site.baseurl }}/images/trash-button-topnav.png!
45 h3. Untrashing a collection using arv command line tool
47 You can list the trashed collections using the list command.
50 arv collection list --include-trash=true --filters '[["is_trashed", "=", "true"]]'
53 You can then untrash a particular collection using arv using it's uuid.
56 arv collection untrash --uuid=zzzzz-4zz18-xxxxxxxxxxxxxxx
59 The architecture section has a more detailed description of the "data lifecycle":{{ site.baseurl }}/architecture/keep-data-lifecycle.html in Keep.