About OOS

Object storage is a storage architecture that manages data as objects accessible through URLs, rather than as files. It is especially efficient and scalable for large amounts of unstructured data, such as backups, archives, images, audio-video content, big data, etc.

The OUTSCALE Object Storage (OOS) service is based on the RING solution by Scality. This service is compatible with the Simple Storage Service (S3) API by AWS. You can therefore use OOS with any S3-compatible tool. For more information, see About Tools to Use OOS.

Common Concepts

Buckets

On the OUTSCALE Cloud, a bucket is a logical resource for hosting objects.

Versioning can be enabled on a bucket, so that every upload of an object is retained and can be accessed.

For more information, see Managing Your Buckets.

Buckets can also be used to:

Host static websites. For more information, see Tutorial: Getting Started with OOS Using AWS CLI.
Export your OUTSCALE Machine Images (OMIs) and your snapshots. For more information, see Exporting an OMI to a Bucket and Exporting a Snapshot to a Bucket.
Store the access logs of your load balancers. For more information, see About Access Logs.

The name of a bucket must:

Be unique for the whole Region
Contain between 3 and 63 characters
Start with an alphanumerical character
Contain only lowercase letters, numbers, and hyphens (-)

You can enable cross-origin resource sharing (CORS) on your buckets. A use case of CORS is to allow your website hosted in a bucket A to load files hosted in a bucket B. Without CORS, the same-origin policy of the browser would block this loading by default as a security measure.

For more information on CORS configuration, see Managing CORS on Your Buckets.

Objects

An object corresponds to an uploaded file or a piece of data. You can upload objects in your own buckets or in buckets for which you have write permissions.

An object is identified by a key, which is essentially the name of the object. To organize your objects, you can add a prefix to the key, in the format <PREFIX>/<REST_OF_THE_KEY>. Tools for using object storage generally group same prefixes in a tree view, similar to how folders are displayed in a file browser.

You can also add tags to objects in order to further identify and categorize them. For more information, see Managing the Tags of an Object.

If you have read permission for an object, you can download the object using a URL in either of the following formats:

https://oos.<REGION>.outscale.com/<BUCKET>/<OBJECT_KEY>
https://<BUCKET>.oos.<REGION>.outscale.com/<OBJECT_KEY>

For more information, see Working With Objects.

Objects are not limited in size. The maximum size for one upload is 5 GiB, but you can also upload files in multiple parts. For optimal upload performance, it is recommended that files larger than 100 MiB be uploaded in multiple parts. For more information, see Using Multipart Upload.
You can manage the lifecycle of your objects by setting expiration dates after which they will be automatically deleted. For more information, see Managing the Lifecycle of Your Objects.

ACLs and Pre-Signed URLs

By default, only the creator of an object can access the object. Two features enable you to make your object available to other users:

Access control lists (ACLs): An ACL enables you to grant read or write permissions to another OUTSCALE user for a bucket or an object. For more information, see Managing Access to Your Buckets and Objects.

You grant permissions by specifying S3 user IDs. You can retrieve S3 user IDs via the Listing Your Buckets and Listing the Objects of a Bucket methods.
Pre-signed URLs: A pre-signed URL can be generated to make an object accessible to anyone who has the link, for a set duration. For more information, see Configuring a Pre-Signed URL.

Recommendations

For an optimal use of your buckets, we recommend the following:

not exceeding 100 buckets per account (could be extended to 1000),
not exceeding 5TB as the maximum size for storable objects,
not exceeding 10 million versions, including delete markers, in a single bucket,
not exceeding 300 downloads per second in a single bucket for GET/HEAD requests,
not exceeding 200 uploads per second in a single bucket for PUT/COPY/POST/DELETE requests,
not exceeding 10 tags per object,
not exceeding 128 characters in key size and 256 characters in value size for a tag.

Related Pages

AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.