MinIO 客户端 on SILO

mc alias list

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

语法

mc alias list 命令列出本地 mc 配置中的所有别名。

该命令输出包含每个别名关联的 access key 和 secret key 配置。

以下命令列出本地主机上配置的所有 aliases：

mc anonymous set

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

语法

mc anonymous set 命令为存储桶设置匿名（即未认证或公开）访问策略。

配置了匿名策略的存储桶允许客户端在无需身份验证的情况下，访问存储桶内容并执行与指定策略一致的操作。

mc batch cancel

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

新增: mc

RELEASE.2023-03-20T17-17-53Z

语法

mc batch cancel 可停止正在进行的批处理作业。

您必须指定作业 ID。要查找作业 ID，请使用 mc batch list。

以下命令会输出标识为 KwSysDpxcBU9FNhGkn2dCf 的作业定义。

mc encrypt clear

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

语法

mc encrypt clear 命令用于移除存储桶当前的默认加密设置。

以下命令会移除 myminio alias 关联的 MinIO 部署中 mydata 存储桶的默认加密设置：

mc event add

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

语法

mc event add 命令为存储桶添加事件通知触发器。

MinIO 会将已触发的事件自动发送到已配置的 notification target。

以下命令为 myminio MinIO 部署中的 mydata 存储桶上的所有 PUT 和 DELETE 操作创建新的事件通知触发器：

mc idp ldap accesskey disable

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

描述

mc idp ldap accesskey disable 会在 MinIO 部署上禁用指定的 access key。

以下示例在 minio 部署上禁用访问密钥 mykey：

mc idp ldap add

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

描述

mc idp ldap add 命令用于创建 AD/LDAP IDP 服务器配置。

每个 MinIO 部署最多仅支持一个 (1) AD/LDAP 提供商。

以下示例为 myminio 部署设置 AD/LDAP 配置项。

mc idp ldap policy attach

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

描述

mc idp ldap policy attach 命令将一个或多个策略附加到实体。

以下示例将策略 userpolicy 附加到 myminio 部署中的用户 bobfisher：

mc idp ldap policy attach myminio \
 userpolicy \
 --user='uid=bobfisher,ou=people,ou=hwengg,dc=min,dc=io'

该命令的语法如下：

mc ilm restore

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

语法

mc ilm restore 命令会为归档在远程层上的对象创建一个临时副本。默认情况下，该副本会在 1 天后自动过期。

使用此命令可让应用程序通过 MinIO 部署访问分层对象（例如“热层”）。归档对象会保留在远程层，而临时副本会成为该对象的 HEAD。

mc ilm rule add

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

变更: RELEASE.2022-12-24T15-21-38Z

mc ilm rule rm 替代 mc ilm add。

语法

mc ilm rule add 命令用于向存储桶添加对象生命周期管理规则。

该命令支持添加迁移（分层）和过期两类生命周期管理规则。

以下命令将新的生命周期管理规则添加到 myminio 部署上的 mydata 存储桶：

mc ilm tier add

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

变更: RELEASE.2022-12-24T15-21-38Z

mc ilm tier add 替代了 mc admin tier add。

描述

mc ilm tier add 命令在受支持的存储服务上创建一个新的远程存储层。

完整列表请参见对象转换。

支持的 S3 服务

mc ilm tier add 仅支持以下 S3 兼容服务作为对象分层的远程目标：

mc legalhold clear

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

语法

mc legalhold clear 命令会移除一个或多个对象当前的 legal hold 设置。

移除对象的 legal hold 不会移除对象上已有的其他 GOVERNANCE 模式和 COMPLIANCE 模式保留设置。

以下命令会移除 myminio MinIO 部署中 mydata 存储桶内所有对象的 legal hold：

mc license info

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

描述

mc license info 命令用于显示 MinIO 部署的许可证状态信息。具体来说，用于确认该部署使用的是 AGPLv3 开源许可证，还是 MinIO Commercial License。

你必须在 MinIO MinIO SUBNET 中注册部署，才能激活商业许可证。

mc replicate add

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

变更: RELEASE.2022-12-24T15-21-38Z

mc replicate add 替代了 mc admin bucket remote add 命令。

MinIO 会根据给定的文件路径或资源位置（例如 IP 或 DNS 地址）自动创建远程目标。定义远程目标的用户不再需要为远程存储桶确定 ARN。

mc retention set

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

语法

mc retention set 命令用于为存储桶中的一个或多个对象配置 Write-Once Read-Many (WORM) locking 设置。你还可以为存储桶设置默认对象锁定设置，使未显式配置对象锁定的所有对象继承该存储桶默认值。

