DreamObjects cluster migration
DreamHost is currently in the process of migrating all DreamObjects accounts to a new hardware platform.
Please review this article to identify the cluster your DreamObjects account currently resides on and the features it supports.
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, depending on the cluster it resides on. 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.
Object permissions behave differently on different clusters — make sure to check your bucket's cluster to ensure you understand how permissions will work.
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.
Buckets on the DreamObjects US-East 1 cluster
If your bucket's permissions are set to Public, you will be able to see that an object is listed as part of the contents of a Bucket, but the actual Object cannot be read unless it has also been marked Public.
Bucket and object permissions default to private. If you need to update all object permissions in a DreamObjects US-East 1 bucket, use the following Python script:
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: