`mc get`

版本 mc 中的新功能：RELEASE.2024-02-24T01-33-20Z

语法

Themc get该命令从目标 S3 部署下载对象到本地文件系统。

mc get相比提供了更简化的文件下载接口mc cp or mc mirror. mc get使用单向下载功能，以效率换取其他命令的强大功能和复杂性。

EXAMPLE

以下载文件logo.png从 S3 源到本地文件系统的路径~/images/collateral/.

mc get minio/marketing/logo.png ~/images/collateral

SYNTAX

该命令具有以下语法：

mc [GLOBALFLAGS] get                      \
                 SOURCE                   \
                 TARGET                   \
                 [--enc-c string]         \
                 [--version-id, --vid value]

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

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

参数

SOURCE: 必需
完整路径别名存储桶、前缀（如果使用）和要下载的对象。

TARGET: 必需
本地文件系统上命令应放置下载文件的目标路径。

--enc-c

可选

使用服务器端加密或解密对象SSE-C 加密使用客户端管理的密钥。

该参数接受一个键值对，格式为KEY=VALUE

`KEY`	对象的完整路径为`alias/bucket/path/object.ext`. 您只能指定顶级路径，以便对该路径中的所有操作使用单一加密密钥。
`VALUE`	指定一个32字节的RawBase64编码密钥or一个64字节的十六进制编码密钥，用于SSE-C加密。原始 Base64 编码拒绝 `=`- 填充的密钥。省略填充或使用支持 RAW 格式的 Base64 编码器。

KEY

对象的完整路径为alias/bucket/path/object.ext.

您只能指定顶级路径，以便对该路径中的所有操作使用单一加密密钥。

VALUE

指定一个32字节的RawBase64编码密钥or一个64字节的十六进制编码密钥，用于SSE-C加密。

原始 Base64 编码拒绝 =- 填充的密钥。省略填充或使用支持 RAW 格式的 Base64 编码器。

KEY- 对象的完整路径为alias/bucket/path/object.
VALUE- 用于加密对象的32字节RAW Base64编码数据密钥。

例如：

# RawBase64-Encoded string "mybucket32byteencryptionkeyssec"
--enc-c "myminio/mybucket/prefix/object.obj=bXlidWNrZXQzMmJ5dGVlbmNyeXB0aW9ua2V5c3NlYwo"

您可以通过重复该参数来指定多个加密密钥。

指定前缀路径，对该路径下所有匹配的对象应用加密：

--enc-c "myminio/mybucket/prefix/=bXlidWNrZXQzMmJ5dGVlbmNyeXB0aW9ua2V5c3NlYwo"

Note

MinIO 强烈建议在生产工作负载中不要使用 SSE-C 加密。请通过 SSE-KMS 使用--enc-kms或通过 SSE-S3--enc-s3改为使用参数。

--version-id, --vid: 可选
检索对象的特定版本。传递对象的版本 ID 进行检索。

全局标志

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

示例

从 MinIO 中检索对象到本地文件系统

以下命令用于检索文件myobject.csv从存储桶中mybucket在别名处myminio并将其放置在本地文件系统的路径/my/local/folder.

mc get myminio/mybucket/myobject.csv /my/local/folder

从 MinIO 中检索加密对象

以下命令会获取一个加密文件并将其放置到本地文件夹路径中。

mc get --enc-c "play/mybucket/object=MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTIzNDU2Nzg5MDA" play/mybucket/object path-to/object