配額與限制

Media CDN 會使用配額和系統限制,確保資源分配公平、防止服務過載,並協助您管理資源用量。

配額和系統限制類似,但有以下差異:

  • 「配額」有預設值,但通常可以申請調整。
  • 「系統限制」是固定值,無法變更。

Google Cloud 使用配額來確保公平性,並減少資源使用量和可用性出現劇烈波動的情況。配額會限制 Google Cloud 專案可使用的Google Cloud 資源數量,配額適用多種資源類型,包括硬體、軟體和網路元件。舉例來說,配額可能會限制能向特定服務發出的 API 呼叫次數、專案可同時使用的負載平衡器數量,或是可建立的專案數量。配額機制可防止服務過載,保障Google Cloud 使用者社群的權益,同時也有助於您管理自己的 Google Cloud 資源。

Cloud Quotas 系統具備以下功能:

如果嘗試使用的資源量超過配額限制,系統通常會阻擋該資源的存取活動,您所執行的工作就會失敗。

配額的計算通常是以 Google Cloud 專案為基準。在某個專案中使用資源,不會影響另一個專案的可用配額。在同一個 Google Cloud 專案內,所有應用程式和 IP 位址會共用配額。

詳情請參閱「Cloud Quotas 總覽」。

Media CDN 資源也有系統限制。而且無法變更。

配額

Media CDN 適用下列配額。如要提高配額,請洽詢 Google Cloud 銷售團隊,要求調整配額。詳情請參閱「要求調整配額」。

設定

項目 預設配額
每項專案的 EdgeCacheService 資源數量上限 20
每項專案的 EdgeCacheOrigin 資源數量上限 30
每項專案的 EdgeCacheKeyset 資源數量上限 10

系統限制

Media CDN 適用下列限制。

設定

項目 限制 附註
每個EdgeCacheService的RouteRules資源數量上限 200

每個 EdgeCacheService 最多可定義 200 個 RouteRules 資源。

每個EdgeCacheService的PathMatchers資源數量上限 50

每個 EdgeCacheService 最多可定義 50 個 PathMatchers 資源。

每項服務的 SSL 憑證數量上限 5 請參閱 SSL 憑證的每項專案配額。
每個EdgeCacheKeyset的公開金鑰數量上限 3 金鑰組中的多個金鑰可啟用金鑰輪替。請不時移除未使用的金鑰。
每個EdgeCacheKeyset的驗證共用金鑰數量上限 3 金鑰組中有多個金鑰,可啟用金鑰輪替:您應不時移除較舊和未使用的金鑰。

HTTP 標頭、要求和狀態碼

項目 限制 附註
要求標頭大小上限 (含要求路徑) 16 KiB 這項上限無法提高。

視基礎通訊協定而定,系統會關閉要求連線,而不寫入回應代碼,或拒絕要求並傳回 HTTP 431 Request Header Fields Too Long 回應。

如果啟用記錄功能,系統會以 headers_too_long 的 statusDetails 記錄這些要求。

要求主體大小上限 16 KiB 這項上限無法提高。

如果要求的主體超過這項限制,系統會拒絕要求,並傳回 HTTP 413 Content Too Large 狀態碼。

回應標頭大小上限 約 128 KiB

如果來源回應的標頭超過這項限制,系統會將 HTTP 502 Bad Gateway 狀態碼傳送至用戶端。如果啟用記錄功能,系統會以 backend_response_headers_too_long 的 statusDetails 值記錄這些事件。

可快取的物件大小上限 100 GiB

這是 Media CDN 可快取的來源物件大小上限。系統會將較大的物件視為無法快取。

這項限制最多可提高至 1 TiB。如需調高上限,請與 Google 支援代表聯絡。

不可快取的回應大小上限 10239 MiB

當物件無法快取時,這是 Media CDN 代理的回應 (包括標頭) 最大位元組數。無法快取的回應達到上限後,系統會截斷回應。

標頭的小寫轉換 一律啟用 (適用於 Media CDN) Media CDN 遵循 HTTP/2 慣例,要求和回應標頭的大小寫。

無論使用哪種通訊協定,所有標頭都會轉換為小寫。

舉例來說,Host 會變成 host,Keep-Alive 則會變成 keep-alive。

標頭值的大小寫不會變更。

API 要求頻率限制

如果需要提高 API 要求的頻率限制,可以查看目前的使用情形並申請提高。

項目 限制
每EdgeCacheService的無效判定次數 每分鐘 10 次
每個專案中不屬於 networkservices 命名空間的所有呼叫 每分鐘 1,200 次呼叫
唯讀:GetEdgeCache*,每項專案 ListEdgeCache* 每分鐘 100 次
讀取/寫入:networkservices 命名空間中未標示為每個專案唯讀的所有內容 每分鐘 100 次

建議您一次提交一項更新要求,例如 create、patch 和 delete。雖然 API 會將多個同時提交的要求排入佇列,但系統會依序處理每個項目,因此同時提交這些要求可能會大幅增加延遲時間和處理時間。

用戶端逾時

逾時 時間長度上限 狀態碼 說明
Maximum request duration 5 分鐘 HTTP 408 Request Timeout 單一要求/回應的時間長度上限。
Header timeout 10 秒 HTTP 408 Request Timeout 用戶端必須在多久時間內傳送完整的要求標頭。

