MinIO 管理客户端 on SILO

mc admin accesskey create

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin accesskey create 命令为现有 MinIO 用户添加新的 access key 和 secret key 对。

OpenID Connect 或 AD/LDAP 用户的访问密钥

此命令用于为直接在 MinIO 部署上创建、且不由第三方方案管理的用户创建访问密钥。

mc admin cluster bucket import

Mon, 01 Jan 0001 00:00:00 +0000

描述

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

mc admin cluster bucket import 命令用于导入由 mc admin cluster bucket export 命令生成的存储桶元数据。

你可以使用此命令将元数据手动恢复到 MinIO 部署中的指定存储桶。

如果仅将部署指定为目标，此命令会将元数据对象应用到目标上所有匹配的存储桶。

mc admin cluster iam import

Mon, 01 Jan 0001 00:00:00 +0000

描述

新增: 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

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

mc admin policy attach

Mon, 01 Jan 0001 00:00:00 +0000

语法

将一个或多个 IAM 策略附加到 MinIO 管理的用户或组。

变更: RELEASE.2023-05-27T05-56-19Z

要成功附加策略，所引用的用户或组必须存在。

必须且只能指定 --user 或 --group 二者之一。

以下命令将 readonly 策略附加到 alias 为 myminio 的部署中的用户 james。

mc admin prometheus generate

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc admin prometheus generate 命令会生成一个用于 Prometheus 的指标抓取配置文件。

有关 MinIO 与 Prometheus 配合使用的完整文档，请参见 How to monitor MinIO server with Prometheus

从 MinIO 服务端 RELEASE.2024-07-15T19-02-30Z 和 MinIO 客户端 RELEASE.2024-07-11T18-01-28Z 开始，metrics version 3 (v3) 提供了额外的端点和指标。要生成 v3 抓取配置，请使用 --api_version v3 选项。

mc admin scanner status

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc admin scanner status 命令会显示 MinIO Server 的 scanner 信息的实时摘要。

该命令的别名为 mc admin scanner info。

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务，无论这些服务声称与 MinIO 部署具有何种兼容性。

mc admin user add

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin user add 命令会在目标 MinIO 部署中添加一个新的 MinIO 用户。

要管理外部身份提供商用户，请参见 OIDC 或 AD/LDAP。

以下命令会在 myminio MinIO 部署上创建一个新用户 newuser：

mc admin user svcacct add

Mon, 01 Jan 0001 00:00:00 +0000

重要

此命令已被替代，并将在未来的 MinIO 客户端版本中弃用。

从 MinIO客户端版本RELEASE.2024-10-08T09-37-26Z 起，请使用 mc admin accesskey create 命令为内置 MinIO IDP 用户添加访问密钥。

mc admin accesskey disable

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin accesskey disable 命令用于禁用 MinIO IDP 用户的现有访问密钥。

以下命令会禁用指定的访问密钥：

mc admin cluster bucket export

Mon, 01 Jan 0001 00:00:00 +0000

描述

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

mc admin cluster bucket export 命令会导出存储桶元数据，以供 mc admin cluster bucket import 命令使用。

你可以使用此命令手动备份指定 MinIO 存储桶的元数据。该命令始终将输出保存为 cluster-metadata.zip。

如果你仅将部署指定为目标，此命令会备份目标部署上所有存储桶的元数据。

mc admin cluster iam export

Mon, 01 Jan 0001 00:00:00 +0000

描述

新增: RELEASE.2022-06-26T18-51-48Z

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

该命令将输出保存为 ALIAS-iam-metadata.zip，其中 ALIAS 是 MinIO 部署的 alias。

mc admin policy create

Mon, 01 Jan 0001 00:00:00 +0000

Syntax

在目标 MinIO 部署上创建一个新策略。

MinIO 部署默认包含以下内置策略：

假设以下 JSON 策略文档保存在名为 /tmp/listmybuckets.json 的文件中：

{
 "Version": "2012-10-17",
 "Statement": [
 {
 "Effect": "Allow",
 "Action": [
 "s3:ListAllMyBuckets"
 ],
 "Resource": [
 "arn:aws:s3:::*"
 ]
 }
 ]
}

