割り当てと上限

このドキュメントでは、Media CDN に適用される割り当てと上限の一覧を示します。

割り当ては、Cloud プロジェクトで使用できる特定の共有 Google Cloud リソース(ハードウェア、ソフトウェア、ネットワーク コンポーネントなど)の量を制限します。

割り当てはシステムの一部で、次の機能があります。

  • Google Cloud のプロダクトとサービスの使用量や消費量をモニタリングする。
  • 公平性の確保や使用量急増の抑制などのため、これらのリソースの消費量を制限する。
  • 規定の制限を自動的に適用する構成を維持する。
  • 割り当ての変更を実施またはリクエストする手段を提供する。

割り当てを超過すると、ほとんどの場合、システムは関連する Google リソースへのアクセスをすぐにブロックするため、ユーザーが試行しているタスクは失敗します。ほとんどの場合、割り当ては各 Cloud プロジェクトに適用され、その Cloud プロジェクトを使用するすべてのアプリケーションと IP アドレスで共有されます。

Media CDN リソースには上限もあります。これらの上限は、割り当てシステムとは無関係です。上限は、特に明記されていない限り、変更できません。

制限事項

構成

項目 制限事項 メモ
EdgeCacheService の最大数 1 プロジェクトあたり 20 件 この上限を引き上げる必要がある場合は、Google Cloud セールスチームにお問い合わせください。
EdgeCacheOrigin の最大数 1 プロジェクトあたり 30 件 この上限を引き上げる必要がある場合は、Google Cloud セールスチームにお問い合わせください。
EdgeCacheKeyset の最大数 1 プロジェクトあたり 10 件 この上限を引き上げる必要がある場合は、Google Cloud セールスチームにお問い合わせください。
EdgeCacheService ごとの RouteRules の最大数 640

EdgeCacheService は最大 10 個の PathMatchers を定義し、各 PathMatcher は最大 64 個の RouteRules を定義できます。

この上限を引き上げることはできません。

サービスごとの最大 SSL 証明書 5 この上限を引き上げることはできません。SSL 証明書については、プロジェクトごとの割り当てもご覧ください。
EdgeCacheKeyset ごとの公開鍵の最大数 3 この上限を引き上げることはできません。鍵セット内の複数の鍵は、鍵のローテーションを有効にするように設計されています。時間の経過とともに、古い鍵と未使用の鍵を削除する必要があります。
EdgeCacheKeyset ごとの検証共有鍵の最大数 3 この上限を引き上げることはできません。鍵セット内の複数の鍵は、鍵のローテーションを有効にするように設計されています。時間の経過とともに、古い鍵と未使用の鍵を削除する必要があります。

HTTP ヘッダー、リクエスト、レスポンス

項目 制限事項 メモ
リクエスト ヘッダーの最大サイズ 約 11 KiB この上限を引き上げることはできません。

リクエスト URL とリクエスト ヘッダーの合計サイズは 15 KiB に制限されています。

リクエストは、HTTP/1.1 接続に対して HTTP 431 レスポンスで拒否されます。

レスポンス コードが書き込まれずに、HTTP/2 接続が閉じられます。

ロギングが有効になっている場合、これらのリクエストは statusDetailsheaders_too_long でログに記録されます。

レスポンス ヘッダーの最大サイズ 約 128 KiB この上限を引き上げることはできません。

この制限を超えるヘッダーを含む送信元レスポンスは、HTTP 502 がクライアントに送信されます。ロギングが有効になっている場合、これらは statusDetailsbackend_response_headers_too_long でログに記録されます。

キャッシュ エントリの最大サイズ 50GiB この上限を引き上げることはできません。

これは、単一のキャッシュ可能なレスポンスの最大サイズです。たとえば、単一のファイルなどです。

Content-Length がこの上限を超えるレスポンスや、この上限を超えるチャンク レスポンスはキャッシュに保存されません。HTTP 413(Request Entity Too Large)がクライアントに返されます。

ヘッダーの小文字変換 常に、メディア CDN 用 Media CDN は、リクエスト ヘッダーとレスポンス ヘッダーの大文字と小文字について、HTTP/2 の規則に従います。

使用されるプロトコルに関係なく、すべてのヘッダーは小文字に変換されます。

