# mc share upload

LLMS 索引： [llms.txt](/zh/llms.txt)

---

<a id="mc-share-upload"></a>

<a id="command-mc.share.upload"></a>

## 语法 {#id2}

[`mc share upload`](#command-mc.share.upload) 命令会生成一个临时的预签名 URL，并集成用于将对象上传到 MinIO 存储桶的访问凭证。该临时 URL 会在可配置的时间限制后过期。

应用程序可以通过该 URL 执行 `PUT` 以上传对象。

有关可共享对象 URL 的更多信息，请参阅 Amazon S3 文档中的 [Pre-Signed URLs](https://docs.aws.amazon.com/AmazonS3/latest/dev/ShareObjectPreSignedURL.html)。

**示例**

以下命令会为 `myminio` MinIO 部署上的 `mydata` 存储桶生成一个新的预签名上传 URL：

```shell
mc share upload --recursive myminio/mydata
```

**语法**

该命令的语法如下：

```shell
mc [GLOBALFLAGS] share upload               \
                 [--content-type "string"]  \
                 [--expire "string"]        \
                 [--recursive]              \
                 ALIAS
```

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

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

### 参数 {#id3}

##### `ALIAS` {#mc.share.upload.ALIAS}

*mc-cmd*

*Required* MinIO 部署的 [alias](/zh/reference/minio-mc/mc-alias-set/#alias) 以及要为其生成上传 URL 的对象完整路径。例如：

```shell
mc share upload play/mybucket/object.txt
```

你可以在同一个或不同的 MinIO 部署上指定多个对象。例如：

```shell
mc share upload play/mybucket/object.txt play/mybucket/otherobject.txt
```

如果指定的是存储桶路径或存储桶前缀路径，则你 **必须** 同时指定 [`--recursive`](#mc.share.upload.-recursive) 参数。例如：

```shell
mc share upload --recursive play/mybucket/

mc share upload --recursive play/mybucket/myprefix/
```

##### `--content-type, T` {#mc.share.upload.-content-type}

*mc-cmd*

*Optional* 将上传限制为仅接受带有特定 [Content-Type](https://www.w3.org/Protocols/rfc1341/4_Content-Type.html) 头的请求。

指定一个字符串作为可接受的 `Content-Type` 值。 例如，`video/mp4`。

配置后，使用该生成 URL 的客户端必须包含指定类型的 `Content-Type` 头。 MinIO 会拒绝未携带正确 `Content-Type` 头的请求。

Content types 也称为 [media types](https://www.iana.org/assignments/media-types/media-types.xhtml)。

##### `--expire, E` {#mc.share.upload.-expire}

*mc-cmd*

*Optional* 为所有生成的 URL 设置过期时限。

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

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

##### `--recursive, r` {#mc.share.upload.-recursive}

*mc-cmd*

*Optional* 修改 CURL URL 以支持将对象上传到存储桶或存储桶前缀。 如果任意 `ALIAS` 指定的是存储桶路径或存储桶前缀路径，则该选项为必需。修改后的 CURL 输出如下所示：

```shell
curl ... -F key=<NAME> -F file=@<FILE>
```

将 `<FILE>` 替换为要上传的文件路径。

将 `<NAME>` 替换为上传后的对象名称。 该名称可以包含 [prefixes](/zh/glossary/#term-prefix)。

### 全局参数 {#id4}

此命令支持 [全局标志](/zh/reference/minio-mc/#minio-mc-global-options) 中的任意选项。

## 示例 {#id5}

### 生成用于上传对象的 URL {#url}

**上传单个对象**

使用 [`mc share upload`](#command-mc.share.upload) 生成一个支持 `POST` 请求的 URL， 用于将文件上传到 MinIO 部署上的特定对象位置：

```shell
mc share upload --expire DURATION ALIAS/PATH
```

- 将 [`ALIAS`](#mc.share.upload.ALIAS) 替换为 MinIO 部署的 [alias](/zh/reference/minio-mc/mc-alias-set/#alias)。
- 将 [`PATH`](#mc.share.upload.ALIAS) 替换为 MinIO 部署中对象的路径。
- 将 [`DURATION`](#mc.share.upload.-expire) 替换为 URL 过期前的时长。 例如，要设置 30 天过期时间，指定 `30d`。

**上传多个对象**

使用 [`mc share upload`](#command-mc.share.upload) 并结合 [`--recursive`](#mc.share.upload.-recursive) 与 [`--expire`](#mc.share.upload.-expire) 选项，生成一个临时 URL， 该 URL 支持 `POST` 请求，用于将文件上传到 MinIO 部署上的存储桶：

```shell
mc share upload --recursive --expire DURATION ALIAS/PATH
```

- 将 [`ALIAS`](#mc.share.upload.ALIAS) 替换为 MinIO 部署的 [alias](/zh/reference/minio-mc/mc-alias-set/#alias)。
- 将 [`PATH`](#mc.share.upload.ALIAS) 替换为 MinIO 部署中的存储桶或存储桶前缀路径。
- 将 [`DURATION`](#mc.share.upload.-expire) 替换为 URL 过期前的时长。 例如，要设置 30 天过期时间，指定 `30d`。

该命令会返回一个用于向指定存储桶前缀上传对象的 CURL 命令。

- 将返回的 CURL 命令中的 `<FILE>` 字符串替换为要上传的文件路径。
- 将返回的 CURL 命令中的 `<NAME>` 字符串替换为存储桶中的对象名称。 该名称可以包含 [prefixes](/zh/glossary/#term-prefix)。

你可以使用 shell 脚本循环将文件系统目录中的内容递归上传到兼容 S3 的服务：

```shell
#!/bin/sh

for file in ~/Documents/photos/
do
   curl https://play.min.io/mybucket/ \
   -F policy=AAAAA -F x-amz-algorithm=AWS4-HMAC-SHA256 \
   -F x-amz-credential=AAAA/us-east-1/s3/aws4_request \
   -F x-amz-date=20200812T202556Z \
   -F x-amz-signature=AAAA \
   -F bucket=mybucket -F key=photos/${file} -F file=@${file}

done
```

此示例会将 `~/Documents/photos/` 目录中的每个文件上传到 `mybucket` 存储桶下的 `photos` 前缀。 对于如何遍历目录中的文件，请遵循你所选脚本语言文档中的最佳实践。

## 行为 {#id6}

### S3 兼容性 {#s3}

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

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