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
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
.
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:
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)
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