mc admin cluster bucket export

The mc admin cluster bucket export command exports bucket metadata for use with the (mc admin cluster bucket import) command.

You can use this command to manually back up the metadata for the specified MinIO AIStor bucket. The command always saves the output as cluster-metadata.zip.

If you specify only the deployment as the target, this command backs up all bucket metadata on the target deployment.

Syntax

Example Syntax

The command has the following syntax:

mc [GLOBALFLAGS] admin cluster bucket export  \
                                      ALIAS[/BUCKET]

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

ALIAS

Required

The alias of the MinIO AIStor deployment.

BUCKET

Optional

The bucket to export metadata for.

Global Flags

This command supports any of the global flags.

Behavior

Verify the archive before you rely on it

MinIO AIStor exports each piece of bucket metadata on its own. If it cannot read one of them, it logs the reason, skips that entry, and finishes the rest — but it does not write the archive’s index. The download completes, and the resulting .zip file fails to open.

Open the archive after every export you intend to keep as a backup. If it does not open, search the server log for error exporting to find which piece failed, then run the export again.