Overview
A Bucket is a mechanism for grouping objects in DreamObjects, similar to a folder. Unlike a folder, Buckets exist in a global namespace inside DreamObjects, which means that bucket names must be unique, just like a domain name, since they are used to create public URLs to store objects.
Creating a Bucket
- Navigate to the DreamObjects page in your DreamHost panel.
- Click the Manage tab at the top.
- Under your username, click the Add Bucket button.
- Enter a name for your bucket in the Bucket Name field box.
- Click the Add Bucket button.
Bucket names have certain requirements. See the DreamObjects Bucket Names article for specific details.
Setting bucket permissions
You can set your new bucket to have public or private permissions. View the 'DreamObjects permissions' article for details. To select a permission setting, you must edit the bucket:
- Navigate to the DreamObjects page in your DreamHost panel.
- Click the Change Settings link to the right of your bucket.
- Select a permissions setting for the contents of your bucket by clicking the 'Permissions' toggle button.
- Choose either Private or Public.
- You can change the permission setting at any time after creating the bucket.
More information about setting permissions
Public means that you can view the Bucket's properties and a list of its contents by navigating to the Bucket URL.
Buckets on the DreamObjects US-East 5 cluster
All objects within a bucket inherit the same permission level set for the bucket they are contained in. Objects within a Public bucket will have all of their individual permissions set to Public as well. New bucket permissions default to private.
Editing a Bucket
Options for editing a Bucket are limited, but you can:
- Modify the permission settings on an existing Bucket at any time.
- Add or remove contents from a Bucket.
Deleting a Bucket
It is not possible to delete a bucket that contains any objects. Additionally, the bucket deletion operation is non-reversible. MAKE SURE sure you have backed up all data in the bucket before deleting it.
- You can use a DreamObjects client to delete all bucket contents (recommended)
- or you can use this AWS CLI command to delete all bucket contents via SSH (advanced)
- Navigate to the DreamObjects page in your DreamHost panel.
- Click the Manage tab.
- Click your username. The page expands and displays your Keypairs and Buckets.
- To the right of your bucket, click the Remove Bucket button.
- Click the Remove button to delete the bucket.
Accessing objects in the bucket
View the following article for instructions on how to access objects within a bucket: