`mc share download`

语法

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

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

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

EXAMPLE

以下命令为生成一个新的预签名下载 URLmydata桶上的myminioMinIO 部署：

mc share download --recursive myminio/mydata

SYNTAX

该命令具有以下语法：

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

Brackets[]表示可选参数。
共享同一行的参数是相互依赖的。
使用竖线分隔的参数|操作符是互斥的。

将示例复制到文本编辑器中，根据需要修改，然后在终端/Shell中运行命令。

参数

ALIAS

必需

The别名MinIO 部署的完整路径以及要生成下载 URL 的对象的完整路径。例如：

mc share download play/mybucket/object.txt

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

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

如果指定存储桶或存储桶前缀的路径，您必须同时指定--recursiveargument. For example:

mc share download --recursive play/mybucket/

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

--expire, E

可选

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

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

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

--recursive, r

可选

递归生成所有对象的URLmc share download ALIAS存储桶或存储桶前缀。

如有需要ALIAS指定存储桶或存储桶前缀的路径。

--version-id, vid

可选

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

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

全局标志

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

示例

生成下载对象的URL

获取特定对象

使用mc share download生成一个支持GET对象请求：

mc share download --expire DURATION ALIAS/PATH

替换ALIAS随着别名MinIO 部署的。
替换PATH对象在 MinIO 部署中的路径。
替换DURATIONURL 过期前的持续时间。例如，要设置 30 天的过期时间，请指定30d.

获取存储桶中的对象

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

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

替换ALIAS随着别名MinIO 部署的。
替换PATH指向 MinIO 部署中的存储桶或存储桶前缀的路径。
替换DURATIONURL 过期前的持续时间。例如，要设置 30 天的过期时间，请指定30d.

行为

S3 Compatibility

Themc命令行工具专为兼容 AWS S3 API 而构建，并已通过 MinIO 和 AWS S3 测试，确保功能与行为符合预期。

MinIO 不提供对其他 S3 兼容服务的保证，因为它们的 S3 API 实现方式未知，因此不受支持。尽管mc命令可能按文档所述工作，任何此类使用风险自负。