Fuzzball Documentation
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

Deleting Groups

In order to delete groups, you will need organization owner permissions. Groups can be deleted using either the web UI or the CLI. Follow the instructions in either the web UI or CLI tab below, depending on your preferred method.

Group deletion is permanent and cannot be undone. When you delete a group:

  • All data associated with the group will be permanently removed
  • All running workflows in the group will be terminated
  • All users will lose access to group-level resources
  • Any storage volumes or other resources will be cleaned up

Ensure you have backed up any important data before proceeding with group deletion.

Please select either the web UI or CLI tab to see the appropriate instructions for your environment.

Prerequisites

Before deleting groups via the web UI, ensure you have:

  • Organization owner permissions
  • Confirmation that the group is no longer needed and that any needed data in associated volumes has been preserved

Deleting a Group

  1. Log into your Fuzzball UI as an organization owner

  2. Click on the Gear icon in the top right of the dashboard header and select Manage organization

    Manage organization menu

  3. Navigate to the Groups section in the left toolbar

    Groups section

  4. Find the group you want to delete in the list of groups

  5. In the kebob menu (three dots) on the right side of the group row, select Delete

    group deletion

  6. A confirmation dialog will appear asking you to confirm or cancel the deletion.

  7. Click Delete to permanently delete the group

The deletion process may take some time to complete in the background as all associated resources are cleaned up. Users who were members of the deleted group will remain as organization members but will lose access to any group-specific resources.

Prerequisites

  • Organization owner permissions
  • group ID of the group to delete
  • Fuzzball CLI with a context configured for the admin user

Getting the group ID

To obtain the group ID, use the Fuzzball group CLI subcommand list:

$ fuzzball group list
SELECTED | NAME                         | ID                                   | CREATED TIME          | LAST UPDATED
         | User Account (admin@ciq.com) | 06559942-1f88-4c99-93c5-2dfb1537d355 | 2024-06-19 12:51:29PM | 2024-06-19 12:51:29PM
    *    | default                      | 2ec072f6-7ab2-42fc-acce-5fc0912ce3b0 | 2024-07-03 09:38:14PM | 2024-07-03 09:38:14PM
         | test-group1                  | 324fe14b-1008-4c2d-8e07-e7136c7db38f | 2024-07-09 10:18:18PM | 2024-07-09 10:18:18PM

Deleting the Group

Using the group ID, use the Fuzzball group CLI subcommand delete and pass the group ID as an argument. In this example, we’ll delete the test-group1 group:

$ fuzzball group delete 324fe14b-1008-4c2d-8e07-e7136c7db38f

If the group is successfully deleted, the command will not produce any output.

Verifying Deletion

To confirm the group has been deleted, run fuzzball group list again:

$ fuzzball group list
SELECTED | NAME                         | ID                                   | CREATED TIME          | LAST UPDATED
         | User Account (admin@ciq.com) | 06559942-1f88-4c99-93c5-2dfb1537d355 | 2024-06-19 12:51:29PM | 2024-06-19 12:51:29PM
    *    | default                      | 2ec072f6-7ab2-42fc-acce-5fc0912ce3b0 | 2024-07-03 09:38:14PM | 2024-07-03 09:38:14PM

The test-group1 group is no longer listed, confirming it has been successfully deleted.

The deletion process may take some time to complete in the background as all associated resources are cleaned up. Users who were members of the deleted group will remain as organization members but will lose access to any group-specific resources.