minio/docs

mirror of https://github.com/minio/docs.git synced 2025-08-09 13:02:53 +03:00

Files

Ravind Kumar 76e5e35ab3 DOCS-1191: Updating SSE params, general fixups (#1295 )

Closes #1191 

# Summary

Finally getting around to this mc release

- Added docs for enc-c, enc-s3, enc-kms
- Some docs are making assumptions around behavior that needs to be
fixed _first_
- Drive-by linker fixes

Staged: http://192.241.195.202:9000/staging/DOCS-1191/linux/index.html

---------

Co-authored-by: Andrea Longo <feorlen@users.noreply.github.com>
Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com>

2024-08-26 11:54:49 -04:00

4.1 KiB

Raw Permalink Blame History

`mc ilm restore`

minio

Table of Contents

mc ilm restore

Syntax

The mc ilm restore command creates a temporary copy of an object archived on a remote tier. The copy automatically expires after 1 day by default.

Use this command to allow applications to access a tiered object through the MinIO deployment (e.g. "hot tier"). The archived object remains on the remote tier, while the temporary copy becomes HEAD for that object.

mc RELEASE.2023-04-12T02-21-51Z

Use mc stat to display whether a restored object reads from the local temporary copy or the remote tier. Objects currently in the process of restoration from the remote tier show a status of Ongoing : true.

EXAMPLE

The following command restores a copy of a transitioned object from the remote tier back to the myminio MinIO deployment:

mc ilm restore myminio/mybucket/object.txt

SYNTAX

The command has the following syntax:

mc [GLOBALFLAGS] ilm restore         \
                 [--days "int" ]     \
                 [--recursive]       \
                 [--vid "string"]    \
                 [--versions]        \
                 [--enc-c "string"]  \
                 ALIAS

Parameters

ALIAS

The MinIO alias <alias>, bucket, and path to the archived object to restore.

mc ilm restore myminio/mybucket/object.txt

--days

The number of days after which MinIO expires the restored copy of the archived object.

--recursive, r

Restores all objects under the specified prefix.

--versions

Restores all versions of the object on the remote tier.

--version-id, vid

Restores the specified version of the object on the remote tier.

Global Flags

Examples

Restore an Archived Object

The following command restores an object archived to a remote tier:

mc ilm restore myminio/mybucket/object.txt

Restore a Specific Archived Object Version

The following command restore a specific object version archived to a remote tier:

mc ilm restore --vid "VERSIONID" myminio/mybucket/object.txt

Restore All Archived Objects at a Bucket Prefix

The following command restores all objects archived under a specified prefix on the remote tier:

mc ilm restore --recursive myminio/mybucket/data/

Behavior

Restored Objects Expire Automatically

MinIO automatically expires the restored object copy after the specified number of days (Default: 1 day).

Restored Objects Become HEAD

The restored object copy becomes HEAD for that object namespace regardless of it's versioning history. This can result in applications returning "stale" data while the local copy exists.

4.1 KiB Raw Permalink Blame History