配額與限制

本頁面說明 Cloud Storage 的配額和要求限制。您可以要求提高配額，但無法調整限制。

配額和限制可能隨時變更。

bucket

限制 值 附註
值區名稱大小上限 63 個字元

如果名稱包含英文句號 (.)，則長度上限為 222 個字元。
每個專案的 bucket 建立和刪除速率上限 約每兩秒一個要求

在大多數情況下，您會規劃較少的 buckets 和較多的物件。舉例來說，常見的設計選擇是為專案的每位使用者各建立一個 bucket。不過，如果您設計的系統每秒會新增多位使用者，請設計為在一個 bucket 中新增多位使用者 (具備適當權限)，以免 bucket 建立頻率限制成為瓶頸。

高可用性應用程式不應依賴應用程式重要路徑中的值區建立、刪除或清單作業。值區名稱屬於集中式全域命名空間：對這個命名空間的任何依附元件，都會為應用程式建立單點故障。如果某個位置暫時無法使用，值區清單作業可能只會傳回部分值區清單。考量到這些因素，以及 bucket 建立/刪除限制，建議您預先建立所有必要的 bucket，確保 Cloud Storage 上的服務維持高可用性。

每個專案在每個區域的所有區域值區中，可儲存的資料位元組數上限

這項限制僅適用於使用 Rapid Bucket 的 bucket。

 預設限制為 1 TB，但可能因專案的帳單帳戶記錄而異

如要進一步瞭解可用區 bucket，請參閱「Rapid Bucket」。
每個專案的 bucket 還原速率上限 約每兩秒一項要求
每個 bucket 的中繼資料更新頻率上限 每秒更新一次 快速更新單一值區 (例如變更 CORS 設定) 可能會導致節流錯誤。
每個值區可授予 IAM 角色的主體數量上限

所有 IAM 角色的主體數量上限為 1,500 個

舊版 IAM 角色：100 個主體

 詳情請參閱「主體類型」。
每個 bucket 的 Pub/Sub 通知設定數量上限 100 項通知設定
專案中同一位置支援的並行 bucket 遷移數量上限 5 個 bucket 詳情請參閱「bucket 遷移」。
最多可設定的 Pub/Sub 通知設定數量，在特定事件發生時觸發通知 10 項通知設定
Pub/Sub 通知設定中的自訂屬性數量上限 10 項自訂屬性
Bucket 鎖定可設定的保留期限上限 3,155,760,000 秒 (100 年)
虛刪除保留時長上限 90 天
在 bucket 的所有規則中，使用 matchesPrefix 和 matchesSuffix 生命週期條件時，前置字串和後置字串的總數上限。 1,000 如要瞭解物件生命週期管理，請參閱「物件生命週期管理」。

物件

限制 值 附註
物件大小上限 5 TiB

無論寫入方法為何，包括物件組合、支援續傳的上傳作業和多部分上傳，都適用這項限制。
每個物件的所有自訂中繼資料鍵和值的大小總和上限 8 KiB
一般命名空間值區中物件的物件名稱大小上限 1024 個位元組 (UTF-8 編碼)
在已啟用階層命名空間的 bucket 中，物件名稱的大小上限

資料夾名稱：512 個位元組 (UTF-8 編碼)

