Skip to main content

Buckets

To upload your data (photos, videos, documents, etc.) to Storage, you must first create a Storage bucket. You can then upload any number of objects to the bucket.

In terms of implementation, buckets and objects are Storage resources, and GjirafaTech Captain provides APIs for you to manage them. For example, you can create a bucket and upload objects using the GjirafaTech Captain Storage API. You can also use the GjirafaTech Captain Storage UI to perform these operations. The UI uses the GjirafaTech Captain Storage API to send requests to GjirafaTech Captain Storage.

Bucket naming rules#

The following rules apply for naming buckets in GjirafaTech Captain:

  • Bucket names must be between 3 and 63 characters long.

  • Bucket names can consist only of lowercase letters, numbers, dots (.), and hyphens (-).

  • Bucket names must begin and end with a letter or number.

  • Bucket names must not be formatted as an IP address (for example, 192.168.5.4).

Steps to follow when Creating a Bucket#

The section below summarizes the process of creating a Bucket:

To create a Bucket:

  1. Click on top of the left Create Bucket button
  2. Choose a datacenter region (EUWest or EUEast)
  3. Choose file listing type (Restrict or Enabled)
  4. Choose a unique subdomain which represents a bucket name (always follow the bucket naming rules)
  5. Choose an option for bucket versioning (Enabled or Disabled)
  6. Add tags with key value pair (not required)

NOTE: Versioning is a means of keeping multiple variants of an object in the same bucket. You can use versioning to preserve, retrieve, and restore every version of every object stored in your bucket. With versioning, you can easily recover from both unintended user actions and application failures

Steps to follow when Deleting a Bucket#

The below section summarizes the process of deleting a Bucket:

To delete a Bucket:

  1. Inside a bucket click Settings button
  2. Scroll down and on the bottom right click the Delete button
  3. Enter the name of the bucket to confirm the deletion
  4. Click Delete

Steps to follow when Emptying a Bucket#

The below section summarizes the process of emptying a Bucket:

To empty a Bucket:

  1. On the listing bucket click more options icon
  2. You can choose to delete or empty a bucket

Steps to follow when Updating a Bucket#

The section below summarizes the process of updating a Bucket:

To update a Bucket:

  1. Inside a bucket, on the top right click Bucket Settings button
  2. You can update File Listing
  3. You can update Tags
  4. You can update CORS settings