mc share download

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

语法

mc share download 命令会生成一个临时的预签名 URL，并集成访问凭证，用于从 MinIO 存储桶下载对象。该临时 URL 会在可配置的时间限制后过期。

应用程序可以通过执行 GET 从该 URL 获取对象。
用户可以在浏览器中打开该 URL 下载对象。

有关可共享对象 URL 的更多信息，请参阅 Amazon S3 关于 Pre-Signed URLs.

mc support callhome

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

描述

mc support callhome 命令用于启用或禁用将部署诊断信息发送到 MinIO SUBNET。

所有 mc support 命令都需要有效的 SUBNET 订阅。

启用后，MinIO 会将诊断信息发送到 SUBNET。

无论注册状态如何，MinIO 默认禁用此功能。你必须显式启用 callhome 功能，信息上传才会开始。

mc support top api

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

需要完成 SUBNET 注册

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

语法

mc support top api 命令用于汇总 MinIO 部署服务器上的实时 API 事件。

mc tag set

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

语法

mc tag set 命令可为存储桶或对象设置一个或多个标签。

MinIO 支持为对象最多添加 10 个自定义标签。

以下命令为 myminio MinIO 部署中的 mydata 存储桶设置标签：

mc version enable

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

语法

mc version enable 命令用于为指定存储桶启用版本控制。

以下命令为 myminio MinIO 部署中的 mybucket 存储桶启用版本控制：

MinIO 客户端设置

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

本页面介绍 MinIO Client 的设置。

你可以通过以下方式建立或修改设置：

在启动或重启 MinIO Server 之前，在宿主机系统上定义 环境变量。如何定义环境变量，请参考所用操作系统的文档。
使用 mc admin config set 定义 配置项。

如果同时定义了环境变量和对应的配置项，MinIO 使用环境变量的值。

mc alias remove

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

语法

mc alias remove 从本地 mc 配置中移除一个已存在的别名。

以下命令会从主机上移除 MinIO 部署的 myminio alias：

mc anonymous get

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

语法

mc anonymous get 命令用于获取存储桶的匿名（即未认证或公共）访问策略。

配置了匿名策略的存储桶允许客户端在无需身份验证的情况下访问存储桶内容，并执行与指定策略一致的操作。

mc batch describe

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

变更: MinIO

RELEASE.2022-10-08T20-11-00Z or later

语法

mc batch describe 命令会输出指定作业 ID 的作业定义。

必须指定作业 ID。要查找作业 ID，请使用 mc batch list。

以下命令会输出标识为 KwSysDpxcBU9FNhGkn2dCf 的作业定义。

mc encrypt info

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

语法

mc encrypt info 命令返回存储桶当前的默认加密设置。

以下命令返回 myminio MinIO 部署上 mydata 存储桶的默认加密设置。

mc event ls

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

语法

mc event ls 命令列出某个存储桶的所有事件通知触发器。

别名 mc event list 与 mc event ls 功能等效。

以下命令列出 myminio MinIO 部署中 mydata 存储桶、指定 bucket notification target 的所有已配置事件通知：

mc idp ldap accesskey edit

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

说明

mc idp ldap accesskey edit 在本地服务器上修改指定的 access key。

以下示例在 minio 部署上修改 access key mykey 的 secret：

mc idp ldap disable

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

描述

mc idp ldap disable 命令用于禁用当前已配置的 AD/LDAP 提供程序。

以下示例会在 myminio 部署上禁用 AD/LDAP 配置。

mc idp ldap policy detach

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

描述

mc idp ldap policy detach 命令可从实体分离一个或多个策略。

以下示例从 myminio 部署中的用户 bobfisher 分离策略 userpolicy。

mc idp ldap policy detach myminio \
 userpolicy \
 --user='uid=bobfisher,ou=people,ou=hwengg,dc=min,dc=io'

该命令具有以下语法：

mc [GLOBALFLAGS] idp ldap policy detach \
 POLICYNAME \
 [POLICY2] ... \
 ALIAS \
 [--user=`USER`] \
 [--group=`GROUP`]

将 ALIAS 替换为 MinIO 部署的 alias，用于配置 AD/LDAP 集成。

mc ilm rule edit

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

变更: RELEASE.2022-12-24T15-21-38Z

mc ilm rule edit 替代 mc ilm edit。

语法

mc ilm rule edit 命令用于修改 MinIO 存储桶上现有的对象生命周期管理规则。

