`mc share download`

语法

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

应用程序可以执行 GET 以从 URL 检索对象。
用户可以在浏览器中打开 URL 以下载对象。

有关可共享对象 URL 的更多信息，请参阅 Amazon S3 文档中的预签名 URL。

示例

以下命令为 myminio MinIO 部署上的 mydata 存储桶生成一个新的预签名下载 URL

mc share download --recursive myminio/mydata

语法

该命令具有以下语法

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

方括号 [] 表示可选参数。
共享一行参数是相互依赖的。
使用管道 | 运算符分隔的参数是互斥的。

将示例复制到文本编辑器中，并在终端/shell 中运行命令之前根据需要进行修改。

参数

ALIAS

必需

MinIO 部署的别名以及要为其生成下载 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

可选

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

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

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

--recursive, r

可选

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

如果任何ALIAS 指定存储桶或存储桶前缀的路径，则需要此参数。

--version-id, vid

可选

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

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

全局标志

此命令支持任何全局标志。

示例

生成下载对象(s) 的 URL

获取特定对象

使用mc share download 生成支持对象GET 请求的 URL

mc share download --expire DURATION ALIAS/PATH

将ALIAS 替换为 MinIO 部署的别名。
将PATH 替换为 MinIO 部署上对象的路径。
将DURATION 替换为 URL 过期的时间段。例如，要设置 30 天过期，请指定30d。

获取存储桶中的对象(s)

使用mc share download 和--recursive 选项为存储桶中的每个对象生成一个 URL。每个 URL 都支持与其关联对象的GET 请求

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

将ALIAS 替换为 MinIO 部署的别名。
将PATH 替换为 MinIO 部署上存储桶或存储桶前缀的路径。
将DURATION 替换为 URL 过期的时间段。例如，要设置 30 天过期，请指定30d。

行为

S3 兼容性

mc 命令行工具构建为与 AWS S3 API 兼容，并已在 MinIO 和 AWS S3 上进行了测试，以确保预期功能和行为。

MinIO 不对其他兼容 S3 的服务提供任何保证，因为它们的 S3 API 实现未知，因此不受支持。虽然mc 命令可能按文档记录的方式工作，但任何此类使用均需自行承担风险。