以下命令使用文件 /tmp/listmybuckets.json 中的策略，在 alias myminio 上创建一个名为 listmybuckets 的新策略。

mc admin prometheus metrics

Mon, 01 Jan 0001 00:00:00 +0000

说明

mc admin prometheus metrics 命令用于输出集群的 Prometheus 指标。

输出还包含每个指标的附加信息，例如其值类型是 counter 还是 gauge。

有关将 MinIO 与 Prometheus 配合使用的完整文档，请参阅 How to monitor MinIO server with Prometheus

mc admin scanner trace

Mon, 01 Jan 0001 00:00:00 +0000

说明

mc admin scanner trace 命令会显示目标 MinIO 部署上发生的 scanner 相关 API 操作。

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务，无论这些服务声称与 MinIO 部署具有何种兼容性。

mc admin user disable

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin user disable 命令用于在目标 MinIO 部署上禁用 MinIO 用户。

客户端不能使用该用户凭证向 MinIO 部署进行身份验证。禁用用户不会将该用户从部署中移除。使用 mc admin user enable 可在 MinIO 部署上启用已禁用的用户。

mc admin user svcacct disable

Mon, 01 Jan 0001 00:00:00 +0000

重要

此命令已被替代，并将在未来的 MinIO 客户端版本中弃用。

从 MinIO客户端版本RELEASE.2024-10-08T09-37-26Z 起，请使用 mc admin accesskey disable 命令禁用内置 MinIO IDP 用户的访问密钥。

mc admin policy detach

Mon, 01 Jan 0001 00:00:00 +0000

语法

从 MinIO 管理的用户或组中移除一个或多个 IAM 策略。

必须且只能指定 --user 或 --group 其中之一。

以下命令从别名为 myminio 的部署中为用户 james 解绑 readonly 策略。

mc admin user accesskey edit

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin accesskey edit 命令用于修改与指定用户关联的访问密钥配置。

该命令要求访问密钥至少有一个属性发生变更。否则，命令会报错退出。

以下命令为 myminio 部署上的 myuserserviceaccount 访问密钥应用新的策略和 secret key：

mc admin user enable

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin user enable 命令用于在目标 MinIO 部署上启用 MinIO 用户。

客户端只能使用已启用的用户向 MinIO 部署进行认证。使用 mc admin user add 创建的用户默认处于启用状态。

要管理外部身份提供商用户，请参阅 OIDC 或 AD/LDAP。

mc admin user svcacct edit

Mon, 01 Jan 0001 00:00:00 +0000

重要

此命令已被替代，并将在未来的 MinIO 客户端发布版本中弃用。

从 MinIO客户端版本RELEASE.2024-10-08T09-37-26Z 起，请使用 mc admin accesskey edit 命令修改内置 MinIO IDP 用户的访问密钥。

mc admin accesskey enable

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin accesskey enable 命令用于启用现有访问密钥。

以下命令启用指定的访问密钥：

mc admin config

Mon, 01 Jan 0001 00:00:00 +0000

说明

mc admin config 命令用于管理 minio 服务器的配置设置。

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务，无论这些服务声称与 MinIO 部署具有何种兼容性。

示例

语法

`mc admin config set`

mc-cmd

mc admin policy entities

Mon, 01 Jan 0001 00:00:00 +0000

语法

列出目标 MinIO 部署中与策略、用户或组关联的实体。

变更: RELEASE.2023-05-27T05-56-19Z

此命令仅返回 MinIO 管理的用户和组。

如需列出与 Active Directory 或 LDAP（AD/LDAP）配置关联的实体，请使用 mc idp ldap policy entities。

mc admin user info

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin user info 命令返回目标 MinIO 部署中某个 MinIO 用户的详细信息。

如需管理外部身份提供商用户，请参见 OIDC 或 AD/LDAP。

以下命令返回 myminio MinIO 部署中用户 myuser 的详细信息：

mc admin user svcacct enable

Mon, 01 Jan 0001 00:00:00 +0000

重要

