限制 API 使用量

視 API 而定，您可以限制每日要求數、每分鐘要求數或每位使用者每分鐘要求數，明確設定要求上限。

這些是 API 專屬的使用限制。舉例來說，如要避免因超出免費用量而產生費用，可以設定每日要求數上限。

這些限制旨在精細控管特定服務的用量，並非專案整體的支出上限。如要避免整個專案或帳單帳戶產生預期外的費用，請參閱「建立、編輯或刪除預算和預算快訊」。

查看及修改要求次數上限

您可以針對任何可計費 API 的所有要求設定限制。大多數 API 都會設定預設限制，但您可以將限制變更為 Google 指定的上限。部分 API 會設定低用量限制，直到您為專案啟用計費功能為止。

如要查看或變更 API 的限制，請按照下列步驟操作：

  1. 在 Google Cloud 控制台中，前往「APIs & Services Dashboard」(API 與服務資訊主頁) 頁面。

    前往「API 和服務」資訊主頁

  2. 在專案清單中選取所需專案，或是建立新的專案。
  3. 找到您有興趣瞭解的 API，然後按一下其名稱。
  4. 按一下 [配額]。如果分頁導覽中沒有「配額」分頁，表示您選取的 API 未定義配額。
  5. 如要找出要設上限的配額，請在「篩選」欄位中輸入適當的屬性和值。舉例來說，如要尋找「子網路」配額，請輸入「Quota:Subnetworks」。
  6. 勾選要設上限的配額旁的核取方塊，然後按一下 「編輯配額」。
  7. 填寫配額變更表單，包括要設定的新限制。
  8. 按一下 [提交要求]。

部分 API 可讓您提交表單來要求提高上限。部分 API 僅允許您在 專案啟用帳單功能時指定較高的配額。

限制每位使用者的要求數

為避免個別使用者耗盡 API 配額，部分 API 設有預設的每位使用者每分鐘限制。

如要查看 API 是否包含每位使用者每分鐘的預設限制，請按照「查看及修改要求數量的限制」一文中的說明，在 API 配額中尋找。如果該 API 有這類預設限制，您可以按照這些操作說明中的步驟修改該值，限制每位使用者的可用配額。如果 API 的配額未包含這項預設限制，則不支援新增或修改。

根據預設，系統會使用經過驗證的主體來識別個別使用者。已驗證的主體包括使用 OAuth 權杖的使用者帳戶、服務帳戶或聯合工作負載身分。如果沒有經過驗證的主體，系統會使用用戶端 IP 位址。由於這項備援行為預設為啟用，即使您未指定使用者 ID，系統仍會強制執行每位使用者的配額。

使用用戶端 IP 位址備用機制有兩項主要限制：

  • 共用公開 IP：網路位址轉譯 (NAT) 閘道或 Proxy 後方的多位使用者 (例如學校辦公室或 VPN 端點)，會共用單一公開 IP 位址。他們的要求會匯集到同一個配額儲存區，可能導致配額過早用盡。
  • 以 IP 為基礎的規避行為：如果使用者可以存取大量 IPv6 位址或 VPN Proxy，就能輪流使用用戶端 IP 位址來規避速率限制，導致 IP 回退機制無法提供可靠的濫用行為防護。

如果您是代表多位使用者，從伺服器端應用程式呼叫 API (呼叫程式碼會託管在您擁有的伺服器上)，並使用單一經過驗證的主體，所有呼叫都會歸給該主體。在這種情況下，無法分別為個別使用者設定通話上限。為避免這種情況，您可以在要求中指定 quotaUser 參數或 X-Goog-Quota-User 標頭，覆寫預設的使用者 ID 和配額用量。這些參數定義於「系統參數」說明文件中。

如要使用 quotaUser 參數或 X-Goog-Quota-User 標頭覆寫預設使用者 ID，您必須使用設有服務限制 (例如 IP 位址限制或 HTTP 參照網址限制) 的有效 API 金鑰，識別配額專案。否則系統會忽略該參數或標頭，並改回預設的使用者識別方式。

如要識別使用者，請使用 quotaUser=userID 網址查詢參數。這個值僅用於短期配額強制執行，因此不需要使用真實的使用者 ID。您可以選擇任何長度不超過 40 個半形字元的任意字串，用來識別使用者。

為保護使用者隱私權及限制指標量， Google Cloud 控制台 和 Cloud Monitoring 不會儲存或顯示個別 quotaUser或 IP 位址剖析的遙測資料。您可以查看整體專案配額限制和總用量，但無法監控、覆寫或設定特定個別使用者的快訊。

如果 API 未包含每位使用者每分鐘的預設限制，系統會忽略 quotaUser 值。

查看及編輯專案中 API 的所有配額

如要查看、編輯特定專案中所有可計費 API 的配額限制，以及申請提高配額限制，請前往Google Cloud 控制台的「IAM & Admin」(IAM 與管理) 專區，然後查看「Quotas」(配額) 頁面。

如要查看及編輯專案中所有付費 API 的配額，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「Quotas」(配額)頁面。

    前往配額頁面

  2. 從專案清單中選取專案，或建立新專案。 系統會顯示所選專案的「配額」頁面，列出各項服務中每種配額的項目。
  3. 按一下「篩選表格」，即可依特定屬性查詢配額。
  4. 找出要編輯的配額，然後勾選旁邊的方塊。 您必須先啟用專案的帳單功能，才能勾選部分核取方塊。
  5. 按一下「EDIT QUOTAS」(編輯配額)。
  6. 在顯示的「配額變更」窗格中，展開服務檢視畫面，然後視需要編輯該服務的配額，並按一下「完成」。
  7. 重複以上操作，編輯每一項所選服務的配額。
    • 輸入框中會預先填入目前的配額限制。
    • 提交時顯示警示圖示 () 的服務有輸入錯誤。
    • 如要編輯更多配額，請按照上述步驟選取。
    • 如要從「配額變更」窗格中移除服務，請將滑鼠游標懸停在未展開的服務檢視畫面，然後按一下刪除圖示 ()。
  8. 編輯配額完成後，請按一下「下一步」。
  9. 如果配額編輯要求需要審查，系統會顯示「聯絡人詳細資料」表單。在表單中填寫聯絡資訊。
  10. 按一下「提交要求」。