跳转到主要内容

mc admin cluster iam import

描述

说明

新增: RELEASE.2022-06-17T02-52-50Z

mc admin cluster iam import 命令导入由 mc admin cluster iam export 命令创建的 IAM 元数据。

您可以使用此命令手动恢复 MinIO 部署的 IAM 元数据设置。

说明

新增: mc

RELEASE.2024-09-09T07-53-10Z

该命令会输出导入结果,包括以下内容:

  • 按实体类型统计已导入的单个实体数量
  • 按策略导入目标的实体类型列出已导入策略
  • 导入失败的实体列表

以下命令将指定文件中的 IAM 元数据导入到 myminio 部署。

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

命令语法如下:

mc [GLOBALFLAGS] admin cluster iam import  \
                                   ALIAS \
                                   IAM-METADATA.ZIP
  • 方括号 [] 表示可选参数。
  • 同一行中的参数彼此相互依赖。
  • 使用管道符 | 分隔的参数彼此互斥。

请先将示例复制到文本编辑器中并按需修改,再在终端 / shell 中运行命令。

从 RELEASE.2023-05-04T18-10-16Z 开始,mc admin cluster iam import 新增了对以尾随正斜杠结尾的别名 ALIAS/ 的支持。 在此版本之前,如果提供尾随正斜杠,命令会执行失败。

参数

ALIAS

mc-cmd

Required

MinIO 部署的 alias。

IAM-METADATA.ZIP

mc-cmd

Required

要导入的 IAM 元数据文件路径。

使用 mc admin cluster iam export 导出 IAM 元数据,以供此命令使用。

全局标志

此命令支持 全局标志 中的任意选项。

行为

失败报告与旧版回退(mcli 20261109)

在 mcli 20261109 中:

  • 若服务端在导入响应中报告了失败的 IAM 实体,mc admin cluster iam import 会返回退出码 1,以便自动化脚本检测部分导入失败(#234)。
  • 旧版客户端侧 IAM zip 解析器回退仅在服务端返回 NotImplemented 或 XMinioAdminVersionMismatch 时触发;来自 ImportIAMv2 的认证、授权、传输或归档错误会直接返回,不再回退(#211)。