以下命令用于修改 myminio 部署上 mydata 存储桶的现有生命周期管理规则：

mc ilm tier check

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

描述

mc ilm tier check 命令用于显示某个部署上远程层的配置。

语法

该命令具有以下语法：

以下示例显示 myminio 部署上名为 WARM-TIER 的现有远程层配置。

 mc ilm tier check myminio WARM-TIER

该命令具有以下语法：

mc legalhold info

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

语法

mc legalhold info 命令返回一个或多个对象的当前 legal hold 设置。

mc legalhold 要求指定的存储桶已启用对象锁定。你只能在创建存储桶时启用对象锁定。有关创建启用对象锁定的存储桶，请参阅 mc mb --with-lock 文档。

mc license register

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

重要

mc license register 需要 MinIO Client RELEASE.2023-11-20T16-30-59Z 或更高版本。虽非强制要求，但最佳实践是保持 MinIO 客户端版本与 MinIO 服务端版本一致。

描述

mc license register 命令会将你的部署与 MinIO SUBNET 账户关联。

注册后，你可以使用 mc support diag 命令将部署健康报告直接上传到 SUBNET。

mc replicate backlog

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

变更: mc.RELEASE.2023-07-18T21-05-38Z

mc replicate diff 已重命名为 mc replicate backlog。功能未发生变化。

描述

mc replicate backlog 显示尚未复制的新建或已删除对象列表。

你可以列出特定远程目标的对象复制状态。为此，你必须具有该远程目标的 ARN。你可以使用检索为存储桶配置的远程目标查找 ARN。

mc retention info

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

语法

mc retention info 命令用于为对象或存储桶中的对象配置 Write-Once Read-Many (WORM) locking 设置。你还可以为存储桶设置默认对象锁定设置，未显式配置对象锁定的对象会继承该存储桶默认值。

mc share upload

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

语法

mc share upload 命令会生成一个临时的预签名 URL，并集成用于将对象上传到 MinIO 存储桶的访问凭证。该临时 URL 会在可配置的时间限制后过期。

应用程序可以通过该 URL 执行 PUT 以上传对象。

mc support diag

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

需要完成 SUBNET 注册

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

命令历史

用于创建诊断报告的命令会随版本演进而变化。

mc support top locks

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

需要完成 SUBNET 注册

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

语法

mc support top locks 命令列出 MinIO 部署中最旧的 10 个锁。

mc tag list

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

语法

mc tag list 命令列出存储桶或对象上的所有标签。

以下命令列出 myminio MinIO 部署中 mydata 存储桶的标签：

mc version info

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

语法

mc version info 命令返回指定存储桶的版本控制状态。

以下命令返回 myminio MinIO 部署中 mybucket 存储桶的版本控制状态：

mc alias set

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

语法

mc alias set 命令用于在本地 mc 配置中添加或更新别名。

以下命令为运行在 URL https://myminio.example.net 的 MinIO 部署 myminio 添加一个 alias。mc 使用指定的用户名和密码对该 MinIO 部署进行身份验证：

mc anonymous list

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

语法

mc anonymous list 检索存储桶的所有匿名（即未经身份验证或公开）访问策略。

具有匿名策略的存储桶允许客户端在无需身份验证的情况下访问存储桶内容，并执行与指定策略一致的操作。

mc batch generate

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

变更: MinIO

RELEASE.2022-10-08T20-11-00Z or later

语法

mc batch generate 命令会为指定作业类型创建一个基础的 YAML 格式模板文件。

MinIO 创建该文件后，请在你偏好的文本编辑器中打开并进一步自定义。每个批处理文件中只能定义一个作业任务定义。

mc encrypt set

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

语法

mc encrypt set 加密命令用于设置或更新存储桶默认的服务端加密（SSE）模式。MinIO 会使用指定的 SSE 模式自动加密写入该存储桶的对象。

mc encrypt set 仅支持 SSE-KMS 和 SSE-S3。

以下命令为 myminio MinIO 部署上的 mydata 存储桶设置默认的 SSE-KMS 加密密钥：

mc event rm

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

语法

mc event rm 命令用于从存储桶中移除事件通知触发器。

mc event remove 命令与 mc event rm 功能等效。

以下命令会在 myminio MinIO 部署的 mydata 存储桶上，移除指定 bucket notification target 的已配置事件通知：

mc idp ldap accesskey enable

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

描述

mc idp ldap accesskey enable 在本地服务器上启用指定的 access key。

以下示例启用 minio 部署中的 access key mykey：

mc idp ldap enable

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