此命令已被替代，并将在未来的 MinIO 客户端发布版本中弃用。

从 MinIO客户端版本RELEASE.2024-10-08T09-37-26Z 起，使用 mc admin accesskey enable 命令为内置 MinIO IDP 用户启用访问密钥。

mc admin accesskey info

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin accesskey info 命令返回指定 access key(s) 的描述信息。

描述输出会在可用时包含以下详细信息：

Access Key
指定访问密钥的父用户
访问密钥状态（on 或 off）
策略（单个或多个）
注释
过期时间

以下命令返回指定访问密钥的信息：

mc admin decommission

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin decommission 命令用于启动 MinIO 服务器池s 的下线流程。下线流程适用于移除较旧的服务器池，这些服务器池的硬件能力或性能已不再满足要求，或相较部署中的其他池表现不足。MinIO 会根据每个池可用空闲空间的比例，自动将数据从被下线的池迁移到部署中其余的池。

mc admin policy info

Mon, 01 Jan 0001 00:00:00 +0000

语法

如果目标 MinIO 部署上存在指定策略，则以 JSON 格式返回该策略。

以下命令显示 alias myminio 上 writeonly 策略的内容。

mc admin user ls

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin user ls 命令会列出目标 MinIO 部署上的所有 MinIO 用户。

mc admin user list 命令与 mc admin user ls 功能等效。

mc admin user ls 不会返回与用户关联的 access key 或 secret key。使用 mc admin user info 可获取用户详细信息，包括用户的 access key。

mc admin user svcacct info

Mon, 01 Jan 0001 00:00:00 +0000

重要

此命令已被替代，并将在未来的 MinIO 客户端版本中弃用。

从 MinIO客户端版本RELEASE.2024-10-08T09-37-26Z 开始，请使用 mc admin accesskey info 命令显示内置 MinIO IDP 用户的 access key 信息。

mc admin accesskey ls

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin accesskey ls 命令列出 MinIO 部署管理的用户、访问密钥或临时 security token service 密钥。

mc admin accesskey list 别名与 mc admin accesskey ls 功能等效。

以下命令列出别名为 myminio 的部署中，用户名为 admin1 的用户关联的所有访问密钥：

mc admin group

Mon, 01 Jan 0001 00:00:00 +0000

说明

mc admin group 命令用于管理 MinIO 部署上的组。

组是用户的集合。每个组都可以分配一个或多个策略，用于明确列出允许或拒绝组成员访问的操作和资源。对于具有相同访问模式和工作负载的用户，组提供了一种简化的共享权限管理方式。

mc admin policy ls

Mon, 01 Jan 0001 00:00:00 +0000

语法

列出目标 MinIO 部署上的所有策略。

mc admin policy list 命令与 mc admin policy ls 具有等效功能。

以下命令显示 alias play 上当前存在的策略列表。

mc admin user rm

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin user rm 命令用于在目标 MinIO 部署上移除 MinIO 用户。

mc admin user remove 命令与 mc admin user rm 的功能等效。

要管理外部身份提供商用户，请参阅 OIDC 或 AD/LDAP。

以下命令会在 myminio MinIO 部署上移除用户 myuser：

mc admin user svcacct ls

Mon, 01 Jan 0001 00:00:00 +0000

重要

此命令已被替代，并将在未来的 MinIO 客户端版本中弃用。

从 MinIO客户端版本RELEASE.2024-10-08T09-37-26Z 起，请使用 mc admin accesskey ls 命令列出 MinIO 内置 IDP 用户的访问密钥。

mc admin accesskey rm

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin accesskey rm 命令用于删除部署中与某个用户关联的访问密钥。

mc admin accesskey remove 命令与 mc admin accesskey rm 的功能等效。

警告

删除后，应用程序将无法再使用该访问密钥进行身份验证。

mc admin heal

Mon, 01 Jan 0001 00:00:00 +0000

说明

mc admin heal 命令会扫描受损或损坏的对象，并对这些对象执行自愈。

mc admin heal 资源开销较大，通常不需要手动执行，即使在驱动器故障或数据损坏事件之后也是如此。

