Object Storage - Getting started

Click Object Storage under Storage in the left-hand menu of your Public Cloud project. Your buckets are listed in the Containers tab.

In the Containers tab, click Create an object container.

In the Container type section, select S3-compatible API, then enter the name of your bucket in the Container name section (3 to 63 lowercase characters, . and - allowed).

Select a deployment mode.

Select a region.

If you have selected a 3-AZ region, the Offsite Replication section lets you replicate your data automatically to a remote site. Enabling it also enables versioning.

In a Local Zone region, the bucket is created with its name only. In the other regions, you can then configure the following sections.

Versioning: versioning allows you to keep multiple variants of an object in the same bucket. This feature helps preserve, retrieve, and restore every version of every object stored in your buckets, making it easier to recover from unintended user actions or application failures. By default, versioning is disabled on buckets, and you must explicitly enable it. Find more information about versioning on our dedicated guide.

Object Lock: you can also enable Object Lock to store your objects in WORM (Write Once, Read Many) mode and guarantee their immutability for a defined retention period. Versioning must be enabled first. Then tick I understand that Object Lock cannot be disabled later.

User: you can link an Object Storage user to the bucket. Select an existing user in the list (click View credentials to check their credentials), or click Create a user to create one. The secret key of a new user is shown only once: save it.

Encryption: you can decide whether or not you wish to encrypt your data using SSE-OMK (server-side encryption with OVHcloud Managed Keys). Select Server-side encryption (SSE-OMK) or No encryption.

Check the summary of your bucket, then click Create.

In the Containers tab, click the name of your bucket: its Objects tab opens. Click Add an object.

In the panel that opens, you can enter a Prefix to add to the name of your objects (the object name is the same as the file name) and select a Storage class. Drag and drop your files or click Browse files, then click Upload.

In the Objects tab of your bucket, click the Download icon on the object row.

Deleting a bucket

In the Containers tab, click the ... button on the bucket row, then Delete.

Type TERMINATE to confirm (EMPTY AND TERMINATE if the bucket still contains objects), then click Delete.

Deleting objects

Go to the bucket and open the Objects tab.

Click the Delete icon on the object row, then click Delete to confirm. If versioning is not enabled on the bucket, the deletion is permanent.

Setting tags on a bucket:

aws s3api put-bucket-tagging --bucket <bucket_name> --tagging 'TagSet=[{Key=myKey,Value=myKeyValue}]'
aws s3api get-bucket-tagging --bucket <bucket_name>

{
  "TagSet": [
    {
    "Value": "myKeyValue",
    "Key": "myKey"
    }
  ]
}

Deleting tags on a bucket:

aws s3api delete-bucket-tagging --bucket <bucket_name>

Setting tags on an object:

aws s3api put-object-tagging --bucket <bucket_name> --key <object_name> --tagging 'TagSet=[{Key=myKey,Value=myKeyValue}]'
aws s3api get-bucket-tagging --bucket <bucket_name>

{
  "TagSet": [
    {
    "Value": "myKeyValue",
    "Key": "myKey"
    }
  ]
}

Deleting tags on an object:

aws s3api delete-object-tagging --bucket <bucket_name> --key <object_name>