描述

mc idp ldap enable 命令用于启用当前已配置的 AD/LDAP 提供程序。

以下示例在 myminio 部署上启用 AD/LDAP 配置。

mc idp ldap policy entities

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

说明

mc idp ldap policy entities 命令显示用户、组和/或策略的映射关系列表。

以下示例列出 myminio 部署中某个特定策略、一组用户组以及部分用户的所有映射关系。

mc ilm rule export

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

变更: RELEASE.2022-12-24T15-21-38Z

mc ilm rule export 替代 mc ilm export。

语法

mc ilm rule export 命令用于导出 MinIO 存储桶的对象生命周期管理配置。

mc ilm rule export 命令默认输出到 STDOUT。你可以将内容输出到 .json 文件中进行归档，或使用 mc ilm rule import 导入。

mc ilm tier info

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

描述

mc ilm tier info 命令可输出某个层级或某个部署上所有层级的统计信息。

所需权限

MinIO 要求具备以下权限，且权限范围限定为你要创建生命周期管理规则的一个或多个存储桶。

mc legalhold set

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

语法

mc legalhold set 命令可在单个或多个对象上启用 legal hold 的一次写入多次读取（WORM）对象锁定。

mc legalhold 要求指定的存储桶已启用对象锁定。你只能在创建存储桶时启用对象锁定。有关创建已启用对象锁定的存储桶，请参见 mc mb --with-lock 文档。

mc license update

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

描述

使用 mc license update 命令为部署替换许可证密钥。

对于已在 MinIO SUBNET 注册的部署，MinIO 每月会自动检查并更新许可证。

示例

更新别名为 `minio1` 的部署许可证密钥

mc license update minio1 license.key

语法

该命令具有以下语法：

mc replicate ls

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

变更: RELEASE.2022-12-24T15-21-38Z

mc replicate ls 替代 mc admin bucket remote ls 命令。

语法

mc replicate ls 命令列出 MinIO 存储桶上的所有复制规则。

mc replicate list 命令与 mc replicate ls 功能等价。

以下命令列出 myminio MinIO 部署中 mydata 存储桶的所有已启用复制规则：

mc retention clear

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

语法

mc retention clear 命令可移除存储桶中一个或多个对象的 Write-Once Read-Many (WORM) locking 设置。你还可以移除存储桶的默认对象锁定设置。

要更改处于 legal hold 状态的对象的保留状态，请使用 mc legalhold clear。

以下命令会移除 myminio MinIO 部署中 mydata 存储桶的默认对象锁定配置：

mc share ls

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

语法

mc share ls 命令会显示由 mc share upload 或 mc share download 生成的所有未过期预签名 URL。

mc share list 命令与 mc share ls 的功能等效。

应用程序可以执行 PUT 以从该 URL 获取对象。

有关可共享对象 URL 的更多信息，请参阅 Amazon S3 文档中的 Pre-Signed URLs.

mc support inspect

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

需要完成 SUBNET 注册

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

描述

mc support inspect 命令会收集指定路径下与对象相关的数据和元数据。

mc support top disk

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

需要完成 SUBNET 注册

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

语法

mc support top disk 命令显示当前驱动器统计信息。

mc tag remove

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

语法

mc tag remove 命令用于移除存储桶或对象上的所有标签。

以下命令会移除 myminio MinIO 部署中 mydata 存储桶的标签：

mc version suspend

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

语法

mc version suspend 命令用于禁用指定存储桶上的版本控制。

以下命令会为 myminio MinIO 部署中的 mybucket 存储桶禁用版本控制：

mc alias import

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

语法

mc alias import 命令从 JSON 文档中导入别名配置。

你可以使用 mc alias export 生成导入所需的 JSON。

以下命令从 JSON 文档中导入别名配置：

mc anonymous links

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

语法

mc anonymous links 获取用于匿名（即未认证或公开）访问存储桶的 HTTP URL。

配置了匿名策略的存储桶允许客户端在无需认证的情况下访问存储桶内容，并执行与指定策略一致的操作。

mc batch list

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

变更: MinIO

RELEASE.2022-10-08T20-11-00Z or later

语法

mc batch list 命令会输出部署中当前正在进行的批处理作业列表。

以下命令会输出 myminio alias 上当前正在进行的所有作业列表。

mc idp ldap accesskey info

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

描述

mc idp ldap accesskey info 输出指定访问密钥（一个或多个）的信息。

此命令适用于 AD/LDAP 用户在通过 MinIO 完成身份验证后创建的访问密钥。