基本名稱：512 個位元組 (UTF-8 編碼)
寫入相同物件名稱的最高速率 每秒寫入一次 如果寫入相同物件名稱的頻率超過上限，可能會導致節流錯誤。詳情請參閱「物件不可變性」。
單一物件的中繼資料更新頻率上限 每秒更新一次 如果更新物件中繼資料的頻率超過上限，可能會導致節流錯誤。
bucket 中物件寫入作業的最大速率 無限制 包括上傳、更新及刪除物件。儲存區一開始大約支援每秒 1,000 次寫入作業，然後會視需要調整規模。
bucket 中物件讀取速率上限 無限制 包括讀取物件資料、讀取物件中繼資料，以及列出物件。儲存空間最初每秒約可支援 5,000 次物件讀取作業，然後視需要擴充。不過請注意，頻寬有限。
存取控管清單 (ACL) 項目數量上限 每個物件 100 個 ACL 詳情請參閱「ACL 範圍」。
物件組合中的來源物件數量上限 單一組合要求中包含 32 個物件
構成複合式物件的元件數量上限 無限制 雖然組成複合式物件的元件數量沒有限制，但與複合式物件相關聯的 componentCount 中繼資料會在 2,147,483,647 達到飽和，且最終複合式物件必須遵守適用於 Cloud Storage 中所有物件的 5 TiB 大小限制。
物件保留鎖定可設定的保留時間上限 從目前日期和時間起算 3,155,760,000 秒 (100 年)
在已啟用階層命名空間的 bucket 中，讀取和寫入物件的每秒初始查詢次數 (QPS) 上限 相較於未啟用階層命名空間的 bucket，QPS 最多可增加 8 倍 如要瞭解如何在使用資料夾時提升效能，請參閱「資料夾管理」。
每個物件的脈絡資料數量上限 50
每個物件的所有物件脈絡資料鍵和值的大小總和上限 25 KiB (UTF-8 編碼)
物件脈絡資料鍵長度上限 256 個位元組 (UTF-8 編碼)
物件脈絡資料值長度上限 256 個位元組 (UTF-8 編碼)

Rapid Cache

限制 值 附註
Rapid Cache 快取大小上限 1 PiB

快取大小會根據儲存在快取中的資料量自動擴充或縮減，最多可達 1 PiB。快取大小等於擷取至快取的資料量，減去遭剔除的資料量。舉例來說，如果工作負載擷取 100 GiB 的資料，快取大小就會增加至 100 GiB。如果隨後有 50 GiB 的資料遭到淘汰，快取大小就會縮減為 50 GiB。

根據專案的帳單帳戶記錄，快取大小上限可能會較低。如果資源有限，系統可能會停止建立快取，或現有快取可能會停止成長，並根據最近最少使用 (LRU) 演算法剔除資料，為新資料騰出空間。

如要將快取儲存空間提高至 1 PiB 以上，請與客戶技術顧問或 Google 代表聯絡。
每個專案在單一區域的 Rapid Cache 資料用量頻寬上限 20 Tbps

快取頻寬限制會根據快取中儲存的資料量自動調整，每 1 TiB 資料的速率為 20 Gbps，基本值為 100 Gbps。

如要增加快取頻寬的起始或總量，請增加快取中儲存的資料量，或在區域中建立更多快取。您也可以與客戶技術顧問或 Google 代表聯絡，要求提高頻寬速率。

快取頻寬限制與專案的頻寬配額上限分開計算。從快取讀取資料會計入快取頻寬上限，直到達到上限為止，屆時資料讀取就會開始計入專案的頻寬配額。快取失敗不會計入快取頻寬限制。

由於快取頻寬限制是以專案和可用區為單位，因此即使快取是為不同 bucket 建立，同一專案和可用區內的快取流量仍會計入共同快取頻寬限制。舉例來說，假設快取 A 是在 us-east1-b 可用區中建立，用於專案 my-project 中的 bucket example-bucket-1。快取 B 是在 us-east1-b 中為 example-bucket-2 建立，同樣位於 my-project。由於快取 A 和快取 B 都位於 us-east1-b 和 my-project，因此這兩個快取的流量都會計入同一個快取頻寬限制。
每個專案在各可用區同時建立的 Rapid Cache 快取數量上限 20 個快取

在指定時間處於 creating 狀態的快取數量上限。

代管資料夾

限制 值 附註
受管理資料夾名稱大小上限 1024 個位元組 (UTF-8 編碼)
Cloud Storage 值區中的受管理資料夾數量上限 無限制
代管資料夾巢狀結構上限 15
每個代管資料夾的 IAM 政策更新頻率上限 每秒更新一次
每個代管資料夾可授予 IAM 角色的主體數量上限

所有 IAM 角色共 1,500 個主體

 在代管資料夾中，獲派 IAM 角色的主體數量，不會計入 bucket、上層代管資料夾或子代管資料夾中，可獲派 IAM 角色的主體數量上限。

JSON API 要求

限制 值 附註
批次要求的酬載總大小上限 小於 10 MiB 單一要求中請勿包含超過 100 個呼叫。
物件清單 glob 模式的大小上限 1024 個 UTF-8 編碼位元組

XML API 要求

