Guide

Create and manage buckets

Buckets are the primary containers within Object Storage. Each bucket stores your files (objects) and lets you access or share those files. For information about Object Storage product limits, including bucket rate limits, go to the Quotas and limits page.

View buckets

Log in to Cloud Manager and select Object Storage from the left menu. If you currently have buckets on your account, they are listed on this page, along with their URL, region, endpoint type, date created, size, and the number of objects (files) they contain.

A screenshot of the Buckets table showing the bucket name.

You can also view your bucket through the Linode CLI, Cyberduck, s3cmd, and s4cmd.

Create a bucket

One of the first steps to using Object Storage is to create a bucket. Here's how to create a bucket using Cloud Manager, though you can also use the Linode CLI, s3cmd, and s4cmd.

  1. Navigate to the Object Storage page in Cloud Manager (see View buckets).

  2. Click the Create Bucket button to open the Create Bucket panel. If you have not created an access key or a bucket on this account, you are prompted to enable Object Storage.

    📘

    Billing for Object Storage starts as soon as it is enabled on the account. See Object Storage Pricing for more detail on the minimum flat-rate and per GB charge. See Cancel Object Storage for instructions on cancelling this service.

  3. Within the Create Bucket form, enter a Bucket Name for the new bucket. This name must be unique and should not be used by any other bucket (from any customer) in the selected data center. Keep the following formatting requirements in mind:

    • Must be between 3 and 63 characters in length.

    • Can only contain lower-case characters, numbers, periods, and dashes.

    • Must start with a lowercase letter or number.

    • Cannot contain underscores (_), end with a dash (-) or period (.), have consecutive periods (.), or use dashes (-) adjacent to periods (.).

    • Cannot be formatted as IP addresses.

    • You cannot upload files to Object Storage that contain the following characters, " ' < > & + = when using Cloud Manager or the Linode CLI.

    📘

    If you intend to use this bucket with a custom domain, the bucket name must be your fully qualified domain name, such as assets.example.com or any subdomain of *.your-domain.tld.

  4. Choose a Region for the bucket to reside. See the Availability section on the Object Storage Overview page for a list of available regions.

  5. Review the Endpoint Type information.

    Most regions only support one endpoint type. For these regions the endpoint type information is read only. There are, however, a few regions that support more than one endpoint type. You should select the highest option available to take advantage of the greater performance and capacity limits.

    To learn more, go to the Endpoint types guide. You can also review the Product limits guide to review the performance, capacity, and rate limits available for each endpoint type.

  6. Click Submit to create the bucket.

You are now ready to upload files to the bucket.

Delete a bucket

Follow these steps to delete an Object Storage bucket from Cloud Manager. You can also use the Linode CLI, s3cmd, and s4cmd.

📘

Only empty buckets are able to be deleted through Cloud Manager. To delete objects, see Delete a File/Object. Alternatively, you can use the following s3cmd command, which deletes a non-empty bucket. See s3cmd > Delete a Bucket for more details.

s3cmd rb -r -f s3://example-bucket/

  1. Navigate to the Object Storage page in Cloud Manager (see View buckets .

  2. Locate the bucket you wish to delete and click the corresponding Delete button.

A screenshot of the Buckets table showing the Delete button.
  1. A dialog box appears that prompts you to enter the bucket's name as a way to confirm that you'd like to delete the bucket. Type the bucket's name into the text entry field and click Delete.

A screenshot of the Delete Bucket window highlighting the Delete Bucket button.

📘

Reusing the name of a deleted bucket

After you delete a bucket, time is required for resources associated with this bucket to be released. Typically this process completes in less than 60 minutes. During this time, if you attempt to create a bucket with that same name in the same endpoint, you will receive a 409 BucketAlreadyExists error if the name is not yet available. Please be aware that if you are using a common name, another account may create a bucket with the same name when it becomes available, which will prevent you from reusing that name. It is generally advisable to never delete a bucket if you require the use of a specific name.

Updated 4 days ago