たとえば、Hosthost に、Keep-Alivekeep-alive になります。

ヘッダー値の大文字と小文字は変更されません。

API リクエストのレート制限

API リクエストのレート制限を引き上げる必要がある場合は、現在の使用状況を確認して引き上げをリクエストできます。

項目 制限事項
networkservices 名前空間にない呼び出しのすべて 1 プロジェクトあたり毎分 1,200 回の呼び出し
読み取りのみ: GetEdgeCache*ListEdgeCache* 1 プロジェクトあたり毎分 100 回
読み取り/書き込み: networkservices 名前空間内のすべてのリソースが読み取り専用としてマークされていない 1 プロジェクトあたり毎分 100 回

クライアント タイムアウト

タイムアウト 最大期間 レスポンス コード 説明
Maximum request duration 5 分 HTTP 408 (Request Timeout) 1 回のリクエスト/レスポンスの最大期間。
Header timeout 10 秒 HTTP 408 (Request Timeout) クライアントがすべてのリクエスト ヘッダーを送信する必要がある時間。

送信元のタイムアウト

  • connectTimeoutmaxAttemptsTimeout は、メディア CDN が使用可能なレスポンスを見つけるまでの時間を制限します。

    どちらのタイムアウトにも、送信元がヘッダーを返し、フェイルオーバーとリダイレクトのどちらを使用するかを決定するのにかかる時間が含まれます。connectTimeout は、送信元の試行ごとに独立して適用されますが、maxAttemptsTimeout には、フェイルオーバーとリダイレクトを含むすべての送信元の試行に接続するために必要な時間が含まれます。リダイレクトは、送信元への接続追加試行としてカウントされ、構成された送信元に設定された maxAttempts に対してカウントされます。

    Media CDN がリダイレクトやフェイルオーバーなどによるリダイレクト以外のレスポンスを検出した場合は、readTimeoutresponseTimeout の値が適用されます。リダイレクトされた送信元では、リダイレクトが発生した EdgeCacheOrigin 用に構成された connectTimeoutreadTimeoutresponseTimeout の値が使用されます。

  • responseTimeoutreadTimeout は、ストリーミングされたレスポンスにかかる時間を制御します。Media CDN がアップストリーム レスポンスを使用すると判断した場合、connectTimeoutmaxAttemptsTimeout のいずれも処理しません。この時点で、readTimeoutresponseTimeout が有効になります。

Media CDN は、各 EdgeCacheOrigin によって設定された maxAttempts に関係なく、すべての送信元で最大 4 回の送信元を試みます。メディア CDN は、プライマリ EdgeCacheOriginmaxAttemptsTimeout 値を使用します。試行ごとのタイムアウト値(connectTimeoutreadTimeoutresponseTimeout)は、試行ごとに EdgeCacheOrigin に対して構成されます。

次の表に、タイムアウト フィールドを示します。

フィールド デフォルト 説明
connectTimeout 5 秒

Media CDN がリクエストを開始してから送信元が使用可能になるまでの最大時間。この時間が経過するとMedia CDN はレスポンスが使用可能かどうかを判断します。実際には、connectTimeout はリクエストの作成から DNS ルックアップの実行、TLS handshake、TCP/QUIC 接続の確立、さらには HTTP ステータス コードまでカバーします。

タイムアウトは 1 秒~ 15 秒の値にする必要があります。

maxAttemptsTimeout 15 秒

送信元に対するすべての接続試行の最大時間。この時間を超えるとクライアントにエラーを返します。これにはフェイルオーバー送信元に対する接続も含まれます。レスポンスが返される前にタイムアウトに達した場合は、HTTP 504 が返されます。

タイムアウトは 1 秒~ 30 秒の値にする必要があります。

この設定は、すべての送信元の接続試行(フェイルオーバー送信元を含む)の合計時間を定義します。これは、クライアントがコンテンツのストリーミング開始を待機する合計時間の上限を設定するためです。最初の maxAttemptsTimeout 値のみが使用されます。ここで、最初のは、指定されたルート用に構成された送信元によって定義されます。

readTimeout 15 秒

