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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

配額與限制

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

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

值區

限制	值	附註
值區名稱大小上限	63 個半形字元
每個專案的值區建立和刪除速率上限	每兩秒約發出一個要求	在大多數情況下，我們會建議您盡量減少使用值區而多使用物件。舉例來說，一般的設計原則是每位專案使用者僅使用一個值區。不過，如果您設計的系統每秒會加入多位使用者，則可將多位使用者歸入同一個值區，並授予他們合適的權限，以避免受限於值區建立頻率。如為高可用性應用程式，請避免在運作的關鍵路徑中建立、刪除或列出值區。值區名稱隸屬於全域集中型命名空間，如果應用程式使用了這個命名空間，就會產生單點故障。如果某個位置暫時無法使用，值區清單作業可能只會傳回部分值區清單。基於這些考量和值區建立/刪除限制，我們會建議您為 Cloud Storage 中的高可用性服務預先建立所有必要值區。
每個專案在每個可用區的所有區域值區中，可儲存的資料位元組數上限這項限制僅適用於使用Rapid Bucket的值區。	預設上限為 1 TB，但可能會根據專案的帳單帳戶記錄而有所不同	如要進一步瞭解區域值區，請參閱「Rapid Bucket」。
每個專案的值區還原速率上限	每兩秒約發出一個要求
每個值區的值區中繼資料更新頻率上限	每秒更新一次	快速更新單一值區 (例如變更 CORS 設定) 可能會導致節流錯誤。
每個 bucket 可授予 IAM 角色的主體數量上限	所有 IAM 角色的主體數量上限為 1,500 個舊版 IAM 角色：100 個主體	詳情請參閱「主體類型」。
每個值區的 Pub/Sub 通知設定數量上限	100 項通知設定
專案中同一位置支援的並行 bucket 搬遷作業數量上限	5 個值區	詳情請參閱「Bucket 遷移」。
針對特定事件設定的觸發通知，最多可以建立 10 個 Pub/Sub 通知設定。	10 個通知設定
Pub/Sub 通知設定中的自訂屬性數量上限	10 個自訂屬性
可為 Bucket Lock 設定的保留期限上限	3,155,760,000 秒 (100 年)
虛刪除保留期限上限	90 天
在 bucket 的所有規則中，使用 `matchesPrefix` 和 `matchesSuffix` 生命週期條件時，前置字串和後置字串的總數上限。	1,000	如要瞭解物件生命週期管理，請參閱「物件生命週期管理」。

物件

限制	值	附註
最大 object 大小	5 TiB	無論寫入方法為何，包括物件組合、可續傳的上傳作業和多部分上傳作業，都適用這項限制。
每個物件的所有自訂中繼資料鍵和值總計大小上限	8 KiB
扁平命名空間值區中物件的物件名稱大小上限	1024 個位元組 (UTF-8 編碼)
啟用階層命名空間的 bucket 中，物件的物件名稱大小上限	資料夾名稱：512 個位元組 (UTF-8 編碼) 基本名稱： 512 個位元組 (UTF-8 編碼) 。
寫入相同物件名稱的最高速率	每秒一次寫入	如果以高於限制的速率寫入相同物件名稱，可能會導致節流錯誤。詳情請參閱「物件不變原則」。
單一物件的中繼資料更新速度上限	每秒更新一次	如果更新物件中繼資料的頻率超過上限，可能會導致節流錯誤。
值區中的物件寫入速度上限	無限制	包括上傳、更新及刪除物件。值區一開始即可支援每秒約 1,000 次的寫入作業，之後則會視需求彈性調整。
值區中物件的讀取速度上限	無限制	包括讀取物件資料、讀取物件中繼資料，以及列出物件。值區一開始即可支援每秒約 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 建立，來自同一專案和區域內快取的流量，仍會計入共同的快取頻寬限制。舉例來說，假設在區域 `us-east1-b` 中為 bucket `example-bucket-1` 建立快取 A，而 bucket `example-bucket-1` 位於專案 `my-project` 中。在 `us-east1-b` 中為 bucket `example-bucket-2` 建立快取 B，而 bucket `example-bucket-2` 也位於 `my-project` 中。由於快取 A 和快取 B 都位於 `us-east1-b` 和 `my-project` 中，因此這兩個快取的流量都會計入相同的快取頻寬限制。注意：為不同位置類型的 bucket 建立的快取，不會計入相同的快取頻寬限制，即使快取是在同一個區域中建立也一樣。舉例來說，假設快取 A 和快取 B 都是在 `us-east1-b` 區域中建立，但快取 A 屬於 `us-east1` 區域中的值區，快取 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 建立，來自同一專案和區域內快取的流量，仍會計入共同的快取頻寬限制。舉例來說，假設在區域 us-east1-b 中為 bucket example-bucket-1 建立快取 A，而 bucket example-bucket-1 位於專案 my-project 中。在 us-east1-b 中為 bucket example-bucket-2 建立快取 B，而 bucket example-bucket-2 也位於 my-project 中。由於快取 A 和快取 B 都位於 us-east1-b 和 my-project 中，因此這兩個快取的流量都會計入相同的快取頻寬限制。

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

