`mc share download`

语法

mc share download 命令生成一个带有集成访问凭证的临时预签名URL，用于从MinIO桶中下载对象。这个临时URL在可配置的时间限制后失效。

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

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

EXAMPLE

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

mc share download --recursive myminio/mydata

SYNTAX

该命令具有以下语法：

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

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

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

参数

ALIAS

Required

MinIO部署的 alias 和要生成下载URL的对象的完整路径。例如：

mc share download play/mybucket/object.txt

您可以指定同一MinIO部署或不同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

Optional

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

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

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

--recursive, r

Optional

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

如果任何 ALIAS 指定了到桶或桶前缀的路径，这是必需的。

--version-id, vid

Optional

指令 mc share download 只对指定的对象版本进行操作。

需要指定的 ALIAS 是一个支持桶版本控制的 S3 兼容服务。对于 MinIO 部署，使用 mc version 命令来启用或禁用桶版本控制。

全局标记

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

示例

生成下载对象的 URL

Get Specific Object

使用 mc share download 命令来生成一个支持 GET 请求的对象 URL：

mc share download --expire DURATION ALIAS/PATH

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

Get Object(s) in a Bucket

使用 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 命令可能如文档中所述工作，但任何此类使用都是您自己的风险。

商业支持购买咨询