1
0
mirror of https://github.com/minio/docs.git synced 2025-08-08 01:43:18 +03:00
Files
docs/source/reference/minio-mc-admin/mc-admin-cluster-iam-import.rst
Daryl White 79cf400125 Updates for the 2024-09-09 releases of the server and mc (#1331)
- adds new config options for webhook events
- adds new subcommands to mc idp ldap accesskey
- adds info about new output during iam import

Closes #1316
2024-09-23 15:29:29 -04:00

84 lines
2.4 KiB
ReStructuredText

.. _minio-mc-admin-cluster-iam-import:
===============================
``mc admin cluster iam import``
===============================
.. default-domain:: minio
.. mc:: mc admin cluster iam import
Description
-----------
.. versionadded:: RELEASE.2022-06-17T02-52-50Z
.. start-mc-admin-cluster-iam-import-desc
The :mc:`mc admin cluster iam import` command imports :ref:`IAM <minio-authentication-and-identity-management>` metadata as created by the :mc:`mc admin cluster iam export` command.
.. end-mc-admin-cluster-iam-import-desc
You can use this command to manually restore IAM metadata settings for a MinIO deployment.
.. versionadded:: mc RELEASE.2024-09-09T07-53-10Z
The command outputs the results of the import, including the following:
- count of individual entities imported by entity type
- list of policies imported by entity type they imported to
- list of entities that failed to import
.. tab-set::
.. tab-item:: EXAMPLE
The following command imports the IAM metadata of the specified file onto the ``myminio`` deployment.
.. code-block:: shell
:class: copyable
mc admin cluster iam import myminio ~/minio-metadata-backup/myminio-cluster.zip
.. tab-item:: SYNTAX
The command has the following syntax:
.. code-block:: shell
:class: copyable
mc [GLOBALFLAGS] admin cluster iam import \
ALIAS \
IAM-METADATA.ZIP
.. include:: /includes/common-minio-mc.rst
:start-after: start-minio-syntax
:end-before: end-minio-syntax
Starting with :mc-release:`RELEASE.2023-05-04T18-10-16Z`, :mc:`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
~~~~~~~~~~
.. mc-cmd:: ALIAS
:required:
The :mc-cmd:`alias <mc alias>` of the MinIO deployment.
.. mc-cmd:: IAM-METADATA.ZIP
:required:
The path to the IAM metadata file to import.
Use the :mc:`mc admin cluster iam export` to export IAM metadata for use with this command.
Global Flags
~~~~~~~~~~~~
.. include:: /includes/common-minio-mc.rst
:start-after: start-minio-mc-globals
:end-before: end-minio-mc-globals