每個專案在每個可用區同時建立的 Rapid Cache 快取數量上限

20 個快取

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

代管資料夾

限制	值	附註
受管理資料夾名稱大小上限	1024 個位元組 (UTF-8 編碼)
Cloud Storage 值區中的代管資料夾數量上限	無限制
代管資料夾巢狀結構深度上限	15
每個代管資料夾的 IAM 政策更新頻率上限	每秒更新一次
每個代管資料夾可授予 IAM 角色的主體數量上限	所有 IAM 角色的主體數量上限為 1,500 個	在代管資料夾中獲派 IAM 角色的主體數量，不會計入可獲派 IAM 角色的主體數量上限，這些主體包括代管資料夾所屬的 bucket、父項代管資料夾或子項代管資料夾。

JSON API 要求

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

XML API 要求

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

服務帳戶的 HMAC 金鑰

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

Storage 批次作業工作

本節說明使用儲存空間批次作業工作的現行 API 限制和用量配額。

並行執行的 Storage 批次作業工作

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

執行中的「jobs」上限	套用對象
100	每個值區位置每項專案

頻率配額

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

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

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

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 輸出用量，請參閱「頻寬監控」一文。如要進一步瞭解區域值區，請參閱「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` 多區域中的值區輸出資料至 Google 服務時，頻寬為 200 Gbps；`us-west1` 區域支援從 `us` 多區域中的值區輸出資料至 Google 服務時，頻寬為 200 Gbps。如要瞭解如何查看專案的 Google 輸出限制，請參閱「查看及管理配額」。如要瞭解如何查看專案的 Google 輸出用量，請參閱「頻寬監控」一文。您可以要求提高每個專案的配額。請注意，一般來說，對於輸出至 Google 服務的資料量較大的工作負載，您應使用位於單一區域或雙區域的值區。如果現有的多區域值區在 Google 服務中執行大量工作負載，您可以使用 Storage 移轉服務將資料移至單一區域或雙區域的值區。
從區域中的值區存取資料時，網際網路要求可用的輸出頻寬上限	大多數專案的每個區域預設配額為 200 Gbps，但可能會根據專案的帳單帳戶記錄而降低	如要瞭解如何查看專案的網際網路輸出限制，請參閱「查看及管理配額」。如要瞭解如何查看專案的網際網路輸出用量，請參閱「頻寬監控」。您可以要求增加配額，但須以專案為單位。
從雙區域的 bucket 存取資料時，網際網路要求可用的輸出頻寬上限	大多數專案的雙區域內各區域預設配額為 200 Gbps，但可能會根據專案的帳單帳戶記錄而降低	因快取未命中而輸出至 Cloud CDN 和 Media CDN 的流量，也計入這項配額。如要瞭解如何查看專案的網際網路輸出限制，請參閱「查看及管理配額」。如要瞭解如何依區域查看專案的網際網路輸出用量，請參閱「頻寬監控」。您可以要求增加每個專案的配額。
從特定多區域的 bucket 存取資料時，網際網路要求可用的輸出頻寬上限	大多數專案的每個區域預設配額為 200 Gbps，但可能會根據專案的帳單帳戶記錄而降低	因快取未命中而輸出至 Cloud CDN 和 Media CDN 的流量，也計入這項配額。多區域中的各個區域有各自的多區域網際網路輸出配額。舉例來說，假設 `my-project` 從 `us` 多區域的值區傳送資料給全球各地的客戶。在這種情況下，`us` 多區域內的不同區域會使用各自的網際網路輸出配額，因為資料會從值區傳送至世界各地。一般來說，網際網路輸出配額會計入地理位置最接近資料目的地的區域。如要瞭解如何查看專案的網際網路輸出限制，請參閱「查看及管理配額」。如要瞭解如何依區域查看專案的網際網路輸出用量，請參閱「頻寬監控」。您可以要求增加每個專案的配額。

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