`mc put`

New in version mc: RELEASE.2024-02-24T01-33-20Z

语法

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

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

示例

以下示例将本地文件系统路径 ~/images/collateral/ 下的文件 logo.png 上传到别名为 minio 的 MinIO 部署中名为 marketing 的存储桶。

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]

方括号 [] 表示可选参数。
同一行中的参数彼此相互依赖。
使用管道符 | 分隔的参数彼此互斥。

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

参数

TARGET

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

Optional

New in version RELEASE.2024-10-02T08-27-28Z.

为上传对象添加校验和。

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

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

--disable-multipart: Optional

New in version RELEASE.2024-10-02T08-27-28Z.

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

--enc-kms

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

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

`KEY`	对象的完整路径，格式为 `alias/bucket/path/object.ext`。你也可以只指定顶层路径，以便对该路径下的所有操作使用同一个加密密钥。
`VALUE`	指定外部 KMS 上已有的数据密钥。关于如何创建数据密钥，请参见 `mc admin kms key create` 参考文档。

KEY

对象的完整路径，格式为 alias/bucket/path/object.ext。

你也可以只指定顶层路径，以便对该路径下的所有操作使用同一个加密密钥。

VALUE

指定外部 KMS 上已有的数据密钥。

关于如何创建数据密钥，请参见 mc admin kms key create 参考文档。

例如：

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

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

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

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

--enc-s3

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

Optional

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

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

`KEY`	对象的完整路径，格式为 `alias/bucket/path/object.ext`。你也可以只指定顶层路径，以便对该路径下的所有操作使用同一个加密密钥。
`VALUE`	指定用于 SSE-C 加密的密钥，可以是 32 字节 RawBase64 编码密钥，也可以是 64 字节十六进制编码密钥。 Raw Base64 编码不接受带 `=` 填充的密钥。请去掉填充，或使用支持 RAW 格式的 Base64 编码器。

KEY

对象的完整路径，格式为 alias/bucket/path/object.ext。

你也可以只指定顶层路径，以便对该路径下的所有操作使用同一个加密密钥。

VALUE

指定用于 SSE-C 加密的密钥，可以是 32 字节 RawBase64 编码密钥， 也可以是 64 字节十六进制编码密钥。

Raw 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 加密。请改用 --enc-kms 参数启用 SSE-KMS，或使用 --enc-s3 参数启用 SSE-S3。

--parallel, --P

Optional

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

如未定义，默认值为 4。

--part-size, -s

Optional

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

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

--storage-class, -sc

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