本文列出 Artifact Registry 適用的配額和系統限制。
- 「配額」會指定您可使用的可計數共用資源數量。 Google Cloud 服務 (例如 Artifact Registry) 會定義配額。
- 系統限制為固定值，無法變更。
Google Cloud 會使用配額來確保公平性，並減少資源使用量和可用性的尖峰情形。配額會限制 Google Cloud 專案可使用的Google Cloud 資源數量。配額適用於多種資源類型，包括硬體、軟體和網路元件。舉例來說，配額可以限制向服務發出的 API 呼叫數、專案並行使用的負載平衡器數量，或可建立的專案數量。限制配額可預防服務超載，進而保障Google Cloud 使用者社群的權益。配額也能協助您管理自己的 Google Cloud 資源。
Cloud 配額系統會執行以下作業：
在大多數情況下，如果您嘗試使用的資源超過配額限制，系統會封鎖對該資源的存取權，而您要執行的任務也會失敗。
配額通常會套用至 Google Cloud 專案層級。您在一個專案中使用資源，不會影響其他專案的可用配額。在 Google Cloud 專案中，所有應用程式和 IP 位址都會共用配額。
Artifact Registry 資源也有系統限制。系統限制無法變更。
Artifact Registry 對傳入要求的頻率設有上限，並會以專案和使用者為單位限定配額。
如需有關配額政策、查看配額及管理配額的資訊，請參閱使用配額一文。
請前往 API 資訊主頁，瞭解您目前的 API 活動。
配額
Artifact Registry 會強制執行下列配額。
每項專案的要求配額
| 配額 | 值 | 其他資訊 |
|---|---|---|
| 各個單一地區或多地區位置的每分鐘要求數 | 60,000 | |
| 各個單一地區或多地區位置的每分鐘寫入要求數 | 18,000 | 在大多數情況下，單一 HTTP 要求或 API 呼叫會計為單一要求。 不過，某些作業會計為多個要求。舉例來說，像是 `ImportAptArtifacts` 的批次要求，可能會針對批次中的每個項目收取配額費用。Docker 提取或推送作業通常會產生多項 HTTP 要求，因此系統會針對每項要求收取配額費用。 |
| 各個單一區域或多區域位置的每分鐘刪除要求數 | 18,000 | 清理政策要求的刪除作業，會計入刪除要求配額和每天刪除作業數量的限制，每個存放區各有一個限制。 |
每位使用者的要求配額
在專案中，每位使用者可傳送的要求次數並沒有預設的配額上限。不過，您可以選擇在專案中設定每位使用者的配額上限。每位使用者的配額上限適用於每位已通過驗證的使用者。如果用戶端 IP 位址會將未經驗證的要求傳送至公開存放區，則同樣適用這類配額上限。
Cloud KMS 配額和 Artifact Registry
在 Artifact Registry 中使用 CMEK 時，專案可以使用 Cloud KMS 密碼編譯要求配額。舉例來說，使用 CMEK 加密的存放區每次上傳或下載時，都會消耗這些配額。只有在使用硬體 (Cloud HSM) 或外部 (Cloud EKM) 金鑰時，使用 CMEK 金鑰進行加密和解密作業才會影響 Cloud KMS 配額。確認您有足夠的配額，可為應用程式和工作流程啟用應用程式層密碼加密功能。詳情請參閱「Cloud KMS 配額」。
Artifact Analysis 配額
如要瞭解掃描使用政策，請參閱「Artifact Analysis 配額和限制」。
公開上游配額
如果您使用遠端存放區快取公開的上游存放區，可能會受到上游存放區的讀取和寫入配額限制。
使用限制
Artifact Registry 的用量限制如下：
| 用量限制 | 值 |
|---|---|
| 每天每個存放區的清理政策刪除作業 | 300,000 |
| 每個存放區的資源清理政策 | 10 |
| 每個要求從遠端存放區上游擷取的資料上限 | 9.9 GB |
| 虛擬存放區的上游政策上限 | 30 |
| 虛擬存放區每個要求的總上游解析結果數上限 | 250 |
| 虛擬存放區每個要求的遠端存放區上游解析結果數量上限 | 30 |
| 每個區域每分鐘的存放區建立和刪除作業 | 30 |
遠端存放區限制
當您從遠端存放區要求構件，且構件尚未在遠端存放區中快取時，系統會從上游存放區要求構件，然後儲存在遠端存放區。對上游主機提出的要求會計入貴機構的上游主機讀取要求限制，在遠端存放區快取構件時，會使用專案的寫入和要求配額。一旦產物快取到遠端，對該產物的要求只會計入專案的要求配額。
Artifact Registry 會對遠端存放區強制執行下列用量限制。
| 限制 | 公開上游 | 值 |
|---|---|---|
| 每個機構、每個區域、每分鐘的公開上游主機讀取次數 | 預設 | 600 |
| Docker Hub | 600 | |
| proxy.golang.org | 600 | |
| Maven Central | 3000 | |
| NpmJS | 1800 | |
| PyPI | 1200 |
列出存放區中構件的限制
所有格式的格式專屬 API 要求數量上限為 10,000 次。舉例來說，如果存放區含有超過 10,000 個映像檔或標記，列出容器映像檔的 Docker Registry API 方法將會傳回不完整的清單。
這項限制不適用於 gcloud artifacts docker images list 指令或 Artifact Registry API 要求。
申請提高配額
如要調整大部分配額，請使用 Google Cloud 控制台。詳情請參閱「要求調整配額」。