Links

Work with Buckets

To store your data in OORT Storage, 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 Storage, 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 Storage. 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 Storage provides APIs for you to manage your buckets and objects. For example, you can create a bucket and upload objects using the OORT Storage S3-Compatible API or the OORT Storage console. The console uses the OORT S3-Compatible APIs to send requests to OORT Storage .

Bucket names

Each bucket on OORT Storage must be given a unique name, meaning a bucket's name cannot be used by another OORT 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 Storage 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

Other ways to create a bucket

You can use the OORT Storage console, 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 S3-Compatible API Reference.