限制 值 附註
要求網址和 HTTP 標頭的總大小上限 16 KiB
列出 bucket 時可傳回的 bucket 數量上限 1,000 個 bucket XML API 會依名稱的字典順序傳回 buckets。
多部分上傳的零件數量上限 10,000 個零件 由這些部分組成的物件必須遵守 5 TiB 的大小限制，這項限制適用於 Cloud Storage 中的所有物件。
多部分上傳中個別部分的檔案大小上限 5 GiB
多部分上傳中個別部分的大小下限 5 MiB 多部分上傳作業的最後一個部分沒有大小下限。因此，系統不會在上傳部分時強制執行這項限制，而是在您嘗試 完成上傳時強制執行。
多部分上傳作業及其上傳部分在 bucket 中維持未完成或閒置狀態的時間長度上限 無限制
可同時對物件進行的不同多部分上傳作業數量上限 無限制
完成支援續傳的上傳作業工作階段的時間上限 7 天 時間長度是從啟動支援續傳的上傳作業開始計算。

服務帳戶的 HMAC 金鑰

每個服務帳戶最多只能有 10 個 HMAC 金鑰。已刪除的金鑰不會計入這項限制。

廣告空間報表

每個來源 bucket 最多只能有 100 個庫存報表設定。

儲存空間批次作業工作

本節說明儲存空間批次作業工作的限制和配額。

並行執行的儲存空間批次作業工作

下表說明進行中並行 jobs 的限制：

限制類型 限制 套用對象
單一 bucket 中的並行工作 100 每項專案每個位置
多個值區的並行工作 5 每項專案的全球範圍
並行 bucket 作業 50 個 bucket 每個位置有多個 bucket，每個工作

頻率配額

儲存空間批次作業會對要求強制執行頻率配額。

下表列出各項配額的指標、API 方法和預設限制：

指標 API 方法 預設限制
storagebatchoperations.googleapis.com/create_requests storagebatchoperations.jobs.create 1200 項要求/分鐘/專案
storagebatchoperations.googleapis.com/read_requests
  • storagebatchoperations.jobs.get
  • storagebatchoperations.jobs.list
 每項專案每分鐘 1200 個要求
storagebatchoperations.googleapis.com/cancel_requests storagebatchoperations.jobs.cancel 每項專案每分鐘 1200 個要求
storagebatchoperations.googleapis.com/delete_requests storagebatchoperations.jobs.delete 每項專案每分鐘 1200 個要求

佇列限制

您可以將多項儲存空間批次作業工作排入佇列。排隊等候工作時，系統會強制執行下列速率限制：

  • 每項專案每分鐘：每項專案最多 600 項待處理工作。
  • 每項專案每日：每項專案最多可有 5,000 項工作排入佇列。

Cloud Storage MCP 伺服器

本節說明 Cloud Storage MCP 伺服器的限制和配額。如需使用說明，請參閱「使用 Cloud Storage MCP 伺服器」。

限制 值
檔案大小上限 8 MiB
支援的端點 僅限全球

下表說明各項工具的頻率限制：

配額 值
「McpListBuckets」、「McpListObjects」、「McpReadText」、「McpGetObjectMetadata」和「McpReadObject」的要求 600/min/project/region
McpCreateBucket和McpWriteText的要求 300/min/project/region

頻寬

配額 值 附註

每個可用區的頻寬上限 (每個專案，每個可用區)，適用於從 Cloud Storage 將資料輸出至 Google 服務

僅適用於 Rapid Bucket。

 每項專案、每個可用區的預設配額為 1 Tbps，但可能因專案的帳單帳戶記錄而異

您可以透過 Google Cloud 控制台， 依專案和可用區申請 提高配額。或者，您也可以與客戶技術顧問或 Google 代表聯絡，要求提高配額。

如要瞭解如何查看專案的 Google 輸出限制，請參閱「查看及管理配額」。

如要瞭解如何查看專案的 Google 輸出用量，請參閱「頻寬監控」。

如要進一步瞭解區域 bucket，請參閱「Rapid Bucket」。
每個區域從 Cloud Storage 輸出資料至 Google 服務的最大頻寬 大多數專案的每個區域預設配額為 200 Gbps，但可能因專案的帳單帳戶記錄而降低

輸出至 Cloud CDN 和 Media CDN 的流量不適用這項配額。

您可以要求提高配額，但必須以專案為單位。