使用 mc idp ldap accesskey create 命令创建 AD/LDAP 服务账户。

MinIO 支持使用 AssumeRoleWithLDAPIdentity 通过 Security Token Service 生成临时访问密钥。

mc idp ldap info

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

描述

mc idp ldap info 命令输出指定 MinIO 部署上 AD/LDAP 提供程序的当前配置。

以下示例输出 myminio 部署上的 AD/LDAP 配置设置。

mc ilm rule import

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

变更: RELEASE.2022-12-24T15-21-38Z

mc ilm rule import 替代 mc ilm import。

语法

mc ilm rule import 命令导入对象生命周期管理配置，并将其应用到 MinIO 存储桶。

mc ilm rule import 命令默认从 STDIN 导入。你可以从 .json 文件输入内容，例如由 mc ilm rule export 生成的文件。

mc ilm tier ls

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

变更: RELEASE.2022-12-24T15-21-38Z

mc ilm tier ls replaces mc admin tier ls.

描述

mc ilm tier ls 命令显示某个部署上已配置的远程层级。

mc ilm tier list 命令与 mc ilm tier ls 功能等效。

语法

该命令的语法如下：

以下示例输出 myminio 部署上现有远程层级的列表。

mc replicate update

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

变更: RELEASE.2022-12-24T15-21-38Z

mc replicate update 替代了 mc admin bucket remote update 命令。

变更: RELEASE.2022-11-07T23-47-39Z

mc replicate update 替代了 mc replicate edit 命令。

语法

mc replicate update 命令用于修改现有的存储桶复制规则。

mc [GLOBALFLAGS] replicate update FLAGS [FLAGS] ARGUMENTS [ARGUMENTS]

以下命令会修改 myminio MinIO 部署中 mydata 存储桶的一条现有复制规则：

mc support perf

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

变更: RELEASE.2022-07-24T02-25-13Z

mc support perf 替代 mc admin speedtest 命令。

需要完成 SUBNET 注册

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

mc support top net

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

需要完成 SUBNET 注册

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

语法

mc support top net 命令用于显示实时网络指标。

mc alias export

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

新增: mc.RELEASE.2023-11-15T22-45-58Z

语法

mc alias export 命令从现有的 configuration 中导出别名配置。

该命令将结果输出到 STDOUT，你可以将输出保存为文件，或按需进一步修改输出内容。

使用 mc alias import 命令导入生成的 JSON 配置。

mc anonymous get-json

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

语法

mc anonymous get-json 命令用于获取存储桶的匿名（即未经身份验证或公开）访问 policies。

配置了匿名策略的存储桶允许客户端在无需 authentication 的情况下访问存储桶内容，并执行与指定策略一致的操作。

mc batch start

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

变更: MinIO

RELEASE.2022-10-08T20-11-00Z or later

语法

mc batch start 命令根据批处理作业 YAML 文件启动一个批处理作业。

批处理作业会运行一次直到完成（或达到文件中指定的最大重试次数）。若要在完成后再次运行该批处理作业，必须重新启动它。

mc cat

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

语法

mc cat 命令将文件或对象的内容连接到另一个文件或对象。你也可以使用该命令将指定文件或对象的内容输出到 STDOUT。 cat 的功能与 cat 类似。

以下命令将 MinIO 部署中某个对象的内容输出到 STDOUT：

mc idp ldap accesskey ls

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

描述

mc idp ldap accesskey ls 用于显示 LDAP 访问密钥对列表。

mc idp ldap accesskey ls 也称为 mc idp ldap accesskey list。

此命令适用于 AD/LDAP 用户在通过 MinIO 完成身份验证后创建的访问密钥。

使用 mc idp ldap accesskey create 命令创建 AD/LDAP 服务账户。

mc idp ldap ls

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

说明

mc idp ldap ls 命令列出 AD/LDAP 提供方当前已有的配置集合。

mc idp ldap ls 也称为 mc idp ldap list。

以下示例列出 myminio 部署的 AD/LDAP 配置设置。

mc ilm rule ls

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

变更: RELEASE.2022-12-24T15-21-38Z

mc ilm rule ls 替代了 mc ilm ls。

变更: RELEASE.2023-05-26T23-31-54Z

mc ilm rule ls --json 的输出在 updateAt 中包含策略修改时间。

语法

mc ilm rule ls 命令以表格格式汇总 MinIO 存储桶上配置的所有对象生命周期管理规则。

mc ilm tier rm

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

描述

mc ilm tier rm 命令用于移除尚未用于转换任何对象的远程层。

