终止支持通知：2025 年 11 月 13 日，我 AWS 将停止对 AWS MediaStore Elemental 的支持。2025 年 11 月 13 日之后，您将无法再访问 MediaStore 控制台或 MediaStore 资源。有关更多信息，请访问此[博客文章](https://aws.amazon.com/blogs/media/support-for-aws-elemental-mediastore-ending-soon/)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 上传对象
<a name="objects-upload"></a>

您可以将对象上传到容器或容器内的文件夹。要将对象上传到文件夹，可以指定至文件夹的路径。如果该文件夹已经存在，AWS Elemental 会将该对象 MediaStore 存储在文件夹中。如果文件夹不存在，则该服务将创建文件夹，然后将对象存储在其中。有关文件夹的更多信息，请参阅[AWS Elemental 中的文件夹 MediaStore](folders.md)。

您可以使用 MediaStore 控制台或 AWS CLI 上传对象。

MediaStore 支持对对象进行分块传输，通过在对象仍在上传时可供下载，从而减少延迟。要使用此功能，请将对象的上传可用性设置为 `streaming`。您可以在[使用 API 上传对象](https://docs.aws.amazon.com/mediastore/latest/apireference/API_objstore_PutObject.html)时设置此标头的值。如果您未在请求中指定此标头，则会`standard`为数据元的上传可用性 MediaStore 分配默认值。

标准上传可用性的对象大小不得超过 25MB，流上传可用性的对象大小不得超过 10MB。

**注意**  
对象文件名只能包含字母、数字、句点 (.)、下划线 (\_)、波形符 (\~)、连字符 (-)、等号 (=) 和冒号 (:)。

**上传对象（控制台）**

1. 打开 MediaStore 控制台，网址为[https://console.aws.amazon.com/mediastore/](https://console.aws.amazon.com/mediastore/)。

1. 在 **Containers (容器)** 页面上，选择容器的名称。将出现容器的详细信息面板。

1. 选择 **Upload object (上传对象)**。

1. 对于 **Target path (目标路径)**，键入文件夹的路径。例如 `premium/canada`。如果所指定路径中的任何文件夹不存在，则该服务将自动创建这些文件夹。

1. 在 **Object (对象)** 部分中，选择 **Browse (浏览)**。

1. 导航到相应文件夹，然后选择要上传的对象。

1. 选择 **Open (打开)**，然后选择 **Upload (上传)**。
**注意**  
如果选定文件夹中已存在同名文件，则该服务将用上传的文件替换原始文件。

**上传对象 (AWS CLI)**
+ 在中 AWS CLI，使用`put-object`命令。您也可以包括以下任意参数：`content-type`、`cache-control`（以允许调用方控制对象缓存行为）和 `path`（用于将对象放入容器中的某个文件夹）。
**注意**  
上传对象后，您将无法编辑 `content-type`、`cache-control` 或 `path`。

  ```
  aws mediastore-data put-object --endpoint {{https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com}} --body {{README.md}} --path {{/folder_name/README.md}} --cache-control "{{max-age=6, public}}" --content-type {{binary/octet-stream}} --region {{us-west-2}}
  ```

  以下示例显示了返回值：

  ```
  {
      "ContentSHA256": "74b5fdb517f423ed750ef214c44adfe2be36e37d861eafe9c842cbe1bf387a9d",
      "StorageClass": "TEMPORAL",
      "ETag": "af3e4731af032167a106015d1f2fe934e68b32ed1aa297a9e325f5c64979277b"
  }
  ```