User Cluster Backup Admin: manages backup resources such as backup and
restore plans in user clusters. Ask your Organization IAM Admin to grant you
the User Cluster Backup Admin (user-cluster-backup-admin) role.
For AO users:
Backup Creator: creates manual backups and restores. Ask your Project IAM Admin to grant you the Backup Creator (backup-creator) role.
View a list of restores using the GDC console or kubectl.
Console
Sign in to the GDC console.
In the navigation menu, click Backup for Clusters.
Click Select project to select an organization or project depending on your role:
Backup Admin: Select an organization to see all of the restores in
an organization or select a project to see all of the restores in a project.
Backup Creator: Select a project to see all of the restores in a project.
Click the Restores tab.
Click a restore in the list to view its details.
kubectl
View the status of a restore in the default namespace:
kubectlgetclusterRestores
Here's an example of the output:
NAME STATE
restore-sample Succeeded
View restores in all namespaces:
kubectlgetclusterRestores-A
View restores in a specific namespace:
kubectlgetclusterRestores-nNAMESPACE
Replace NAMESPACE with the namespace containing the restores.
Delete a restore
Unlike backups, deleting a restore does not require issuing a request. Restores
are deleted by deleting the resource directly from the Kubernetes API server.
This action also cleans up any associated restore artifacts from object storage.
To delete a restore, use kubectl:
kubectldeleteclusterRestoresRESTORE_NAME
Replace RESTORE_NAME with the name of the restore.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[[["\u003cp\u003eThis guide explains how to view existing restores in Google Distributed Cloud (GDC) air-gapped using the GDC console or \u003ccode\u003ekubectl\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDeleting unused restores is recommended to free up storage space and maintain a tidy environment.\u003c/p\u003e\n"],["\u003cp\u003eTo view or delete a restore, you need either the User Cluster Backup Admin role (for PA users) or the Backup Creator role (for AO users).\u003c/p\u003e\n"],["\u003cp\u003eRestores can be deleted directly using \u003ccode\u003ekubectl delete clusterRestores <RESTORE_NAME>\u003c/code\u003e, which also removes associated artifacts from object storage.\u003c/p\u003e\n"],["\u003cp\u003eYou can view the status of restores in any namespace using \u003ccode\u003ekubectl\u003c/code\u003e, including all namespaces with \u003ccode\u003e-A\u003c/code\u003e or a specific one with \u003ccode\u003e-n <NAMESPACE>\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# View and delete a restore\n\nThis page describes how to view and delete an existing restore in\nGoogle Distributed Cloud (GDC) air-gapped.\n\nDelete unused restores to free up storage space and reduce clutter.\n\nBefore you begin\n----------------\n\nTo view and delete a restore, you must have the following:\n\n- An existing restore. For more information, see [Plan a set of restores](/distributed-cloud/hosted/docs/latest/gdch/platform-application/pa-ao-operations/cluster-backup/plan-restores).\n- The necessary identity and access role:\n\n - For PA users:\n - User Cluster Backup Admin: manages backup resources such as backup and restore plans in user clusters. Ask your Organization IAM Admin to grant you the User Cluster Backup Admin (`user-cluster-backup-admin`) role.\n - For AO users:\n - Backup Creator: creates manual backups and restores. Ask your Project IAM Admin to grant you the Backup Creator (`backup-creator`) role.\n - For more information, see [Role definitions](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/iam/role-definitions).\n\nView a restore\n--------------\n\nView a list of restores using the GDC console or `kubectl`. \n\n### Console\n\n1. Sign in to the GDC console.\n2. In the navigation menu, click **Backup for Clusters**.\n3. Click **Select project** to select an organization or project depending on your role:\n4. Backup Admin: Select an organization to see all of the restores in an organization or select a project to see all of the restores in a project.\n5. Backup Creator: Select a project to see all of the restores in a project.\n6. Click the **Restores** tab.\n7. Click a restore in the list to view its details.\n\n### kubectl\n\nView the status of a restore in the default namespace: \n\n kubectl get clusterRestores\n\nHere's an example of the output: \n\n NAME STATE\n restore-sample Succeeded\n\nView restores in all namespaces: \n\n kubectl get clusterRestores -A\n\nView restores in a specific namespace: \n\n kubectl get clusterRestores -n \u003cvar translate=\"no\"\u003eNAMESPACE\u003c/var\u003e\n\nReplace \u003cvar translate=\"no\"\u003eNAMESPACE\u003c/var\u003e with the namespace containing the restores.\n\nDelete a restore\n----------------\n\nUnlike backups, deleting a restore does not require issuing a request. Restores\nare deleted by deleting the resource directly from the Kubernetes API server.\nThis action also cleans up any associated restore artifacts from object storage.\n\n- To delete a restore, use `kubectl`:\n\n kubectl delete clusterRestores \u003cvar translate=\"no\"\u003eRESTORE_NAME\u003c/var\u003e\n\n Replace \u003cvar translate=\"no\"\u003eRESTORE_NAME\u003c/var\u003e with the name of the restore."]]