來源逾時

  • connectTimeout 和 maxAttemptsTimeout 會限制 Media CDN 尋找可用回應的時間。

    這兩項逾時時間都包含來源傳回標頭,以及判斷是否要使用容錯移轉或重新導向所需的時間。connectTimeout 會獨立套用至每次來源嘗試,而 maxAttemptsTimeout 則包含所有來源嘗試 (包括容錯移轉和重新導向) 所需的連線時間。追蹤重新導向會視為額外嘗試連線至來源,並計入為設定來源設定的 maxAttempts。

    當 Media CDN 遇到非重新導向回應 (例如來自重新導向或容錯移轉來源) 時,系統會套用 readTimeout 和 responseTimeout 值。重新導向的來源會使用為遇到重新導向的 EdgeCacheOrigin 設定的 connectTimeout、readTimeout 和 responseTimeout 值。

  • responseTimeout 和 readTimeout 可控制串流回應的時間長度。Media CDN 決定使用上游回應後,connectTimeout 和 maxAttemptsTimeout 都不重要。此時,readTimeout 和 responseTimeout 會生效。

無論每個 EdgeCacheOrigin 設定的 maxAttempts 為何,Media CDN 最多會嘗試連線至四個來源。Media CDN 會使用主要 EdgeCacheOrigin 的 maxAttemptsTimeout 值。每次嘗試的逾時值 (connectTimeout、readTimeout 和 responseTimeout) 是針對每次嘗試的 EdgeCacheOrigin 設定。

下表說明逾時欄位:

欄位 預設 說明
connectTimeout 5 秒

Media CDN 從開始向來源發出要求,到判斷回應是否可用,最多可花費的時間。實際上,connectTimeout 涵蓋的時間從建立要求開始,接著執行 DNS 查詢、TLS 握手、TCP/QUIC 連線建立,直到取得包含 HTTP 狀態碼的回應標頭。

逾時時間值必須介於 1 秒至 15 秒之間。

maxAttemptsTimeout 15 秒

所有來源 (包含容錯移轉來源) 連線嘗試的最長持續時間,超過此時間系統即會將錯誤傳回用戶端。如果未在逾時前收到回應,系統會傳回 HTTP 504 狀態碼。

逾時時間必須介於 1 秒至 30 秒之間。

這項設定定義了所有來源連線嘗試 (包括容錯移轉來源) 的總持續時間,以便限制用戶端等待內容開始串流的總時間。系統只會使用第一個 maxAttemptsTimeout 值,其中「第一個」是由指定路線設定的起點定義。

readTimeout 15 秒

單一 HTTP 回應讀取作業之間的等待時間上限。readTimeout上限為 responseTimeout。 所有 HTTP 回應讀取作業都必須在 responseTimeout 設定的期限前完成。逾時時間必須介於 1 秒至 30 秒之間。如果未在逾時前完成回應,系統會截斷並記錄回應。

responseTimeout 30 秒

完成回覆的時間上限。

逾時時間值必須介於 1 秒至 120 秒之間。

時間長度是從收到第一個內文位元組的時間開始計算。如果未在逾時前完成回應,系統會截斷並記錄回應。

管理配額

Media CDN 會基於多種原因,對資源用量實施配額限制。舉例來說,限制配額可以預防用量突然暴增的情況,進而保障 Google Cloud 使用者社群的權益。採用 Google Cloud 免費方案探索的使用者也能透過配額,確保不會超出試用範圍。

所有專案最初的配額均相同,您可以要求額外配額來變更配額數量。某些配額可能會依據您使用產品的狀況而自動增加。

權限

如要查看配額或要求增加配額,身分與存取權管理 (IAM) 主體需要具有下列其中一種角色。

工作 必要角色
查看專案的配額 下列任一項:
修改配額,要求額外配額 下列任一項:
  • 專案業主 (roles/owner)
  • 專案編輯器 (roles/editor)
  • 配額管理員 (roles/servicemanagement.quotaAdmin)
  • 具備 serviceusage.quotas.update 權限的自訂角色

查看配額

控制台

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

    前往「配額」頁面

  2. 使用篩選表格搜尋要更新的配額。 如果不知道配額名稱,請改用本頁面上的連結。

gcloud

請使用 Google Cloud CLI 執行下列指令,查看配額。使用您自己的專案 ID 替換 PROJECT_ID。

    gcloud compute project-info describe --project PROJECT_ID

如要查看特定區域的配額用量,請執行下列指令:

    gcloud compute regions describe example-region
    

超出配額時產生錯誤

一旦超出 gcloud 指令的配額上限,gcloud 就會輸出 quota exceeded 錯誤訊息並傳回結束代碼 1。

如果您是在傳送 API 要求時超出配額, Google Cloud 會傳回下列 HTTP 狀態碼:413 Request Entity Too Large。

要求增加配額

如要調整大部分配額,請使用 Google Cloud 控制台。詳情請參閱「要求配額調整」。

資源可用性

如果特定類型的資源可以使用,則每項配額代表您能針對該資源建立的最大數量。請特別留意,配額「並不」保證資源可用性。即使您有可用的配額,如果資源無法提供使用,您也無法建立新的資源。

舉例來說,您可能有足夠的配額,可以在特定區域中建立全新區域性外部 IP 位址。不過,如果該區域沒有可用的外部 IP 位址,則無法建立。區域的資源可用性也會影響您建立新資源的能力。

整個區域的資源皆無法提供使用的狀況很罕見。然而,可用區內的資源有時可能會耗盡,不過一般來說並不會對該資源類型的服務水準協議 (SLA) 造成影響。如需更多資訊,請參閱與該資源相關的 SLA。