Skip to content

Buckets

Concepts

In SysEleven Object Storage, buckets are the basic containers that hold your data. They're used to organize and control access to your objects (files). Each bucket is a flat container, meaning there's no hierarchy of folders within a bucket. However, you can use prefixes and delimiters to organize objects in a way that mimics a folder structure.

List Buckets

Listing buckets shows you all the buckets in your SysEleven Object Storage account.

Configure CLI

Usage:

mc ls s11_dus2

This command lists all buckets in your SysEleven Object Storage account in the DUS2 region.

Output:

[2023-05-15 14:30:25 CEST]     0B my-first-bucket/
[2023-05-15 16:45:10 CEST]     0B my-second-bucket/

Create a Bucket

Creating a bucket is the first step to storing objects in SysEleven Object Storage.

Configure CLI

Usage:

mc mb s11_dus2/my-new-bucket

This command creates a new bucket named "my-new-bucket" in the DUS2 region.

Output:

Bucket created successfully `s11_dus2/my-new-bucket`.

View Bucket Details

You can view details about a specific bucket, including its size and the number of objects it contains.

Configure CLI

Usage:

mc stat s11_dus2/my-bucket

This command displays statistics for the bucket named "my-bucket".

Output:

Name      : my-bucket
Date      : 2023-05-15 14:30:25 CEST
Size      : 256 MiB
Objects   : 1000

Delete a Bucket

You can delete a bucket when you no longer need it. Note that the bucket must be empty before it can be deleted.

Configure CLI

Usage:

mc rb s11_dus2/my-bucket

This command removes the bucket named "my-bucket". If the bucket is not empty, you'll need to use the --force flag to remove it and all its contents:

mc rb s11_dus2/my-bucket --force

Output:

Removed `s11_dus2/my-bucket` successfully.

Bucket Policies

Bucket policies allow you to manage access permissions to your buckets and the objects within them.

Work in Progress

This section is work in progress.