mc ilm tier remove 命令与 mc ilm tier rm 具有等效功能。

说明

一旦某个层已经转换过对象，则无法将其移除。

所需权限

MinIO 要求具备以下权限，且权限范围限定为你要创建生命周期管理规则的一个或多个存储桶。

mc replicate resync

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

语法

mc replicate resync 命令会将指定 MinIO 存储桶中的所有对象，重新同步到远端 replication 目标。

此命令要求先使用 mc replicate add 命令配置远端存储桶目标。执行 mc replicate resync 时，必须指定由此生成的远端 ARN。

mc support profile

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

需要完成 SUBNET 注册

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

描述

mc support profile 为你的部署运行系统性能剖析。剖析结果可帮助了解给定节点上运行的 MinIO 服务端进程状态。

mc support top rpc

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

需要完成 SUBNET 注册

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

语法

mc support top rpc 命令显示远程过程调用（RPC）的指标。

mc anonymous set-json

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

语法

mc anonymous set-json 命令使用 IAM JSON policy document 为存储桶设置匿名（即未认证或公开）访问 policies。

配置了匿名策略的存储桶允许客户端在无需 authentication 的情况下访问存储桶内容，并执行与指定策略一致的操作。

mc batch status

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

变更: MinIO

RELEASE.2022-10-08T20-11-00Z or later

语法

mc batch status 命令会输出 MinIO 服务器上作业事件的汇总信息。

变更: mc

RELEASE.2024-07-03T20-17-25Z

Batch status 会显示活动且正在进行的作业，或前 3（三）天内已完成的任意批处理作业的汇总信息。

mc cp

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

语法

mc cp 命令用于在 MinIO 部署与本地文件系统之间复制对象，其中源端可以是 MinIO 或本地文件系统。

你也可以将 mc cp 用于本地文件系统，达到与 cp 命令行工具类似的效果。

mc idp ldap accesskey rm

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

描述

mc idp ldap accesskey rm 从本地服务器中删除指定的访问密钥。

mc idp ldap accesskey rm 也称为 mc idp ldap accesskey remove。

此命令适用于 AD/LDAP 用户在通过 MinIO 完成身份验证后创建的访问密钥。

使用 mc idp ldap accesskey create 命令创建 AD/LDAP 服务账户。

mc idp ldap rm

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

说明

mc idp ldap rm 命令移除 AD/LDAP 提供方的现有配置。

mc idp ldap rm 也称为 mc idp ldap remove。

以下示例移除 myminio 部署的 AD/LDAP 提供方设置。

mc ilm rule rm

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

变更: RELEASE.2022-12-24T15-21-38Z

mc ilm rule rm 替代 mc ilm rm。

语法

mc ilm rule rm 命令用于从 MinIO 存储桶中删除一条对象生命周期管理规则。

以下命令从 myminio MinIO 部署的 mydata 存储桶中删除一条生命周期管理规则：

mc ilm tier update

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

变更: RELEASE.2022-12-24T15-21-38Z

mc ilm tier update 替代 mc admin tier edit。

描述

mc ilm tier update 命令用于修改已配置的远程层。

仅在 MinIO 部署上使用 mc admin

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

mc replicate rm

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

变更: RELEASE.2022-12-24T15-21-38Z

mc replicate rm 替代 mc admin bucket remote rm 命令。删除复制配置时会自动删除其底层远程目标。

语法

mc replicate rm 命令用于从 MinIO 存储桶中删除 replication rule。

mc replicate remove 命令与 mc replicate rm 功能等价。

mc [GLOBALFLAGS] replicate rm FLAGS [FLAGS] ALIAS

以下命令从 myminio MinIO 部署中的 mydata 存储桶删除指定 id 的复制规则：

mc support proxy

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

说明

使用 mc support proxy 命令配置与 MinIO SUBNET 通信时使用的代理。

示例

设置代理 URL

定义部署 minio1 与 SUBNET 通信时使用的代理 URL。此示例中的代理 URL 为 http://my.proxy。

mc support proxy set minio1 http://my.proxy

删除为部署配置的代理 URL

以下命令会删除为别名 minio1 配置的代理 URL。

mc diff

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

语法

mc diff 命令用于计算两个文件系统目录或 MinIO 存储桶之间的差异。 mc diff 仅列出缺失的对象或大小不同的对象。mc diff 不会比较对象内容。

以下命令用于比较本地文件系统中的一个对象与 myminio MinIO 部署中 mydata 存储桶内一个对象之间的差异：

mc idp ldap update

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

