Skip to main content
此產品有較新版本可以使用。
本繁體中文版使用機器翻譯，譯文僅供參考，若與英文版本牴觸，應以英文版本為準。

建立多個部分上傳

貢獻者
PDF

CreateMultpartupload （先前命名為「 Initiate Multifart Upload 」（起始多重部分上傳））作業會啟動物件的多重部分上傳、並傳回上傳 ID 。

。 x-amz-storage-class 支援要求標頭。提交的值 x-amz-storage-class 影響StorageGRID 到在擷取期間、如何保護物件資料、而非StorageGRID 物件的持續複本儲存在整個系統（由ILM決定）中。

如果符合擷取物件的 ILM 規則使用嚴格的 "擷取選項"、 x-amz-storage-class 標頭沒有作用。

下列值可用於 x-amz-storage-class：

  • STANDARD （預設）

    • * 雙重認可 * ：如果 ILM 規則指定「雙重認可擷取」選項、則只要物件擷取第二個物件複本、就會建立並發佈至不同的儲存節點（雙重認可）。評估 ILM 時、 StorageGRID 會判斷這些初始過渡複本是否符合規則中的放置指示。如果沒有、則可能需要在不同位置製作新的物件複本、而且可能需要刪除初始過渡複本。

    • *Balanced * ：如果 ILM 規則指定 Balanced 選項、而 StorageGRID 無法立即製作規則中指定的所有複本、 StorageGRID 會在不同的儲存節點上製作兩個臨時複本。

      如果StorageGRID 能夠立即建立ILM規則中指定的所有物件複本（同步放置） x-amz-storage-class 標頭沒有作用。

  • REDUCED_REDUNDANCY

    • * 雙重認可 * ：如果 ILM 規則指定雙重認可選項、 StorageGRID 會在擷取物件時（單一認可）建立單一的臨時複本。

    • *Balanced * ：如果 ILM 規則指定 Balanced 選項、則 StorageGRID 只會在系統無法立即製作規則中指定的所有複本時、才製作單一的臨時複本。如果能夠執行同步放置、則此標頭不會有任何影響。StorageGRID 。 REDUCED_REDUNDANCY 當符合物件的ILM規則建立單一複寫複本時、最適合使用此選項。在此案例中、請使用 REDUCED_REDUNDANCY 免除在每次擷取作業中不必要地建立和刪除額外的物件複本。

    使用 REDUCED_REDUNDANCY 在其他情況下不建議使用此選項。 REDUCED_REDUNDANCY 增加擷取期間物件資料遺失的風險。例如、如果單一複本一開始儲存在無法進行ILM評估的儲存節點上、則可能會遺失資料。

警告 在任何時間段只複寫一個複本、會使資料面臨永久遺失的風險。如果只有一個物件複寫複本存在、則當儲存節點故障或發生重大錯誤時、該物件就會遺失。在升級等維護程序期間、您也會暫時失去物件的存取權。

指定 REDUCED_REDUNDANCY 只會影響第一次擷取物件時所建立的複本數量。它不會影響使用中 ILM 原則評估物件時所製作的物件複本數量、也不會導致資料儲存在 StorageGRID 系統中較低的備援層級。

註 如果您將物件擷取至啟用S3物件鎖定的儲存區、則會顯示 REDUCED_REDUNDANCY 選項會被忽略。如果您要將物件擷取至舊版相容的儲存區、請使用 REDUCED_REDUNDANCY 選項會傳回錯誤。執行「雙重承諾」的程序時、務必確保符合法規遵循要求。StorageGRID

支援下列要求標頭：

  • Content-Type

  • x-amz-meta-，然後是包含使用者定義中繼資料的名稱值配對

    為使用者定義的中繼資料指定名稱值配對時、請使用以下一般格式：

    x-amz-meta-_name_: `value`

    如果您要使用 * 使用者定義的建立時間 * 選項做為 ILM 規則的參考時間、則必須使用 creation-time 做為建立物件時記錄的中繼資料名稱。例如：

    x-amz-meta-creation-time: 1443399726

    的價值 creation-time 自1970年1月1日起算為秒數。

    註 新增 creation-time 如果您要將物件新增至已啟用舊版規範的儲存區、則不允許使用者定義的中繼資料。將傳回錯誤。

  • S3物件鎖定要求標頭：

    • x-amz-object-lock-mode

    • x-amz-object-lock-retain-until-date

    • x-amz-object-lock-legal-hold

      如果提出的要求沒有這些標頭、則會使用儲存庫預設保留設定來計算物件版本的保留日期。

    "使用 S3 REST API 來設定 S3 物件鎖定"

  • SSe要求標頭：

    • x-amz-server-side-encryption

    • x-amz-server-side-encryption-customer-key-MD5

    • x-amz-server-side-encryption-customer-key

    • x-amz-server-side-encryption-customer-algorithm

      要求伺服器端加密的標頭

    註 如需 StorageGRID 如何處理 UTF-8 字元的相關資訊、請參閱 "PuttObject"。

要求伺服器端加密的標頭

您可以使用下列要求標頭、以伺服器端加密來加密多部份物件。「SSE」和「SSE-C」選項互不相關。

  • *SSE * ：如果您想使用由 StorageGRID 管理的唯一金鑰來加密物件、請在 CreateMultpartUpload 要求中使用下列標頭。請勿在任何上傳組件要求中指定此標頭。

    • x-amz-server-side-encryption

  • SSE-C ：如果您想要使用您提供和管理的唯一金鑰來加密物件、請在 CreateMultpartUpload 要求（以及每個後續的 UploadPart 要求）中使用這三個標頭。

    • x-amz-server-side-encryption-customer-algorithm：指定 AES256。

    • x-amz-server-side-encryption-customer-key：指定新物件的加密金鑰。

    • x-amz-server-side-encryption-customer-key-MD5：指定新對象加密密鑰的md5摘要。

警告 您提供的加密金鑰永遠不會儲存。如果您遺失加密金鑰、就會遺失對應的物件。在使用客戶提供的金鑰來保護物件資料之前、請先檢閱的考量事項 "使用伺服器端加密"。

不支援的要求標頭

不支援並傳回下列要求標頭 XNotImplemented

  • x-amz-website-redirect-location

版本管理

多部分上傳包含不同的作業、可用於初始化上傳、列出上傳內容、上傳零件、組裝上傳的零件、以及完成上傳。執行「 CompleteMultpartUpload 」（ CompleteMultpartUpload ）作業時、即會建立物件（並在適用的情況下進行版本控制）。