From 48802b0a3baa15ebf36eec14bb9351e2b92a9f98 Mon Sep 17 00:00:00 2001 From: Markus Gerstel Date: Sun, 9 Mar 2025 10:22:01 +0000 Subject: [PATCH] s3: documentation regression - fixes #8438 We lost a previous documentation fix (#7077) detailing how to restore single objects from AWS S3 Glacier. Also make clearer that rclone provides restore functionality natively. Co-authored-by: danielkrajnik --- backend/s3/s3.go | 2 +- docs/content/s3.md | 3 ++- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/backend/s3/s3.go b/backend/s3/s3.go index 1d9dd936a..dd7d7dcb0 100644 --- a/backend/s3/s3.go +++ b/backend/s3/s3.go @@ -5093,7 +5093,7 @@ or from INTELLIGENT-TIERING Archive Access / Deep Archive Access tier to the Fre Usage Examples: - rclone backend restore s3:bucket/path/to/object -o priority=PRIORITY -o lifetime=DAYS + rclone backend restore s3:bucket/path/to/ --include /object -o priority=PRIORITY -o lifetime=DAYS rclone backend restore s3:bucket/path/to/directory -o priority=PRIORITY -o lifetime=DAYS rclone backend restore s3:bucket -o priority=PRIORITY -o lifetime=DAYS rclone backend restore s3:bucket/path/to/directory -o priority=PRIORITY diff --git a/docs/content/s3.md b/docs/content/s3.md index 77a571f03..b21e46930 100644 --- a/docs/content/s3.md +++ b/docs/content/s3.md @@ -771,7 +771,8 @@ tries to access data from the glacier storage class you will see an error like b 2017/09/11 19:07:43 Failed to sync: failed to open source object: Object in GLACIER, restore first: path/to/file In this case you need to [restore](http://docs.aws.amazon.com/AmazonS3/latest/user-guide/restore-archived-objects.html) -the object(s) in question before using rclone. +the object(s) in question before accessing object contents. +The [restore](#restore) section below shows how to do this with rclone. Note that rclone only speaks the S3 API it does not speak the Glacier Vault API, so rclone cannot directly access Glacier Vaults.