Cold Archive - Getting started with Cold Archive (EN)

Last updated 19th October 2022

Objective

Cold Archive is a service for long-term data storage. When archived, every object of a bucket is stored on physical tapes. Restoration can take some time as it needs to be read on tapes.

This guide explains how to set up storage on tapes with Cold Archive.

Requirements

• Getting started with Object Storage
• awscli version >= 1.16.62

Instructions

In this tutorial, awscli aliases are used to simplify the commands.

mkdir -p ~/.aws/cli
touch ~/.aws/cli/alias

Add this content to the file:

[toplevel]

put-ovh-archive = s3api put-bucket-intelligent-tiering-configuration --id myid --intelligent-tiering-configuration '{"Id": "myid", "Status": "Enabled", "Tierings": [{"Days": 999,"AccessTier": "OVH_ARCHIVE"}]}' --bucket

put-ovh-restore = s3api put-bucket-intelligent-tiering-configuration --id myid --intelligent-tiering-configuration '{"Id": "myid", "Status": "Enabled", "Tierings": [{"Days": 999,"AccessTier": "OVH_RESTORE"}]}' --bucket

get-ovh-bucket-status = s3api get-bucket-intelligent-tiering-configuration --id myid --bucket

delete-ovh-archive = s3api delete-bucket-intelligent-tiering-configuration --id myid --bucket

Bucket archiving

After its creation, a bucket is in write-only mode.
Allowed actions are adding and listing objects.

Archive a bucket:

aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net put-ovh-archive <bucket_name>

After this request, the bucket is not archived yet.
It will take some time before it is archived on the tapes.
From this command and until a restoration, the bucket cannot accept any read or write requests on objects (listing objects is still allowed).

Bucket restoring

Restore a bucket:

aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net put-ovh-restore <bucket_name>

After this request, the bucket is not restored yet.
It will take some time before it is restored and for the objects to be accessible in read-only (writing objects is forbidden).

Bucket deletion

Delete an intelligent-tiering configuration and objects of a bucket:

aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net delete-ovh-archive <bucket_name>

After this request, the objects of the bucket are not deleted yet.
It will take some time before objects are deleted.
Once objects are deleted, the bucket can be released:

aws s3 rb s3://<bucket_name>

Bucket status

Once an intelligent-tiering configuration has been pushed (via a put-bucket-intelligent-tiering-configuration operation) and until it is removed (via a delete-bucket-intelligent-tiering-configuration operation), the status of a bucket is readable through:

aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net get-ovh-bucket-status <bucket_name> | jq '.IntelligentTieringConfiguration.Status'

List of bucket statuses

Go further

Join our community of users on https://community.ovh.com/en/.

Diese Anleitungen könnten Sie auch interessieren...