mc undo

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

Syntax

Example Syntax

The command has the following syntax:

mc [GLOBALFLAGS] undo                \
                 TARGET              \
                 [--action "type"]   \
                 [--force]           \
                 [--last "integer"]  \
                 [-- recursive

*Alias:* -r]    \
                 [--dry-run]

Brackets [] indicate optional parameters.
Parameters sharing a line are mutually dependent.
Parameters separated using the pipe | operator are mutually exclusive.

Copy the example to a text editor and modify as-needed before running the command in the terminal/shell.

Parameters

TARGET

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

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 myaistor/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 myaistor/data/archive --recursive --action "DELETE"

Mutually exclusive with --last.

--dry-run

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

Optional

Force a recursive operation.

--last

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

Alias: -r

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 myaistor deployment in the data bucket:

mc undo myaistor/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 myaistor alias in the data bucket under the presentations/recordings/ prefix:

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

Behavior

S3 compatibility

The mc commandline tool is built for compatibility with the AWS S3 API and is tested with AIStor and AWS S3 for expected functionality and behavior.

MinIO provides no guarantees for other S3-compatible services, as their S3 API implementation is unknown and therefore unsupported.

While mc commands may work as documented, any such usage is at your own risk.