文档

mc share ls

语法

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

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

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

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

以下命令分别列出 myminio MinIO 部署中 mydata 存储桶的 所有上传和下载预签名 URL:

mc share ls upload myminio/mydata
mc share ls download myminio/mydata

该命令的语法如下:

mc [GLOBALFLAGS] share list           \
                 [download | upload]  \
                 ALIAS
  • 方括号 [] 表示可选参数。

  • 同一行中的参数彼此相互依赖。

  • 使用管道符 | 分隔的参数彼此互斥。

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

参数

download

必需 列出所有未过期的预签名下载(GET)URL。

mc share ls upload 互斥。

upload

必需 列出所有未过期的预签名上传(PUT)URL。

mc share ls download 互斥。

ALIAS

必需 MinIO 部署的 alias 以及对象的完整路径, 用于列出该对象的未过期预签名 URL。

全局标志

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

示例

列出已生成的下载和上传 URL

使用 mc share ls download 生成一个 URL, 该 URL 支持 POST 请求,用于将文件上传到 S3 兼容主机上的 特定对象位置:

mc share ls download ALIAS

使用 mc share ls upload 生成一个 URL, 该 URL 支持 POST 请求,用于将文件上传到 S3 兼容主机上的 特定对象位置:

mc share ls upload ALIAS

行为

S3 兼容性

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

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