支援終止通知：2025 年 11 月 13 日， AWS 將停止對 AWS Elemental MediaStore 的支援。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)時，設定此標頭的值。如果您未在請求中指定此標頭，MediaStore 會`standard`為物件的上傳可用性指派預設值 。

標準上傳可用性的物件大小不可超過 25 MB，串流上傳可用性的物件大小限制為 10 MB。

**注意**  
物件檔案名稱只能包含字母、數字、句點 (.)、底線 (\_)、波狀符號 (\~)、連字號 (-)、等號 (=) 和冒號 (：)。

**若要上傳物件 (主控台)**

1. 在 https：//[https://console.aws.amazon.com/mediastore/](https://console.aws.amazon.com/mediastore/) 開啟 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"
  }
  ```