mc put

语法

mc put 将对象从本地文件系统上传到目标 S3 部署中的存储桶。

与 mc cp 或 mc mirror 相比，mc put 为文件上传提供了更简化的接口。 mc put 使用单向上传机制，以牺牲效率为代价换取相较其他命令更低的复杂度。

• 示例
• 语法

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

mc [GLOBALFLAGS] put                            \
                 TARGET                         \
                 [--checksum value]             \
                 [--disable-multipart]          \
                 [--enc-kms value]              \
                 [--enc-s3 value]               \
                 [--enc-c value]                \
                 [--if-not-exists]              \
                 [--parallel, -P integer]       \
                 [--part-size, -s string]       \
                 [--storage-class, -sc string]

参数

TARGET

mc-cmd

Required

命令应执行位置的 alias 或前缀的完整路径。 TARGET 必须 包含 alias 和 bucket 名称。

TARGET 还可以包含以下可选组成部分： - 对象应上传到的 PREFIX - 用于替代文件名的 OBJECT-NAME

有效的 TARGET 可以采用以下任一形式： - ALIAS/BUCKET - ALIAS/BUCKET/PREFIX - ALIAS/BUCKET/OBJECT-NAME - ALIAS/BUCKET/PREFIX/OBJECT-NAME

--checksum

mc-cmd

Optional

为上传对象添加校验和。

可选值包括： - MD5 - CRC32 - CRC32C - SHA1 - SHA256

该标志需要服务器支持 trailing headers，并可用于 AWS 或 MinIO 目标。

--disable-multipart

mc-cmd

Optional

禁用分段上传，并指示 mc 通过单次 PUT 操作发送对象。

--enc-kms

mc-cmd

使用客户端管理的密钥，通过服务端 SSE-KMS 加密 对对象进行加密或解密。

该参数接受格式为 KEY=VALUE 的键值对。

例如：

--enc-kms "myminio/mybucket/prefix/object.obj=mybucketencryptionkey"

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

也可以指定某个前缀路径，对该路径下所有匹配对象应用加密：

--enc-kms "myminio/mybucket/prefix/=mybucketencryptionkey"

--enc-s3

mc-cmd

Optional

使用 KMS 管理的密钥，通过服务端 SSE-S3 加密 对对象进行加密或解密。 指定对象的完整路径，格式为 alias/bucket/prefix/object。

例如：

--enc-s3 "myminio/mybucket/prefix/object.obj"

你可以多次指定该参数，以表示不同的待加密对象：

--enc-s3 "myminio/mybucket/foo/fooobject.obj" --enc-s3 "myminio/mybucket/bar/barobject.obj"

也可以指定某个前缀路径，对该路径下所有匹配对象应用加密：

--enc-s3 "myminio/mybucket/foo"

--enc-c

mc-cmd

Optional

使用客户端管理的密钥，通过服务端 SSE-C 加密 对对象进行加密或解密。

该参数接受格式为 KEY=VALUE 的键值对。

• 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"

--parallel, --P

mc-cmd

Optional

对于分段上传，指定对象分段并行上传的数量。

如未定义，默认值为 4。

--part-size, -s

mc-cmd

Optional

指定分段上传中每个分段使用的大小。

如未定义，默认值为 16MiB。

--storage-class, -sc

mc-cmd

Optional

为上传对象设置存储类。

有关存储类的更多信息，请参见 Standard Storage Class。

全局标志

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

示例

上传文件并指定对象名称

以下命令将本地文件系统中的文件 logo.png 上传到 minio 部署的 business 存储桶，并在目标端命名为 company-logo.png。

mc put images/collateral/logo.png minio/business/company-logo.png

按指定分段大小并行上传分段对象

以下命令以每段 20MiB 的分块方式上传文件，并行上传其中 8 个分段。 系统会持续按批次上传 8 个分段，直到对象的所有分段均上传完成。

mc put ~/videos/collateral/splash-page.mp4 minio/business --parallel 8 --part-size 20MiB