# Manage S3 buckets using the GUI

Using the GUI, you can:

* [Create a bucket](#create-a-bucket)
* [View a bucket details](#view-a-bucket-details)
* [Edit a bucket hard quota](#edit-a-bucket-hard-quota)
* [Edit a bucket policy](#edit-a-bucket-policy)
* [Delete a bucket](#remove-a-bucket)

## Create a bucket <a href="#create-a-bucket" id="create-a-bucket"></a>

**Before you begin**

S3 does not support creating buckets on filesystems with names containing the characters ' ', '`(`', '`)`', or '`&`'. Verify that the filesystem name excludes these characters. Rename the filesystem if needed before creating the S3 bucket.

**Procedure**

1. From the menu, select **Manage > Protocols**.
2. From the Protocols pane, select **S3**.
3. Select the **Buckets** tab.
4. Select **+Create**.
5. In the Add S3 Bucket dialog, do the following:
   * **Bucket Name:** Set a bucket name according to the naming conventions.
   * **Filesystem:** Set the filesystem to host the bucket.
   * **Use Existing Directory:** If you want to expose an existing directory, set its path. Make sure that the directory is not below the hierarchy of the already configured S3 bucket.
   * **Hard Quota:** Set the maximum capacity for the bucket. If you want to remove the hard quota setting, enter 0.
   * **Bucket Policy:** Select the policy to attach to the bucket: none, download, upload, public, or custom. If you select a custom policy, add it in JSON format.
6. Select **Save**.

<div data-with-frame="true"><img src="https://1927137253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0yXyIrnroN3zIG3qa4W3%2Fuploads%2Fgit-blob-f0253114e5b38eec5f821d06c964e64376da181d%2FCreate_S3_bucket.gif?alt=media" alt="Create a bucket"></div>

## View a bucket details <a href="#view-a-bucket-details" id="view-a-bucket-details"></a>

You can view the details of the bucket.

**Procedure**

1. From the menu, select **Manage > Protocols**.
2. From the Protocols pane, select **S3**.
3. Select the **Buckets** tab.
4. Select the three dots of the bucket and select **View**.

<div data-with-frame="true"><figure><img src="https://1927137253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0yXyIrnroN3zIG3qa4W3%2Fuploads%2Fgit-blob-e2f85f231c5d1d19b31ae650c9745630c65cb187%2Fwmng_manage_s3_bucket_menu.png?alt=media" alt=""><figcaption><p>Manage a bucket menu</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://1927137253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0yXyIrnroN3zIG3qa4W3%2Fuploads%2Fgit-blob-a3af2eb6f2d90007a82e599bb53d01ee0368099d%2Fwmng_view_s3_bucket.png?alt=media" alt=""><figcaption><p>View S3 Bucket</p></figcaption></figure></div>

## Edit a bucket hard quota <a href="#edit-a-bucket-hard-quota" id="edit-a-bucket-hard-quota"></a>

The hard quota determines the maximum capacity of the bucket. Initially, you can only set the hard quota for an empty bucket. If the hard quota of the bucket is already set, you can modify it or remove it.

**Procedure**

1. From the menu, select **Manage > Protocols**.
2. From the Protocols pane, select **S3**.
3. Select the **Buckets** tab.
4. Select the three dots of the bucket and select **Edit Hard Quota**.
5. Set the maximum capacity for the bucket. If you want to remove the hard quota setting, enter 0.

<div data-with-frame="true"><figure><img src="https://1927137253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0yXyIrnroN3zIG3qa4W3%2Fuploads%2Fgit-blob-c7054f2c8a9780be7fced660ff343282883cd48c%2Fwmng_edit_s3_bucket_hard_quota.png?alt=media" alt=""><figcaption><p>Edit S3 Bucket Quota</p></figcaption></figure></div>

## Edit a bucket policy <a href="#edit-a-bucket-policy" id="edit-a-bucket-policy"></a>

You can edit the bucket policy according to your needs.

**Procedure**

1. From the menu, select **Manage > Protocols**.
2. From the Protocols pane, select **S3**.
3. Select the **Buckets** tab.
4. Select the three dots of the bucket you want to delete, and select **Edit Bucket Policy**.
5. Select the policy to attach to the bucket: none, download, upload, public, or custom. If you select a custom policy, add it in JSON format.

<div data-with-frame="true"><figure><img src="https://1927137253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0yXyIrnroN3zIG3qa4W3%2Fuploads%2Fgit-blob-ff2e553a3d6e1ad7171c45ae3d0bc6807f4a1321%2Fwmng_edit_s3_bucket_policy.png?alt=media" alt=""><figcaption><p>Edit S3 Bucket</p></figcaption></figure></div>

## Delete a bucket <a href="#remove-a-bucket" id="remove-a-bucket"></a>

You can delete an existing bucket from the filesystem only if the bucket is empty. If the bucket is not empty, you can detach the bucket from the S3 configuration and keep the data and metadata in place. Consequently, you can recreate the bucket while preserving the data and metadata (see [Create a bucket](#create-a-bucket) using the Use Existing Directory switch.

{% hint style="info" %}
If the intent is to keep the data files for use outside of the S3 configuration and delete only the S3 metadata, contact the Customer Success Team for assistance.
{% endhint %}

**Procedure**

1. From the menu, select **Manage > Protocols**.
2. From the Protocols pane, select **S3**.
3. Select the **Buckets** tab.
4. Select the three dots of the bucket you want to delete and select **Remove**.

<div data-with-frame="true"><figure><img src="https://1927137253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0yXyIrnroN3zIG3qa4W3%2Fuploads%2Fgit-blob-adca25169b8982e087d4d6019e6f22bcd832c231%2Fwmng_remove_bucket_message.png?alt=media" alt=""><figcaption><p>Remove Bucket</p></figcaption></figure></div>

5. In the confirmation message, if the bucket is not empty, switch **Keep Data** to **ON**.\
   Then, select **Remove**.