描述

mc idp ldap update 命令用于修改 AD/LDAP 提供程序的现有配置集。

以下示例修改 myminio 部署的两个 AD/LDAP 配置项。

mc replicate status

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

语法

mc replicate status 命令显示 MinIO 存储桶的复制状态。该状态还会列出远程目标路径或位置。

以下命令显示 myminio MinIO 部署上 mydata 存储桶的当前复制状态：

mc du

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

语法

mc du 命令用于汇总存储桶和文件夹的磁盘使用量。你也可以对本地文件系统使用 du，以生成与 du 命令类似的结果。

以下命令打印 myminio MinIO 部署中 mybucket 存储桶的磁盘使用量：

mc replicate export

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

语法

mc replicate export 命令将 MinIO 存储桶的 JSON 格式复制规则导出到 STDOUT。

以下命令导出 myminio MinIO 部署中 mydata 存储桶的复制配置：

mc support upload

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

Description

mc support upload 将文件从本地文件系统复制到 SUBNET 工单。

需要完成 SUBNET 注册

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

mc replicate import

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

语法

mc replicate import 命令从 STDIN 为 MinIO 存储桶导入 JSON 格式的 replication rules。

以下命令为 myminio MinIO 部署上的 mydata 存储桶导入复制配置：

mc find

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

语法

mc find 命令支持在 MinIO 部署上搜索对象。你也可以使用该命令在文件系统上搜索文件。

以下命令会在 myminio MinIO 部署的 mydata 存储桶中，搜索所有匹配指定模式的对象：

mc get

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

新增: mc

RELEASE.2024-02-24T01-33-20Z

语法

mc get 命令将对象从目标 S3 部署下载到本地文件系统。

与 mc cp 或 mc mirror 相比，mc get 为下载文件提供了更简化的接口。 mc get 使用单向下载功能，以牺牲效率为代价，换取相较其他命令更低的功能复杂度。

mc head

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

语法

mc head 命令显示对象的前 n 行，其中 n 是传递给该命令的参数。

mc head 不会对对象内容执行任何转换或格式化来提升可读性。你也可以将 mc head 用于本地文件系统，以获得与 head 命令行工具类似的结果。

mc idp ldap accesskey create-with-login

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

新增: mc

RELEASE.2024-04-18T16-45-29Z

描述

mc idp ldap accesskey create-with-login 使用基于终端的交互式提示与外部 AD/LDAP 服务器进行身份验证，并生成可供 MinIO 使用的访问密钥。

以下示例会提示用户提供其 AD/LDAP 凭证。然后使用与该 AD/LDAP 用户关联的一个或多个策略生成新的访问密钥对。

mc idp openid

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

新增: RELEASE.2023-05-26T23-31-54Z

mc idp openid 及其子命令取代 mc admin idp openid。

描述

mc idp openid 命令允许你管理第三方 OpenID 身份与访问管理（IAM）集成的配置。

在设置 OpenID 连接时，可通过定义配置项作为使用环境变量的替代方式。mc idp openid 命令仅支持 MinIO 部署。

mc ls

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

语法

mc ls 命令用于列出 MinIO 或其他 S3 兼容服务上的存储桶和对象。

你也可以对本地文件系统使用 mc ls，生成与 ls 命令类似的结果。

以下命令列出 myminio MinIO 部署中 mydata 存储桶内的所有对象及对象版本：

mc mb

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

语法

mc mb 命令在指定路径创建新的存储桶或目录。

你也可将 mc mb 用于本地文件系统，实现与 mkdir -p 命令行工具类似的效果。

以下命令会在 myminio MinIO 部署上创建一个新的存储桶 mydata。该命令创建的存储桶将启用对象锁定。

mc mirror

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

语法

mc mirror 命令用于将内容同步到 MinIO 部署，类似于 rsync 工具。 mc mirror 支持以文件系统、MinIO 部署和其他 S3 兼容主机作为同步源。

说明

mc mirror 仅同步当前对象，不包含任何版本信息或元数据。若要同步对象的版本历史和元数据，可考虑对 bucket replication 使用 mc replicate，或对 site replication 使用 mc admin replicate。

mc mv

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

语法

mc mv 命令将对象从源移动到目标，例如在不同 MinIO 部署之间移动，或在同一 MinIO 部署的不同存储桶之间移动。 mc mv 还支持在本地文件系统与 MinIO 之间移动对象。

你也可以对本地文件系统使用 mc mv，以获得与 mv 命令行工具类似的结果。

mc od

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

语法