1 回の HTTP レスポンスの読み取り間の最大待機時間。readTimeoutresponseTimeout によって制限されます。HTTP レスポンスの読み取りはすべて、responseTimeout によって設定された期限までに完了する必要があります。タイムアウトは 1 秒~ 30 秒の値にする必要があります。レスポンスが完了する前にこのタイムアウトに達すると、レスポンスは切り捨てられ、ログに記録されます。

responseTimeout 30 秒

レスポンスを完了できる最大時間。

タイムアウトは 1 秒から 120 秒までの値にする必要があります。

この期間は、最初の本文バイトが受信された時点から測定されます。レスポンスが完了する前にこのタイムアウトに達すると、レスポンスは切り捨てられ、ログに記録されます。

割り当てを管理

Media CDN では、さまざまな理由から、使用できるリソースの割り当て量に上限が設けられています。たとえば、割り当て量の上限を設定して予期しない使用量の急増を防ぐことで、Google Cloud ユーザーのコミュニティを保護しています。割り当て量は、無料枠で Google Cloud を試しているユーザーをトライアルに留めておくのにも役立ちます。

すべてのプロジェクトは同じ割り当て量で開始しますが、追加の割り当て量をリクエストすることで変更できます。割り当てによっては、プロダクトの使用状況に応じて自動的に増加される場合もあります。

権限

Identity and Access Management(IAM)のプリンシパルが割り当ての表示や、割り当ての増加のリクエストをするには、以下のいずれかのロールが必要です。

タスク 必要なロール
プロジェクトの割り当て量をチェックする 次のいずれかが必要です。
割り当て量の変更、割り当て量の追加のリクエストを行う 次のいずれかが必要です。
  • プロジェクト オーナーroles/owner
  • プロジェクト編集者roles/editor
  • 割り当て管理者roles/servicemanagement.quotaAdmin
  • serviceusage.quotas.update 権限のあるカスタムロール

割り当て量を確認する

コンソール

  1. Google Cloud コンソールで [割り当て] ページに移動します。

    [割り当て] に移動

  2. 更新する割り当てを検索するには、[表をフィルタリング] を使用します。割り当ての名前がわからない場合は、このページにあるリンクを使用します。

gcloud

Google Cloud CLI で次のコマンドを実行して、割り当てを確認します。PROJECT_ID は、実際のプロジェクト ID に置き換えます。

      gcloud compute project-info describe --project PROJECT_ID

ある特定のリージョンで使用済みの割り当て量を確認するには、次のコマンドを実行します。

    gcloud compute regions describe example-region
    

割り当て量を超えたときのエラー

gcloud コマンドで割り当て量を超えた場合、gcloudquota exceeded エラー メッセージを出力し、終了コード 1 を返します。

API リクエストで割り当て量を超えた場合、Google Cloud は HTTP ステータス コード 413 Request Entity Too Large を返します。

追加の割り当てをリクエスト

ほどんどの場合、割り当ての増減を行うには Google Cloud コンソールを使用します。詳細については、割り当ての増加をリクエストするをご覧ください。

コンソール

  1. Google Cloud コンソールで [割り当て] ページに移動します。

    [割り当て] に移動

  2. [割り当て] ページで、変更する割り当てを選択します。
  3. ページの上部にある [割り当てを編集] をクリックします。
  4. [名前] に氏名を入力します。
  5. 省略可: [電話] に電話番号を入力します。
  6. リクエストを送信します。割り当てのリクエストが処理されるまでに、24~48 時間かかります。

リソースの可用性

各割り当て量は、リソースが利用可能な場合に作成できる特定のリソースタイプの最大数を表します。割り当てではリソースの可用性が保証されないことに注意してください。割り当て量が使用可能でも、新しいリソースを使用できなければ、そのリソースを作成することはできません。

たとえば、us-central1 リージョンで新しいリージョンの外部 IP アドレスを作成するための割り当て量が十分にあっても、そのリージョンに使用可能な外部 IP アドレスがない場合、外部 IP アドレスは作成できません。ゾーンリソースの可用性は、新しいリソースを作成できるかにも影響を及ぼす可能性があります。

リージョン全体でリソースを使用できない状況はまれです。ただし、ゾーン内のリソースが使い果たされることはあります。通常、そのリソースタイプのサービスレベル契約(SLA)に影響はありません。詳細については、リソースに関連する SLA をご覧ください。