- 22 May 2023
- Print
- PDF
2—Working with Buckets and Objects
- Updated on 22 May 2023
- Print
- PDF
Wasabi stores objects (folders and files) in buckets. Once you create a storage bucket, you can upload objects into the bucket. You can create up to 1000 buckets per account.
Objectives
![]() | Sign up for Wasabi and sign in. |
![]() | Work with buckets and objects.![]() |
![]() | Create a user account and access key. |
Creating a Bucket
- On the Wasabi Management Console, click CREATE BUCKET.
If you are a new user, you may see a screen such as the one below. You can click either blue CREATE BUCKET button.
- In the “Select Bucket Name” area, enter a unique DNS-compliant name for your new bucket. You should develop a naming strategy following these guidelines:
— The name must be unique across all existing bucket names in Wasabi. A bucket name must:
Be a valid DNS-compliant name
Begin with a lowercase letter or number, and
Consist of 3 to 63 lowercase letters, numbers, periods, and/or dashes.
The name cannot contain underscores, end with a dash, have consecutive periods, or use dashes adjacent to periods. And, the name cannot be formatted as an IP address (123.45.678.90).— Choose a bucket name that reflects the objects you will store in the bucket.
The bucket name is visible in the URL that points to the objects you will put in the bucket. widget-project is used in the example below; but enter your own unique name.
- Select the region (geographic location) where you want the bucket to reside. The URL of the region you select is displayed with the region name. For example:
You can click
to copy this region URL to the clipboard.
- At this point, you have several options:
Click CREATE BUCKET to create the bucket now (and end this procedure).
OR
Continue by reviewing the bucket properties, as described below.
OR
Copy settings from an existing bucket, as described for Quick Setup.Continue now by reviewing the bucket properties. Click NEXT.
- Options are provided to set bucket versioning and/or logging features. (By default, these features are suspended.) Bucket versioning and logging are described in Versioning and Logging. In addition, object locking is available to help prevent objects from being deleted or overwritten for a fixed amount of time or indefinitely. Object locking can be enabled only while creating the bucket, as described in Object Locking.
We will not change the versioning and logging defaults for this exercise. So, click NEXT.
- The bucket properties are displayed for your review. You can click BACK to change the bucket properties. But, for this exercise, click CREATE BUCKET to accept the information and create the bucket.
A message at the top of your screen indicates that the bucket was created successfully. The new bucket is displayed on the Object Storage panel.
Each bucket is displayed with:
- Bucket name that, when clicked, provides access to object information (you will see this later when Storing Objects in a Bucket)
- Owner name, which is the name of the person who created the bucket
- Region in which the bucket was created
- Public Access status of the bucket (Default indicates that the bucket is private)
- Date/time when the bucket was created
- Options accessed with the
icon in the Actions column to:
- Change settings for versioning, logging, bucket policy, compliance, and an access control list (ACL)
- Rename the bucket
- Delete the bucket
- Click
in the upper right corner of the panel to toggle the display of each column.
Working With a Bucket
Click on the icon to access options for bucket features. Procedures for use of these features are beyond the scope of this Getting Started Guide, but the following is an overview. (For details about buckets, refer to the Buckets and Objects section of the Wasabi Cloud Storage: Advanced Usage Product Guide.)
- Establishing bucket settings. You can set:
- Versioning and/or logging features. Versioning is a way to maintain multiple variations of an object in the same bucket. You can then retrieve and restore any version of an object in the bucket. This provides protection against inadvertent removal of an object (such as by overwriting or expiration).
- Policy for the bucket. You can attach a policy to define the actions that can take place on a bucket and the conditions under which those actions can occur.
- Compliance features. Compliance features prevent the deletion of any objects and provides additional information to prove that the original data is not modified since the time it was stored.
- Object locking. Object locking can help prevent objects from being deleted or overwritten for a fixed amount of time or indefinitely. Versioning must be enabled on a bucket before object locking is enabled. And, object locking can be enabled only while creating the bucket. Once enabled, the Object Locking tab is available under bucket settings, where you can configure either governance or compliance mode along with retention time.
- Access control list (ACL) features. An ACL enables you to manage the users and groups that have access to buckets and objects.
- Changing the bucket name.
- Deleting the bucket.
Storing Objects in a Bucket
Now that you created a bucket, you can store an object in it on Wasabi. An object can be any type of file—text, photo, video, etc.
- In the Object Storage list, click the bucket name (as circled below) into which you want to upload an object.
- The bucket content panel is displayed. If your bucket already held objects, the panel would list the object names and associated information (as you will see later in this procedure). With an empty bucket, you will see a panel such as:
Click UPLOAD FILES.
- The Upload Files window is displayed.
You can upload files and folders in two different ways:
Drag and drop files or folders onto the Drag & Drop Files and Folders area of the panel. (Continue with Step 4.)
OR
Upload a file(s) by clicking the BROWSE FILES button. Then, navigate to find the file(s) you want to upload. You can use the Shift or Ctrl keys to select multiple files. (Continue with the next step.) If you choose the same file name from different folders, Wasabi will store the file chosen last before the upload starts.Avoid the use of the following special characters in a file name:
% (percent)
< (less than symbol)
> (greater than symbol)
\ (backslash)
# (pound sign)
? (question mark)Certain file names may have non-ASCII characters that are 4 byte UTF8 characters (such as emojis). Wasabi does not support these characters and will return a 400 error message to an application that tries to write a file with 4 byte UTF characters in the file name. We recommend renaming the affected files, if possible.After you initiate the upload, you will see an alert that indicates the objects are attaching and you should wait until this is done.
When you upload a file, it is listed on the Upload Files panel. For example:
When you upload a folder, all files are listed and a scroll bar appears to the right of the files, enabling you to scroll through the file names. For example:
To remove a file from the list before uploading, click X to the right of the file name.
To remove all selected files before uploading, click CLEAR FILES. - Click START UPLOAD to upload the objects.
To remove a file from the list after you start uploading, click
to the right of the file name. A check appears to the right of each file name when it is successfully uploaded. When the upload is complete, you are returned to the Upload Files panel where you can repeat these steps to upload additional folders or files. For now, close the Upload Files window by clicking
. A message at the bottom of the Object Storage panel indicates the upload status. For example:
When the file upload is in progress, you can minimize the Upload Files window by clicking the X in the upper right corner. When the Upload Files window is minimized and an upload is in progress, you can navigate to all pages, except Billing.The message, "Network Failure," is displayed if the network is interrupted during an upload.The time it takes to upload or download your storage to or from Wasabi is dependent on a number of factors including:- The volume of storage (which will vary for each customer
- The Internet speed you have from your location (which will vary for each customer)
- The Internet speed that Wasabi supports (multiple 10 GB/s connections per data center)
Uploaded Files
Uploaded files are listed on the Object Storage panel. The following example shows multiple files stored in the widget-project bucket.
Folders and files are displayed with a Name, Type, Last Modified (date), and Size. You can click the column heading to sort the listing by:
- Name—number and then alphabetically (a to z) or reverse.
- Last Modified—oldest to newest date, or newest to oldest.
- Size—smallest size to largest, or largest to smallest.
Folders
Each folder is displayed with:
- Folder select icon.
enables you to select one or more folders to delete, make public, or make private.
- Folder name.
- Folder type (details). Click
to display folder details.
The Last Modified and Size columns are left blank intentionally.
Files
Each file is displayed with:
- File select icon.
enables you to select one or more files to delete, make public, or make private.
- File name.
- File type. Icons indicate the file type, such as for text
, graphics
, and media
. The icon is
if the file is a version. Click the icon to display file details.
- Date/time when the file was last modified.
- Size of the file.
In addition, notice the icons in the upper right part of the objects list:
accesses the bucket Settings panel with options described for the Wasabi Management Console.
toggles between hiding and showing file versions if versioning is enabled. The version icon
to the right of the file name indicates the file is a version. This tool is not available if a folder is empty.
enables you to toggle the display of each column. This tool is not available if a folder is empty.
provides more options for deleting folders/files and making folders/files private or public (described below). These options are not available if a folder is empty.
Working with Folders and Files
Before moving on to Step 3, you may want to review more detail about folders and files.
Objectives Met!
![]() | Sign up for Wasabi and sign in. |
![]() | Work with buckets and objects. |
![]() | Create a user account and access key.![]() |