Skip to content

Commit 074b891

Browse files
committed
update with images and manager
1 parent 2e52678 commit 074b891

File tree

6 files changed

+225
-148
lines changed

6 files changed

+225
-148
lines changed

pages/storage_and_backup/object_storage/cold_archive_getting_started/guide.en-gb.md

Lines changed: 80 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Cold Archive - Getting started with Cold Archive
33
excerpt: This guide shows you how to manage your data with Cold Archive
4-
updated: 2024-11-29
4+
updated: 2025-07-04
55
---
66

77
## Objective
@@ -18,6 +18,11 @@ Restoration may take some time since data is read from tapes.
1818

1919
## Instructions
2020

21+
> [!primary]
22+
>
23+
> You can find the Cold Archive storage presentation and workflow [here](/pages/storage_and_backup/object_storage/cold_archive_overview).
24+
>
25+
2126
This section explains the step-by-step process to configure, archive, restore, and delete buckets with Cold Archive, in coexistence with your Object Storage.
2227

2328
In this tutorial, **awscli aliases** are used to simplify the commands.
@@ -67,10 +72,17 @@ aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net s3api list-multipart-
6772
> Before archiving a bucket, make sure there are no incomplete multipart uploads.
6873
>
6974
70-
71-
```bash
72-
aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net put-ovh-archive <bucket_name>
73-
```
75+
> [!tabs]
76+
> Via the AWS S3api
77+
>> ```bash
78+
>> aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net put-ovh-archive <bucket_name>
79+
>> ```
80+
>>
81+
> Via the OVHcloud Control Panel
82+
>> Click on` the three dots`{.action}, then select `Archive`{.action}
83+
>>
84+
>> ![Archive a cold archive bucket](images/cold_archive_01.png){.thumbnail}
85+
>>
7486
7587
- The bucket status changes to Archiving.
7688
- Objects cannot be read or written during this process; only listing is allowed.
@@ -126,11 +138,19 @@ If you want to edit the retention period, similarly, re-apply the intelligent ti
126138
127139
### Restore a Bucket
128140
129-
Restore a bucket:
130-
131-
```bash
132-
aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net put-ovh-restore <bucket_name>
133-
```
141+
> [!tabs]
142+
> Via the AWS S3api
143+
>> Restore a bucket :
144+
>>
145+
>> ```bash
146+
>> aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net put-ovh-restore <bucket_name>
147+
>> ```
148+
>>
149+
> Via the OVHcloud Control Panel
150+
>> Click on the `three dots`{.action}, then select `Restore`{.action}.
151+
>>
152+
>> ![Restore a cold archive bucket](images/cold_archive_02.png){.thumbnail}
153+
>>
134154
135155
- Bucket status changes to Restoring.
136156
- Objects become accessible in read-only mode once restoration completes.
@@ -145,9 +165,20 @@ aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net put-ovh-restore <buck
145165
146166
Delete an intelligent-tiering configuration and objects of a bucket:
147167
148-
```bash
149-
aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net delete-ovh-archive <bucket_name>
150-
```
168+
169+
> [!tabs]
170+
> Via the AWS S3api
171+
>> Delete an Intelligent-Tiering configuration and the objects in a bucket:
172+
>>
173+
>> ```bash
174+
>> aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net delete-ovh-archive <bucket_name>
175+
>> ```
176+
>>
177+
> Via the OVHcloud Control Panel
178+
>> Click on the `three dots`{.action}, then select `Delete`{.action}.
179+
>>
180+
>> ![Delete a cold archive bucket](images/cold_archive_03.png){.thumbnail}
181+
>>
151182
152183
After this request, the objects of the bucket are not deleted yet as the deletion is done asynchronously.<br>
153184
The operation will delete everything (on tapes and all objects if restored) and the bucket status will be in a "Deleting" status.<br>
@@ -171,32 +202,41 @@ aws s3 rb s3://<bucket_name>
171202
172203
### Check Bucket Status and Retention Tags
173204
174-
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:
175-
176-
```bash
177-
aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net s3api get-bucket-tagging --bucket <bucket_name>
178-
```
179-
180-
If you have locked your archive, you can check the retention period using the `get-bucket-tagging command`.
181-
182-
- Example:
205+
> [!tabs]
206+
> Via the AWS S3api
207+
>> 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:
208+
>>
209+
>> ```bash
210+
>> aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net >> s3api get-bucket-tagging --bucket <bucket_name>
211+
>> ```
212+
>>
213+
>> If you have locked your archive, you can check the retention period using the `get-bucket-tagging command`.
214+
>>
215+
>> - Example:
216+
>>
217+
>> ```bash
218+
>> aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net s3api get-bucket-tagging --bucket <bucket_name>
219+
>>
220+
>> {
221+
>> "TagSet": [
222+
>> {
223+
>> "Key": "ovh:intelligent_tiering_status",
224+
>> "Value": "Archived"
225+
>> },
226+
>> {
227+
>> "Key": "ovh:intelligent_tiering_archive_lock_until",
228+
>> "Value": "2124-01-19T15:24:56.000Z"
229+
>> }
230+
>> ]
231+
>> }
232+
>> ```
233+
>>
234+
> Via the OVHcloud Control Panel
235+
>> You can check the status of your bucket by looking at the value in the `Status` column, as well as its retention period in the `Locked until` column.
236+
>>
237+
>> ![Cold archive bucket information](images/cold_archive_04.png){.thumbnail}
238+
>>
183239
184-
```bash
185-
aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net s3api get-bucket-tagging --bucket <bucket_name>
186-
187-
{
188-
"TagSet": [
189-
{
190-
"Key": "ovh:intelligent_tiering_status",
191-
"Value": "Archived"
192-
},
193-
{
194-
"Key": "ovh:intelligent_tiering_archive_lock_until",
195-
"Value": "2124-01-19T15:24:56.000Z"
196-
}
197-
]
198-
}
199-
```
200240
201241
#### List of bucket statuses
202242
@@ -222,6 +262,8 @@ This command returns detailed configuration info useful for debugging or verific
222262
223263
## Go further
224264
265+
Check out our dedicated Discord channel: <https://discord.gg/ovhcloud>. Ask questions, share feedback, and interact directly with the team behind our storage and backup services.
266+
225267
If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](/links/professional-services) to get a quote and ask our Professional Services experts for assisting you on your specific use case of your project.
226268
227269
Join our [community of users](/links/community).

0 commit comments

Comments
 (0)