Step 1: Create a Bucket

This chapter describes how to create a storage container (Bucket) and the related precautions. Objects are stored in storage containers, so a storage container must be created before data can be stored in DeOSS.

Control permissions

The storage container information is readable by everyone, but only the Bucket owner can control the operation.

Access region

DeOSS is a distributed storage service, so the data comes from different regions around the world.


Creating a bucket will deduct a certain amount of gas fee, which will be deducted from the gateway's account.


Naming conventions for a bucket:

  • The name must be unique in the current account.

  • Its length must be between 3 ~ 63 characters.

  • Can only consist of lowercase letters, numbers, dots (.), and hyphens (-).

  • Must start and end with a letter or number.

  • Must not contain two adjacent periods.

  • Must not be formatted as an IP address.

A bucket creation restrictions:

Each account can create up to 1000 storage containers.

Life cycle:

Note that the information of the storage container will be stored on the chain. CESS storage space is time-sensitive. After the expiration date, the storage container will be retained for 7 days.

If there is not enough free space in the account after 7 days, the storage container will be automatically deleted.

Ways to create a bucket

Currently, we use the gateway to request DeOSS services. Please refer to PutBucket for creating storage containers.

Next step

To add objects to your bucket, see Step 2: Upload Object.

Last updated