如要瞭解如何查看專案的 Google 輸出限制，請參閱「查看及管理配額」。

如要瞭解如何查看專案的 Google 輸出用量，請參閱「頻寬監控」。
每個雙區域從 Cloud Storage 輸出資料至 Google 服務的頻寬上限 在大多數專案中，雙區域內各區域的預設配額為 200 Gbps，但可能會因專案的帳單帳戶記錄而降低

輸出至 Cloud CDN 和 Media CDN 的流量不計入這項配額。

您可以依專案要求提高配額。

如要瞭解如何查看專案的 Google 輸出限制，請參閱「查看及管理配額」。

如要瞭解如何查看專案的 Google 輸出用量，請參閱「頻寬監控」。
每個多區域的頻寬上限，資料會從 Cloud Storage 輸出至 Google 服務 大多數專案的每個區域預設配額為 200 Gbps，但可能因專案的帳單帳戶記錄而降低

輸出至 Cloud CDN 和 Media CDN 的流量不計入這項配額。

特定多區域中的各區域有各自的配額。舉例來說，假設專案 my-project 的多區域 Google 輸出頻寬配額為 200 Gbps，適用於專案內的所有區域。在這個情境中，us-east1 區域支援從 us 多區域的 bucket 將資料傳出至 Google 服務，因此頻寬為 200 Gbps；us-west1 區域支援從 us 多區域的 bucket 將資料傳出至 Google 服務，因此頻寬為 200 Gbps。

如要瞭解如何查看專案的 Google 輸出限制，請參閱「查看及管理配額」。

如要瞭解如何查看專案的 Google 輸出用量，請參閱「頻寬監控」。

您可以以專案為單位要求提高配額。請注意，如果工作負載對 Google 服務的輸出率較高，通常應使用位於區域或雙區域的值區。如果現有多區域 bucket 在 Google 服務中執行大型工作負載，您可以使用 Storage 移轉服務將資料移至單一區域或雙區域的 bucket。
從區域中的 bucket 存取資料的網際網路要求，其輸出頻寬上限 大多數專案的每個區域預設配額為 200 Gbps，但可能因專案的帳單帳戶記錄而降低

因快取失敗而輸出至 Cloud CDN 和 Media CDN 的流量，會計入這項配額。

如要瞭解如何查看專案的網際網路輸出限制，請參閱「查看及管理配額」。

如要瞭解如何查看專案的網際網路輸出用量，請參閱「頻寬監控」。

您可以要求提高配額，但必須以專案為單位。
從雙區域 bucket 存取資料的網際網路要求，其輸出頻寬上限 在大多數專案中，雙區域內各區域的預設配額為 200 Gbps，但可能會因專案的帳單帳戶記錄而降低

因快取失敗而輸出至 Cloud CDN 和 Media CDN 的流量，會計入這項配額。

如要瞭解如何查看專案的網際網路輸出限制，請參閱「查看及管理配額」。

如要瞭解如何依區域查看專案的網際網路輸出用量，請參閱「頻寬監控」。

您可以以專案為單位要求增加配額。
網際網路要求從指定多區域中的 bucket 存取資料時，可使用的輸出頻寬上限 大多數專案的每個區域預設配額為 200 Gbps，但可能因專案的帳單帳戶記錄而降低

因快取失敗而輸出至 Cloud CDN 和 Media CDN 的流量，會計入這項配額。

多區域中的區域具有個別的多區域網際網路輸出配額。舉例來說，假設 my-project 從 us 多區域的 bucket 將資料傳送給全球各地的客戶。在這種情況下，us 多區域中的不同區域會使用各自的網際網路輸出配額，因為資料是從 bucket 傳送至世界各地。一般來說，網際網路輸出配額會計入地理位置最接近資料目的地的區域。

如要瞭解如何查看專案的網際網路輸出限制，請參閱「查看及管理配額」。

如要瞭解如何依區域查看專案的網際網路輸出用量，請參閱「頻寬監控」。

您可以以專案為單位申請提高配額。

如果專案頻寬超過特定配額，對受影響值區發出的要求可能會受到限制，或遭到拒絕並顯示可重試的 429 - rateLimitExceeded 錯誤，其中包含超出配額的詳細資料。如要瞭解如何監控頻寬，請參閱「頻寬用量」。