mc od 命令将本地文件按指定的分片数量与分片大小复制到远程位置。该命令会输出上传该文件所耗费的时间。

使用 mc od 可模拟 Linux dd 命令的功能。

以下命令将文件的 200MiB 上传到存储桶中，分为 5 个 40MiB 的分片。输出会显示上传结果，包括完成上传所用的时长。

mc ping

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

语法

mc ping 命令对指定目标执行存活性检查。

以下命令向目标发送请求，并输出响应的最小、最大、平均与往返时间，以及处理请求时遇到的错误数量。

mc pipe

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

语法

mc pipe 命令将内容从 STDIN 流式传输到目标对象。

以下命令将 STDIN 的内容写入 S3 兼容存储。

echo "My Meeting Notes" | mc pipe s3/engineering/meeting-notes.txt

该命令语法如下：

mc [GLOBALFLAGS] pipe \
 TARGET \
 [--attr "string"] \
 [--checksum "string"] \
 [--enc-kms "string"] \
 [--enc-s3 "string"] \
 [--enc-c "string"] \
 [--storage-class, --sc "string"] \
 [--tags "string"]

方括号 [] 表示可选参数。
同一行中的参数彼此相互依赖。
使用管道符 | 分隔的参数彼此互斥。

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

mc put

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

新增: mc

RELEASE.2024-02-24T01-33-20Z

语法

mc put 将对象从本地文件系统上传到目标 S3 部署中的存储桶。

与 mc cp 或 mc mirror 相比，mc put 为文件上传提供了更简化的接口。 mc put 使用单向上传机制，以牺牲效率为代价换取相较其他命令更低的复杂度。

mc rb

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

语法

mc rb 命令用于删除 MinIO 或其他兼容 S3 服务上的一个或多个存储桶。

如仅需删除存储桶内容，请改用 mc rm。

重要

mc rb 会在目标部署上永久删除存储桶，包括所有对象版本以及存储桶配置，例如生命周期管理或复制。

mc ready

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

语法

mc ready 命令用于检查集群状态，以及集群是否具有 read 和 write quorum。

以下命令向别名为 myminio 的集群发送 GET 请求，并返回其状态。

mc rm

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

语法

mc rm 命令用于从 MinIO 部署的存储桶中删除对象。如需彻底删除存储桶，请改用 mc rb。

你也可以对本地文件系统使用 mc rm，以获得与 rm 命令行工具类似的结果。

有关 MinIO 如何对对象执行 DELETE 操作的更多信息，请参见对象删除。

mc sql

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

语法

mc sql 命令提供 S3 Select 接口，用于对指定 MinIO 部署中的对象执行 SQL 查询。

有关 S3 Select 的行为和限制，请参阅 Selecting content from objects。

以下命令会查询 myminio MinIO 部署中 mydata 存储桶内的所有对象：

mc stat

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

语法

mc stat 命令用于显示 MinIO 存储桶中对象的信息，包括对象元数据。你也可以使用它来检索存储桶元数据。

你可以对本地文件系统使用 mc stat，以获得与 stat 命令行工具类似的结果。

mc tree

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

语法

mc tree 命令以树形格式列出 MinIO 存储桶中的所有前缀。该命令还可选支持在每个前缀处列出存储桶内的所有对象，包括存储桶根。

你也可以将 mc tree 用于本地文件系统目录，获得与 tree 命令行工具类似的结果。

mc undo

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

语法

mc undo 命令用于撤销指定路径上由 PUT 或 DELETE 操作引起的更改。

以下命令会回滚 myminio 部署中 data 存储桶内 file.zip 对象最近三次上传和/或删除操作：

mc update

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

语法

mc update 命令会自动将 mc 二进制更新到最新稳定版本。

运行此命令等同于手动下载最新稳定版二进制文件，并使用该文件替换主机上现有的 mc 安装。

以下命令会更新本地主机上的 mc 二进制文件：

mc watch

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

语法

mc watch 命令用于监视指定 MinIO 存储桶或本地文件系统路径上的事件。对于 S3 服务，请使用 mc event add 在兼容 S3 的服务上配置存储桶事件通知。

你也可以将 mc watch 用于本地文件系统目录，以获得与运行 inotify -e modify,create,delete,move 命令类似的结果。

mc idp ldap accesskey create

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

新增: mc

RELEASE.2023-12-23T08-47-21Z

描述

mc idp ldap accesskey create 允许添加 LDAP 访问密钥对。

以下示例在 minio alias 上创建一个新的访问密钥对，并使用与已认证用户相同的策略：