本頁面的部分或所有資訊可能不適用於 S3NS 的 Cloud de Confiance。詳情請參閱「與 Google Cloud 的差異」。

Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

配額與限制

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

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

bucket

限制	值	附註
值區名稱大小上限	63 個字元
每個專案的 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`，因此這兩個快取的流量都會計入同一個快取頻寬限制。注意：為不同位置類型的 bucket 建立快取時，即使快取是在相同可用區建立，也不會計入相同的快取頻寬限制。舉例來說，假設快取 A 和快取 B 都是在 `us-east1-b` 可用區中建立，但快取 A 屬於 `us-east1` 區域中的 bucket，快取 B 則屬於 `US` 多區域中的 bucket。由於相關聯的值區具有不同的位置類型 (一個儲存在區域中，另一個儲存在多區域中)，因此快取會有不同的快取頻寬限制。
每個專案在各可用區同時建立的 Rapid Cache 快取數量上限	20 個快取	在指定時間處於 `creating` 狀態的快取數量上限。

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，因此這兩個快取的流量都會計入同一個快取頻寬限制。

注意：為不同位置類型的 bucket 建立快取時，即使快取是在相同可用區建立，也不會計入相同的快取頻寬限制。舉例來說，假設快取 A 和快取 B 都是在 us-east1-b 可用區中建立，但快取 A 屬於 us-east1 區域中的 bucket，快取 B 則屬於 US 多區域中的 bucket。由於相關聯的值區具有不同的位置類型 (一個儲存在區域中，另一個儲存在多區域中)，因此快取會有不同的快取頻寬限制。

每個專案在各可用區同時建立的 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 金鑰。已刪除的金鑰不會計入這項限制。

儲存空間批次作業工作

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

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

下表說明進行中並行 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，但可能因專案的帳單帳戶記錄而異	您可以透過 Cloud de Confiance 控制台，依專案和可用區申請提高配額。或者，您也可以與客戶技術顧問或 Google 代表聯絡，要求提高配額。如要瞭解如何查看專案的 Google 輸出限制，請參閱「查看及管理配額」。如要瞭解如何查看專案的 Google 輸出用量，請參閱「頻寬監控」。如要進一步瞭解區域 bucket，請參閱「Rapid Bucket」。
每個區域從 Cloud Storage 輸出資料至 Google 服務的最大頻寬	大多數專案的每個區域預設配額為 200 Gbps，但可能因專案的帳單帳戶記錄而降低	您可以要求提高配額，但必須以專案為單位。如要瞭解如何查看專案的 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，但可能因專案的帳單帳戶記錄而降低	如要瞭解如何查看專案的網際網路輸出限制，請參閱「查看及管理配額」。如要瞭解如何查看專案的網際網路輸出用量，請參閱「頻寬監控」。您可以要求提高配額，但必須以專案為單位。
從雙區域 bucket 存取資料的網際網路要求，其輸出頻寬上限	在大多數專案中，雙區域內各區域的預設配額為 200 Gbps，但可能會因專案的帳單帳戶記錄而降低	因快取失敗而輸出至 Cloud CDN 和 Media CDN 的流量，會計入這項配額。如要瞭解如何查看專案的網際網路輸出限制，請參閱「查看及管理配額」。如要瞭解如何依區域查看專案的網際網路輸出用量，請參閱「頻寬監控」。您可以以專案為單位要求增加配額。
網際網路要求從指定多區域中的 bucket 存取資料時，可使用的輸出頻寬上限	大多數專案的每個區域預設配額為 200 Gbps，但可能因專案的帳單帳戶記錄而降低	因快取失敗而輸出至 Cloud CDN 和 Media CDN 的流量，會計入這項配額。多區域中的區域具有個別的多區域網際網路輸出配額。舉例來說，假設 `my-project` 從 `us` 多區域的 bucket 將資料傳送給全球各地的客戶。在這種情況下，`us` 多區域中的不同區域會使用各自的網際網路輸出配額，因為資料是從 bucket 傳送至世界各地。一般來說，網際網路輸出配額會計入地理位置最接近資料目的地的區域。如要瞭解如何查看專案的網際網路輸出限制，請參閱「查看及管理配額」。如要瞭解如何依區域查看專案的網際網路輸出用量，請參閱「頻寬監控」。您可以以專案為單位申請提高配額。

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