Work with Buckets

To store your data in Oort DSS, you work with resources known as buckets and objects. A bucket is a container for objects. An object is a file and any metadata that describes that file.
To store an object in Oort DSS, you create a bucket and then upload an object to the bucket. Once an object is in a bucket, you can open it, download it, and move it. You can delete objects and buckets when you no longer need them.
Intro
Names
Manage
Create a Bucket
What is a bucket?
A bucket is a container for objects stored in Oort DSS. You can store any number of objects in a bucket and can have up to 100 buckets in your account. 
Every object is contained in a bucket. For example, if the object named photos/puppy.jpg is stored in the DOC-EXAMPLE-BUCKET bucket in the US East Region, then it is addressable using the URL https://DOC-EXAMPLE-BUCKET.dss.us-east-1.oortech.com/photos/puppy.jpg. 
​
Manage buckets
Oort DSS provides APIs for you to manage your buckets and objects. For example, you can create a bucket and upload objects using the Oort DSS S3-Compatible API or the Oort DSS console. The console uses the Oort S3-Compatible APIs to send requests to Oort DSS.
Work with Objects
Bucket names
Each bucket on Oort DSS must be given a unique name, meaning a bucket's name cannot be used by another Oort Cloud account until the bucket is deleted. You should not depend on specific bucket naming conventions for the sake of availability or security.
​
Bucket naming rules
Bucket names must be between 3 (min) and 63 (max) characters long.
Bucket names can consist only of lowercase letters, numbers, and hyphens (-).
Bucket names must begin and end with a letter or number.
Bucket names must be unique.
A bucket name cannot be used by another Oort account until the bucket is deleted.
​
Examples
The following example bucket names are valid and follow the recommended naming guidelines:
docexamplebucket1
log-delivery-march-2020
my-hosted-content
The following example bucket names are not valid:
doc_example_bucket (contains underscores)
my.example.s3.bucket (contains dots)
DocExampleBucket (contains uppercase letters)
doc-example-bucket- (ends with a hyphen)
Managing your buckets in Oort DSS is quick and easy, thanks to our intuitive user interface. Simply right-click on the bucket you want to manage, and a menu of options will appear, allowing you to edit the bucket's properties, transfer data in and out of the bucket, and more.
​
Create a bucket
Create a Bucket
Other ways to create a bucket
You can use the Oort DSS console, Oort DSS S3-Compatible APIs, AWS CLI, or AWS SDKs to create a bucket. For more information about the permissions required to create a bucket, see Create Bucket in the Oort DSS S3-Compatible API Reference.
​
​
Last modified 6mo ago
Work with Buckets

What is a bucket?

Manage buckets

Bucket names

Bucket naming rules

​

Examples

​

Create a bucket

Other ways to create a bucket
