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.
Create 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.jpgis stored in the
DOC-EXAMPLE-BUCKETbucket in the US East Region, then it is addressable using the URL
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.
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 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.
The following example bucket names are valid and follow the recommended naming guidelines:
The following example bucket names are not valid:
DocExampleBucket(contains uppercase letters)
- doc-example-bucket- (ends with a hyphen)
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.