Documentation

mc admin cluster iam import

Description

New in version RELEASE.2022-06-17T02-52-50Z.

The mc admin cluster iam import command imports IAM metadata as created by the mc admin cluster iam export command.

You can use this command to manually restore IAM metadata settings for a MinIO deployment.

The following command imports the IAM metadata of the specified file onto the myminio deployment.

mc admin cluster iam import myminio ~/minio-metadata-backup/myminio-cluster.zip

The command has the following syntax:

mc [GLOBALFLAGS] admin cluster iam import  \
                                   ALIAS \
                                   IAM-METADATA.ZIP
  • 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 https://github.com/minio/mc/releases/tag/RELEASE.2023-05-04T18-10-16Z, mc admin cluster iam import 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.

Parameters

ALIAS
Required

The alias of the MinIO deployment.

IAM-METADATA.ZIP
Required

The path to the IAM metadata file to import.

Use the mc admin cluster iam export to export IAM metadata for use with this command.

Global Flags

This command supports any of the global flags.