mc share download

语法

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

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

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

• 示例
• 语法

mc share download --recursive myminio/mydata

mc [GLOBALFLAGS] share download           \
                 [--expire "string"]      \
                 [--recursive]            \
                 [--version-id "string"]  \
                 ALIAS

参数

ALIAS

mc-cmd

Required

MinIO 部署的 alias，以及要为其生成下载 URL 的对象完整路径。例如：

mc share download play/mybucket/object.txt

你可以在同一个或不同的 MinIO 部署上指定多个对象。例如：

mc share download play/mybucket/object.txt play/mybucket/otherobject.txt

如果指定的是存储桶路径或存储桶前缀路径，则必须同时指定 --recursive 参数。例如：

mc share download --recursive play/mybucket/

mc share download --recursive play/mybucket/myprefix/

--expire, E

mc-cmd

Optional

为所有生成的 URL 设置过期时间限制。

指定一个格式为 ##h##m##s 的字符串。例如：12h34m56s 表示 URL 生成后 12 小时 34 分 56 秒过期。

默认为 168h，即 168 小时（7 天）。

--recursive, r

mc-cmd

Optional

递归地为 mc share download ALIAS 存储桶或存储桶前缀中的所有对象生成 URL。

如果任一 ALIAS 指向存储桶路径或存储桶前缀路径，则此参数为必需。

--version-id, vid

mc-cmd

Optional

指示 mc share download 仅对指定的对象版本执行操作。

--version-id 要求指定的 ALIAS 指向支持 存储桶版本控制 的 S3 兼容服务。对于 MinIO 部署， 请使用 mc version 启用或禁用存储桶版本控制。

全局标志

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

示例

生成用于下载对象的 URL

• 获取特定对象
• 获取存储桶中的对象

mc share download --expire DURATION ALIAS/PATH

mc share download --recursive --expire DURATION ALIAS/PATH

行为

S3 兼容性

mc 命令行工具以兼容 AWS S3 API 为目标构建，并针对 MinIO 和 AWS S3 进行了测试，以验证预期的功能与行为。

对于其他 S3 兼容服务，MinIO 不提供任何保证，因为这些服务的 S3 API 实现未知， 因此不在支持范围内。虽然 mc 命令 可能 仍能按文档说明工作，但此类 用法需要你自行承担风险。