mc undo

Syntax

The mc undo command reverses changes due to either a PUT or DELETE operation at a specified path.

mc undo myminio/data/file.zip --last 3

mc [GLOBALFLAGS] undo                \
                 TARGET              \
                 [--action "type"]   \
                 [--force]           \
                 [--last "integer"]  \
                 [--recursive, r]    \
                 [--dry-run]

Parameters

TARGET

mc-cmd

Required

The full path to the object or prefix where the command should run. The path must include the ALIAS, bucket, and prefix or object name.

--action

mc-cmd

Optional

Undo the most recent change of the specified type. Accepted values are DELETE or PUT.

By default, mc undo reverses both DELETE and PUT operations. Use --action to choose one or the other, but only for the most recent operation of the specified type.

The following command reverts the most recent PUT for the object today.zip in bucket data, reverting to the previous object version:

mc undo myminio/data/today.zip --action "PUT"

This example reverts the most recent DELETE for the prefix archive, recursively restoring it and any child objects:

mc undo myminio/data/archive --recursive --action "DELETE"

Mutually exclusive with --last.

--dry-run

mc-cmd

Optional

Output the results of the command without actually performing the operations. Use this flag to test the outcome of running the command in a particular way.

--force

mc-cmd

Optional

Force a recursive operation.

--last

mc-cmd

Optional

Accepts an integer value specifying the number of PUT and/or DELETE changes to undo.

If not specified, the command reverses one (1) operation. Mutually exclusive with --action.

--recursive, r

mc-cmd

Optional

Performs the command in a recursive fashion. Use this flag to undo changes on a prefix, for example.

Global Flags

This command supports any of the global flags.

Examples

Undo the Last Three Uploads or Deletions on an Object

The following command reverts the last three uploads and/or deletions of the file.zip object on the myminio deployment in the data bucket:

mc undo myminio/data/file.zip --last 3

Undo the Last Upload or Deletion of any Object at a Prefix

Use mc undo to reverse the most recent PUT or DELETE operation performed on the myminio alias in the data bucket under the presentations/recordings/ prefix:

mc undo myminio/data/presentations/recordings/ --recursive --force

Behavior

S3 Compatibility

SILO is the supported server for PGSTY mcli; compatibility with upstream MinIO and other S3 services is best effort.