Documentation

mc admin cluster iam export

New in version RELEASE.2022-06-26T18-51-48Z.

The mc admin cluster iam export command exports IAM metadata for use with the mc admin cluster iam import command.

The command saves the output as ALIAS-iam-metadata.zip, where ALIAS is the alias of the MinIO deployment.

The following command exports all IAM metadata for the myminio deployment.

mc admin cluster iam export myminio

The command has the following syntax:

mc [GLOBALFLAGS] admin cluster iam export ALIAS  \
                 [--output, -o <string>]
  • 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.

Starting with RELEASE.2023-05-04T18-10-16Z, mc admin cluster iam export adds support for aliases ending with a trailing forward slash ALIAS/. Prior to this release, the command would fail when provided a trailing forward slash.

Required

The alias of the MinIO deployment to export IAM metadata for.

Optional

Specify a custom file and path to use when exporting the IAM data.

This command supports any of the global flags.

The following command downloads all IAM metadata for the cluster at alias myminio, then stores the metadata to a ZIP file.

mc admin cluster iam export myminio

The ZIP file is named <alias>-iam-info.zip where <alias> is the alias of the cluster. For the above example, the file is named myminio-iam-info.zip.

The file is placed in the current active directory path.

The following command downloads all IAM metadata for the cluster at alias myminio, then stores the metadata to a ZIP file at /tmp/myminio-iam.zip.

mc admin cluster iam export myminio --output /tmp/myminio-iam.zip