配額與限制

本文列出 Artifact Registry 適用的配額和系統限制。

  • 配額會指定您可使用的可計數共用資源數量。配額是由 Artifact Registry 等 Google Cloud 服務定義。
  • 系統限制是無法變更的固定值。

Google Cloud 會使用配額來確保公平性,並減少資源使用量和可用性暴增的情況。配額會限制專案可使用的Google Cloud 資源 Google Cloud 數量。配額適用於各種資源類型,包括硬體、軟體和網路元件。舉例來說,配額可以限制對服務發出的 API 呼叫數、專案並行使用的負載平衡器數量,或是可建立的專案數量。配額可以預防服務過載,進而保障Google Cloud 使用者社群的權益。配額也能協助您管理自己的 Google Cloud 資源。

Cloud Quotas 系統會執行下列操作:

在大多數情況下,如果您嘗試使用的資源超過配額,系統會封鎖資源存取權,導致您嘗試執行的工作失敗。

配額通常是在 Google Cloud 專案 層級套用。在一個專案中使用資源,不會影響另一個專案的可用配額。在 Google Cloud 專案中,所有應用程式和 IP 位址會共用配額。

Artifact Registry 資源也有系統限制。 系統限制無法變更。

Artifact Registry 對傳入要求的頻率設有上限,並會以專案和使用者為單位限定配額。

如要進一步瞭解配額政策、查看配額及管理配額,請參閱 Cloud Quotas 說明文件

請前往 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 配額。 確認您有足夠的配額,可為應用程式和工作流程啟用應用程式層 Secret 加密功能。詳情請參閱「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 控制台。 詳情請參閱「要求調整配額」。