配額與限制

本頁面說明 API Gateway 的配額限制。

API、API 設定和閘道的限制

API Gateway 會強制實行下列 API、API 設定與閘道限制：

  • API - 總計 50 個
  • API 設定 - 每個 API 100 項
  • 閘道 - 每個地區 50 個

如果您在同一個 API 的第一個 API 設定建立完成前，嘗試建立第二個 API 設定，則一個或兩個設定可能無法在閘道中供日後使用。

要求頻率限制

每項服務生產端專案的預設頻率限制為每 100 秒 1,000 萬個配額單位。 每項 services.check 呼叫和 services.report 回報的每項作業都會耗用一個配額單位。

酬載大小上限

以下限制僅適用於透過已部署閘道傳送的流量酬載大小上限：

限制項目 大小
要求大小 32 MB
回應大小 32 MB
gRPC 轉碼回應大小 1 MB
gRPC 轉碼要求大小 1 MB

不支援串流。

標頭大小限制

以下限制僅適用於透過已部署閘道傳送的流量標頭大小上限：

限制 金額
要求標頭大小 60 KB

API Gateway 呼叫的後端服務可能設有較低的限制。

如何提高配額

Cloud Quotas 的調整要求可能需要經過審查。如果配額調整要求需要審查，我們會發送電子郵件通知，確認已收到您的要求。如需進一步協助，請回覆該電子郵件。要求經審查後，我們會傳送電子郵件，通知您要求是否獲准。您可以透過 Google Cloud 控制台、Cloud Quotas API 或 Google Cloud CLI 申請調整配額。以下說明如何使用 Google Cloud 控制台或向 Cloud Quotas API 發出 REST 要求，申請新的配額值。

控制台

如要申請調整配額，請按照下列步驟操作：

  1. 在 Google Cloud 控制台，依序前往「IAM & Admin」(IAM 與管理) >「配額與系統限制」頁面：

    前往「配額與系統限制」頁面

    如果系統提示選取專案，請選取要調整的專案。

  2. 找出要調整的配額，然後開啟「配額變更」對話方塊：

    • 表格未列出的配額：

      • 在「Filter」(篩選器) 搜尋框中搜尋配額。請勿指定區域或地帶 (如適用)，因為配額如果沒有使用或調整值，就不會顯示在表格中。
      • 在表格中找出配額的任何項目。可以是預設項目，也可以是任何有記錄的項目，不論區域或時區。
      • 在項目所在資料列中，依序點選 「更多動作」>「設定其他區域/可用區」。
      • 選取要調整的區域或時區。按一下 [編輯]。

    • 所有其他配額：

      • 在「Filter」(篩選器) 搜尋框中搜尋配額。
      • 在項目的行中，選取配額的核取方塊。
      • 按一下「編輯」。

    「Quota changes」(配額變更) 對話方塊隨即顯示。

  3. 如果「New value」(新值) 欄位上方顯示「Apply for higher quota」(申請更多配額) 連結，且您想將配額值提高到超出畫面上顯示的數字，請點選該連結。填寫表單並提交，其餘步驟可略過。否則請繼續按照本指南操作。

  4. 在「New value」(新值) 欄位中，輸入想要增加的配額值。如果出現「Request description」(要求說明) 欄位，請輸入說明。接著點選「完成」。

    • 如果核取方塊顯示「我瞭解這項要求將移除任何覆寫設定」，表示您的配額值已設為低於預設值。將配額值調整為預設值或更高，會移除覆寫值。 如要繼續，請勾選核取方塊。進一步瞭解配額覆寫設定。

    如果畫面上出現「Next」(下一步) 按鈕，請按一下「Next」(下一步)，然後在隨後的畫面中填入聯絡資料。

  5. 點選「Submit request」(提交要求)。

如果發現無法透過控制台提出調整要求，請向 Cloud Customer Care 申請提高配額。

如要進一步瞭解配額提高程序的運作方式，請參閱「關於配額調整」的相關說明。

批次傳送配額調整要求

您可以選取每個要納入的配額旁邊的核取方塊，以便批次傳送調整配額的要求。不過，批次傳送要求可能會增加 Google Cloud 審查要求所需的時間。

為縮短審查時間，請依產品和區域將配額調整要求分組。舉例來說，如果您想申請調整網路和 Compute Engine VM 配額，請分別建立網路配額和 Compute Engine VM 配額的要求。

REST

如要透過 Cloud Quotas API 申請調整配額，請使用下列程式碼範例。在可編輯的預留位置填入您的值。如要瞭解預留位置欄位，請參閱程式碼範例後方的說明。

POST projects/PROJECT_NUMBER/locations/global/quotaPreferences?quotaPreferenceId=QUOTA_PREFERENCE_ID {
    "service": "SERVICE_ID",
    "quotaId": "QUOTA_ID",
    "quotaConfig": { "preferredValue": "NEW_QUOTA_VALUE" },
    "dimensions": { "DIMENSION_1": "VALUE_1", "DIMENSION_2": "VALUE_2" },
    "justification": "JUSTIFICATION",
    "contactEmail": "EMAIL"
}

更改下列內容：

  • PROJECT_NUMBER：您的 Google Cloud 專案編號。您可以在 Google Cloud 控制台的「Welcome」(歡迎)頁面找到專案編號，也可以執行下列 gcloud CLI 指令：

    PROJECT=$(gcloud info --format='value(config.project)')
gcloud projects describe ${PROJECT} --format="value(projectNumber)"

  • QUOTA_PREFERENCE_ID：要更新的配額偏好設定 ID。

  • QUOTA_ID：要更新的配額 ID。

  • SERVICE_ID：要調整配額的 Google Cloud ID。通常採用 SERVICE_NAME.googleapis.com 格式。舉例來說，Compute Engine 服務名稱為 compute.googleapis.com。

  • DIMENSION_1：要調整的維度類型，例如 region 或 zone。您可以加入多個維度。請在每個維度的值後面加上半形逗號，例如 VALUE_1，藉此分隔維度。如要調整配額的所有維度，請省略這一行。

  • VALUE_1：前一個維度的值。舉例來說，如果前一個維度是 region，請輸入區域，例如 us-central1。

  • JUSTIFICATION：這項要求的原因。

  • EMAIL：如果 Google Cloud 需要更多資訊才能做出決定，並核發額外配額，這個電子郵件地址可用於聯絡。

要求範例

以下範例是針對 Compute Engine 配額 PUS-PER-GPU-FAMILY-per-project-region 提出配額值增加要求。這項要求會為 us-central1 地區的 GPU 系列 NVIDIA_H100 機器申請 100 的配額值。

POST projects/123/locations/global/quotaPreferences?quotaPreferenceId=my_quota_preference_ID {
    "service": "compute.googleapis.com",
    "quotaId": "GPUS-PER-GPU-FAMILY-per-project-region",
    "quotaConfig": { "preferredValue": 100 },
    "dimensions": { "region": "us-central1", "gpu_family": "NVIDIA_H100" },
    "justification": "My justification.",
    "contactEmail": "222larabrown@gmail.com"
}