上傳物件

本頁將討論與上傳物件相關的概念。您可以上傳及儲存任何 MIME 類型的資料，大小上限為 5 TiB。

上傳類型

您可以透過下列方式將上傳要求傳送至 Cloud Storage：

  • 單一要求上傳。上傳方法，其中物件會以上傳為單一要求。如果檔案夠小，即使連線失敗也能完整上傳，請使用這個方法。如需單一要求上傳指南，請參閱「從檔案上傳物件」或「從記憶體上傳物件」。

    • JSON API 多部分上傳。這種上傳方法可讓您在單一要求中上傳物件資料和中繼資料。不過，XML API 允許在所有類型的上傳作業中設定物件中繼資料。

  • 支援續傳的上傳作業。這種上傳方式可提供更可靠的傳輸服務，對於大型檔案來說尤其重要。支援續傳的上傳作業適用於大多數應用程式，因為這類作業也適用於小型檔案，代價是每次上傳時會額外產生一個 HTTP 要求。您也可以使用可續傳的上傳作業執行串流轉移，上傳大小未知的物件。

  • XML API 多部分上傳。與 Amazon S3 分塊上傳相容的上傳方法。檔案會分批上傳，並在最後一個要求中組合成單一物件。XML API 多部分上傳功能可讓您平行上傳各部分，可能縮短整體上傳時間。

使用這些基本上傳類型，即可採用更進階的上傳策略：

  • 平行複合上傳。一種上傳策略，您可將檔案分塊，並平行上傳這些分塊。與 XML API 多部分上傳不同，平行複合上傳作業會使用組合作業，且最終物件會儲存為複合物件。

  • 串流上傳：這種上傳方法可讓您上傳資料，而不必先將資料儲存至檔案。如果您在開始上傳時不知道上傳內容的總大小，這種方法就非常實用。

  • 分塊傳輸編碼上傳。包含 Transfer-Encoding: chunked 標頭的單一要求上傳，可讓上傳作業以多個連續資料區塊的形式傳送。

上傳大小注意事項

選擇使用單一要求上傳，而非可恢復上傳或 XML API 多部分上傳時，請考量網路發生故障時，您願意損失多少時間，以及是否需要從頭重新啟動上傳作業。如要加快連線速度，通常可以提高截斷大小。

舉例來說，假設您願意容忍 30 秒的遺失時間：

  • 如果從本機系統上傳，平均上傳速度為 8 Mbps，則可使用單一要求上傳大小不超過 30 MB 的檔案。

  • 如果您從區域內服務上傳，且上傳速度平均為 500 Mbps，則檔案大小上限約為 2 GB。

各項工具的支援

控制台

使用Google Cloud 控制台時，可以執行下列類型的上傳作業：

指令列

使用 Google Cloud CLI 時，您可以執行下列類型的上傳作業：

用戶端程式庫

C++

使用 C++ 用戶端程式庫時，您可以執行下列類型的上傳作業：

C#

使用 C# 用戶端程式庫時，可以執行下列類型的上傳作業：

Go

使用 Go 用戶端程式庫時，可以執行下列類型的上傳作業：

Java

使用 Java 用戶端程式庫時，您可以執行下列類型的上傳作業：

Node.js

使用 Node.js 用戶端程式庫時，您可以執行下列類型的上傳作業：

PHP

使用 PHP 用戶端程式庫時，可以執行下列類型的上傳作業：

Python

使用 Python 用戶端程式庫時，可以執行下列類型的上傳作業：

小茹

使用 Ruby 用戶端程式庫時，您可以執行下列類型的上傳作業：

Terraform

使用 Terraform 時，您可以執行單一要求上傳。上傳的檔案大於 16 MiB 時，系統會自動進行續傳。

REST API

JSON API

使用 JSON API 時，您可以執行下列類型的上傳作業：

XML API

使用 XML API 時，您可以執行下列類型的上傳作業：

如果您使用 REST API 上傳物件，請參閱「要求端點」，完整瞭解可使用的要求端點。

後續步驟