LogoLogo
AboutOORT AIOORT StorageOORT Edge
  • What is OORT Storage
  • Getting Started
    • How it works
    • User Guide
      • Sign Up
      • Create a Bucket
      • Upload an Object
      • Download an Object
      • Delete Objects or Buckets
    • Billing and Pricing
      • Free Tier, Always Free
      • Pay-as-you-go Pricing
      • OORT Credits
      • Manage Your Payments
  • Manage Storage
    • Work with Buckets
    • Work with Objects
      • Objects Overview
      • Object Keys
      • Object Details
      • Upload Objects
      • Multipart Upload
      • Download Objects
      • Delete Objects
      • Share Objects
      • Use Folders
    • Storage Classes
    • Access Control
    • Tools and Clients
      • Use Rclone
      • Use AWS CLI
      • Use S3 Browser
      • Use Arq Backup
      • Use TntDrive
    • Sync files to OORT Storage
      • Step 1: Download the rclone
      • Step 2: Do the OORT Storage remote configuration
      • Step 3: Check where your files are stored in?
        • Google Drive
        • Amazon Drive
        • Tencent Cloud Object Storage (COS)
        • Alibaba Cloud (Aliyun) Object Storage System (OSS)
        • IPFS
        • Others
      • Step 4: Check the configuration
      • Step 5: Do the files syncs
  • Developing with OORT Storage
    • Access Keys
    • Use S3-Compatible API
  • OORT Storage for Business
    • Web3 Web Hosting
      • Upload Website
      • Backend Hosting
      • Publishing
Powered by GitBook
On this page
  1. Manage Storage

Work with Buckets

PreviousManage Your PaymentsNextWork with Objects

Last updated 1 year ago

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.

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.

Work with Objects
Create a Bucket