mc admin policy rm

Mon, 01 Jan 0001 00:00:00 +0000

语法

从目标 MinIO 部署中移除 IAM 策略。

mc admin policy remove 命令与 mc admin policy rm 具有等效功能。

以下命令从 myminio MinIO 部署中移除名为 writeonly 的策略：

mc admin user sts info

Mon, 01 Jan 0001 00:00:00 +0000

语法

mc admin user sts info 命令用于检索指定 STS 凭证的信息，例如生成该凭证的父 MinIO user、关联策略和过期时间。

STS 凭证为 MinIO 部署提供临时访问权限。

以下命令检索具有指定访问密钥的 STS 凭证信息：

mc admin user svcacct rm

Mon, 01 Jan 0001 00:00:00 +0000

重要

此命令已被替代，并将在未来的 MinIO 客户端版本中弃用。

从 MinIO客户端版本RELEASE.2024-10-08T09-37-26Z 起，请使用 mc admin accesskey rm 命令删除内置 MinIO IDP 用户的访问密钥。

mc admin info

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc admin info 命令显示 MinIO 服务器的信息。对于分布式 MinIO 部署，mc admin info 会显示部署中每个 MinIO 服务器的信息。

新增: mc

RELEASE.2024-05-03T11-21-07Z

命令输出包含集群的 erasure code 设置信息。该信息在输出中以 EC:# 格式显示。

mc admin kms key

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc admin kms key 命令通过 MinIO Key Encryption Service (KES) 执行加密密钥管理操作。

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务，无论这些服务声称与 MinIO 部署具有何种兼容性。

mc admin logs

Mon, 01 Jan 0001 00:00:00 +0000

需要完成 SUBNET 注册

mc support 命令面向已在 MinIO SUBNET 注册的 MinIO 部署设计，以确保诊断和性能测试获得最佳结果。未注册 SUBNET 的部署无法使用 mc support 命令。

变更: RELEASE.2022-12-02T23-48-47Z

mc admin rebalance

Mon, 01 Jan 0001 00:00:00 +0000

权限

执行此命令的用户必须拥有该部署的 admin:Rebalance 策略操作。

描述

mc admin rebalance 命令可用于在 MinIO 部署上启动、监控或停止再平衡操作。再平衡会在部署中的所有池之间重新分配对象。

当新增服务器池时，MinIO 不会自动对对象执行再平衡。相反，MinIO 会将新对象写入相较于部署中其他可用池可用空间更多的池。触发手动再平衡流程会促使 MinIO 扫描整个部署，并按需移动对象，以使所有池的可用空间大致相当。

mc admin replicate

Mon, 01 Jan 0001 00:00:00 +0000

变更: RELEASE.2023-01-11T03-14-16Z

mc admin replicate edit renamed to mc admin replicate update
mc admin replicate remove renamed to mc admin replicate rm

描述

mc admin replicate 命令用于为一组 MinIO 对等站点创建并管理站点复制。

站点复制类似于 active-active 存储桶复制，但适用于多个 MinIO 部署。在这组站点中，无论 IAM 设置、存储桶或对象发生何种变更，该变更都会在站点复制组中的所有站点间复制。

mc admin service

Mon, 01 Jan 0001 00:00:00 +0000

说明

mc admin service 命令可用于重启或解除冻结 MinIO 服务器。

mc admin service 会同时影响目标部署中的所有 MinIO 服务器。该命令会中断 MinIO 部署上正在进行的 API 操作。对某个部署执行此命令时请谨慎。

mc admin trace

Mon, 01 Jan 0001 00:00:00 +0000

说明

mc admin trace 命令显示目标 MinIO 部署上发生的 API 操作。

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务，无论这些服务声称与 MinIO 部署具有何种兼容性。

mc admin update

Mon, 01 Jan 0001 00:00:00 +0000

描述

mc admin update 命令会更新部署中的所有 MinIO 服务器。该命令还支持使用私有镜像服务器，适用于部署环境无法访问公网的场景。

运行该命令后，会显示确认更新的提示。输入 y 并按 [ENTER]，即可确认并继续更新。