Delete a project to remove a group of resources within an organization. When
deleting a project in Google Distributed Cloud (GDC) air-gapped appliance, the system first verifies
the project is eligible for deletion. If the system reports precheck errors, you
must manually fix the issues before you can initiate project deletion.

## Before you begin

To get the permissions needed to delete a project, ask your Organization
IAM Admin to grant you the Project Editor role (`project-editor`).

## Delete a project and its resources

To delete a project, complete the following steps:

### Console

1. From the navigation menu of the GDC console, click **Projects**.

2. Select the project that you want to delete.

3. Ensure the clusters attached to the project are assigned to other
   projects. A cluster must be attached to a project.

4. Click delete **Delete
   Project**.

5. When prompted, type `remove` and click **Confirm** to initiate the project
   deletion prechecks.

If the project deletion prechecks complete successfully, the
GDC system begins deleting the project. If the
prechecks fail, error codes are reported in a prompt.

### gdcloud

1. Ensure you have the gdcloud CLI installed. For more
   information, see the gdcloud CLI
   [Overview](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/resources/gdcloud-overview#download_and_install_the)
   page.

2. To delete the project, run:

       gdcloud projects delete PROJECT_ID

   Replace `PROJECT_ID` with the unique identifier for
   the project to delete.

If the project deletion prechecks complete successfully, the
GDC system begins deleting the project. If the
prechecks don't complete successfully, precheck failures with corresponding
error codes are reported in the gdcloud CLI.

You must manually fix the issues reported before you can delete the project. See
the [Handle project deletion precheck failures](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/platform/pa-user/delete-a-project#handle-precheck-failures)
section for steps to manually fix precheck failures.

## Handle project deletion precheck failures

If the project deletion precheck task is not successful, you are given a code
that maps to the issue. Locate the code and complete the outlined steps to
fix the issue.

### OBJ-E0001: Buckets must be deleted in project

This error occurs when deleting a project if it has storage buckets remaining.
You must remove the buckets before the project can be deleted successfully.

For more information, see
[Delete storage buckets](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/platform/pa-user/delete-storage-buckets)
to manually delete your project's storage buckets.