制限
以下の値はすべて Edge が実際に適用しているものです。特定のステータスコードを返すものは、その旨を記載しています。
このページに記載しているのは Edge が明示的に検査している制限です。ここにないことは、無制限であることの保証ではありません。提示できる確定値がない、という意味です。
distribution と slug
| 項目 | 値 |
|---|---|
| 予約済み slug | mcp、api、www、preview、ip — 常に使用不可 |
| slug の照合 | 前後の空白を除去し小文字化してから比較するため、Acme と acme は同一 |
slug はグローバルに一意なホスト名ラベルです。作成前に GET /v1/slugs/{slug} で空きを確認できますが、確認しても予約はされないため、確認から作成までの間に取得される可能性があります。その競合に負けた作成は 409 を返します。
ドメイン
| 項目 | 値 | 超過時 |
|---|---|---|
| distribution あたりのドメイン数 | 10 | 割り当てが失敗 |
| ワークスペースあたりのドメイン作成数 | 1 時間に 10 件 | 429 |
作成の制限はワークスペース単位で、直近 1 時間のローリング集計です。distribution 単位でも暦時間単位でもありません。まとめて登録する場合はペースを調整してください。ループで再試行しても早くはなりません。
deployment 内のファイル
| 項目 | 値 | 超えたとき |
|---|---|---|
| ファイルごとのインライン書き込み | 100,000 バイト | その項目の error は object exceeds 100000 bytes。同じ呼び出しの他の項目は書き込まれることがある。 |
| 1 回の呼び出しで書き込むコンテンツ | 2,000,000 バイト | 入りきらなかった各項目の error は call total exceeds 2000000 bytes。その呼び出しで既に書き込まれた項目はそのまま残る。 |
| アップロード URL の有効期限 | 3,600 秒 | PUT は拒否される。新しい URL を得るには deployment を開き直す。 |
| 1 回のバンドル PUT | 5,368,709,120 バイト(5 GiB) | S3 が PUT を拒否する。URL は単一の PutObject で、マルチパートアップロードはない。 |
呼び出し自体は成功する。results の各項目を読む。status は written または error。
上の 2 つのインライン上限は edge_content_write と PUT /v1/deployments/{id}/content に適用される。アップロードした bundle.tar.gz の中のファイルには適用されない。
2,000,000 バイトを超える単一ファイルは、先に実行される呼び出し合計の検査で call total exceeds を返す。そのファイルはファイルごとの上限も超えている。インラインでは書けない。
edge_deployment_create(または POST /v1/distributions/{id}/deployments)が返す upload_url は、署名付きの S3 PUT です。ファイルのバイト列は S3 に届きます。MCP サーバーも HTTP API も経由しないので、それらの前段にあるファイアウォールはこのアップロードを見ません。インライン上限もこの PUT には適用されません。返された URL に gzip アーカイブをそのまま PUT します。Content-Type も暗号化ヘッダーも付けません。
5 GiB の単一 PUT 上限より下に、アプリケーション側のバイト上限はありません。commit はアーカイブ全体をメモリに読み込むので、S3 が受け取ったオブジェクトでも、アーカイブが非常に大きいと commit で失敗することがあります。
from_deployment を付けて開いた deployment は、アップロードされたバンドルを読みません。ワーカーは前の deployment をコピーし、インラインの書き込みをその上に適用します。コンテンツをアップロードする を参照してください。
リダイレクト
| 項目 | 値 | 超えたとき |
|---|---|---|
| distribution あたりの完全一致ルール | 5,000 | 422 |
distribution あたりのパターン(*)ルール | 100 | 422 |
パーセントエンコード後の from パス | 493 バイト | 422 |
to の転送先 | 900 バイト | 422 |
redirect_hosts のホスト数 | 20 | 422 |
| ループ検査で確認するリダイレクトの回数 | 10 | 10 回以内に終わらないチェーンはループとして拒否される |
| インポートのソース | 1 MiB | 422。ファイルを分割する |
リダイレクト表は、エッジのストレージを他のすべての distribution と共有しています。収まらないインポートは、必要なバイト数と残りのバイト数を報告します。リダイレクト を参照してください。
予約した promote と公開停止
| 項目 | 値 |
|---|---|
最も早い at | 現在から 60 秒後 |
最も遅い at | 現在から 366 日後 |
| distribution あたりの未実行の予約 | 20 |
| distribution あたり 1 分間に作れる予約 | 1 |
| 精度 | at から約 1 分以内に実行 |
| 遅れた予約 | Edge が 24 時間以上遅れて到達した場合は実行せず、failed になる |
アナリティクス
| 項目 | 値 |
|---|---|
| データ保持期間 | 91 日 |
| イベントごとのカスタムプロパティ | 2,048 バイト |
| Explore のパスの深さ | 4 列 |
クエリでは last_91_days や all_time まで指定できます。保持期間より前についてはエラーではなく、返すデータがないだけです。
リクエストログ
| 項目 | 値 |
|---|---|
| 直近ログの保持期間 | 7 日 |
| それ以前のログ | まだ照会できない |
直近 7 日のログはホットストアから配信され、最新の状態です。その範囲より前から始まる期間を要求すると 503 が返ります。Edge は不完全な範囲を黙って返すことはありません。
リクエストログにはクライアントの IP アドレスと国が含まれます。クエリ文字列、cookie、リクエストボディは含まれません。
キャッシュ
| 項目 | 値 |
|---|---|
| キャッシュ TTL の範囲 | 0〜3,600 秒 |
範囲外の TTL は丸められるのではなく 422 として拒否されます。
エンドポイント
これらは distribution 上の /_api、/_collect、/_submit と関連パスに適用されます。
| 項目 | 値 |
|---|---|
| distribution あたりのプロキシエンドポイント | 100 |
| distribution あたりの暗号化済みプロキシ資格情報 | 5 |
| distribution あたりのデータオブジェクト | 1,000 |
| データオブジェクトのキーの深さ | 8 階層 |
| データオブジェクトのキー長 | 256 文字 |
| collect のリクエストボディ | 256 KiB |
| submit のリクエストボディ | 256 KiB |
| API のリクエストボディ | 1 MiB |
| プロキシのタイムアウト | 10 秒 |
| API の既定キャッシュ TTL | 60 秒 |
| セッション Cookie の有効期間 | 24 時間 |
distribution ごとのレート制限は次のとおりです。
| パス | 制限 |
|---|---|
| Collect | 毎分 60 リクエスト |
| Submit | 毎分 30 リクエスト |
| API の読み取り | 毎分 120 リクエスト |
| API の書き込み | 毎分 30 リクエスト |
いずれも超過すると 429 が返ります。
関数ランタイム
| 項目 | 値 |
|---|---|
| 関数ランタイムあたりのソース | 256 KiB |
| コンパイル済み WebAssembly 成果物 | 32 MiB |
| ネイティブの事前コンパイル済みモジュール | 96 MiB |
| 呼び出しあたりの fuel | 10,000,000 |
| メモリ | 64 MiB |
| ゲストのデッドライン | 5 秒 |
| ビルドのタイムアウト | 180 秒 |
| リクエストボディ、またはテキストのレスポンスボディ | 1 MiB |
| バイナリのレスポンスボディ(デコード後) | 4 MiB |
| キャプチャする stdout と stderr | ストリームあたり 8 KiB |
edge_function_get が返すビルドログ | 32 KiB |
| ログの保持期間 | 7 日 |
| 呼び出しあたりのホスト呼び出し(データオブジェクト・キーバリュー・SQL の合計) | 8 |
env.document.list 1 ページあたりのキー数 | 50 |
| distribution あたりのプレフィックス付与 | 32 |
| 1 つの sidecar 付与に列挙できる script 数 | 32 |
env.file 1 回の呼び出しのバイト数(put、get、read、append) | 4 MiB |
create / append / commit で書く 1 ファイル | 5 GiB |
| 呼び出しあたりに書き込み、読み込みできるファイルのバイト数 | 512 MiB(バックグラウンドルートでは 5 GiB) |
| distribution あたりのファイルのプレフィックス付与 | 32 |
| distribution あたりの関数ファイル | 50 GiB、100,000 ファイル |
env.file.link の有効期間 | 60〜3,600 秒 |
file ルートが直接配信するファイル | 4 MiB(それより大きいとリダイレクト) |
| バックグラウンド実行 | 300 秒、燃料 30 倍、メモリー 256 MiB |
| バックグラウンドのリクエストボディ | 192 KiB |
| distribution あたりの同時バックグラウンド実行 | 5 |
| バックグラウンドの結果の保持 | 7 日、1 MiB |
バックグラウンドジョブ
バックグラウンドジョブ として実行される関数ランタイムは、上の上限ではなくバックグラウンドランナーの上限で動きます。
| 上限 | 値 |
|---|---|
| ゲストのデッドライン | 既定 300 秒。background_timeout_seconds で 1〜840 秒に設定 |
| fuel | デッドラインに比例 |
| メモリ | 256 MiB |
| 外向き HTTPS 呼び出し | 1 回の実行あたり 100 回、各 15 秒、レスポンス 2 MiB |
| キャプチャする stdout と stderr | ストリームあたり 64 KiB |
| 組織あたりの同時実行ジョブ数 | 4 |
| ジョブ実行履歴の保持期間 | 30 日 |
Cron
| 上限 | 値 |
|---|---|
| distribution あたりの cron 数 | 20 |
| 最短の間隔 | 1 分。Edge は毎分確認します |
| 失敗した実行の再試行 | 0〜3 回(30 秒、2 分、10 分の間隔) |
| 遅れた実行 | 24 時間を超えて遅れて到達した実行は missed として記録し、実行しません |
| 取りこぼした実行時刻 | 追いついたときに 1 回だけ実行し、時刻ごとには実行しません |
キュー
| 上限 | 値 |
|---|---|
| distribution あたりのキュー数 | 10 |
| メッセージ本文 | JSON で 128 KiB |
| 1 回の送信のメッセージ数 | 100。合計 1 MiB まで |
| キューあたりの待機中とバッチ処理中のメッセージ | 100,000。超える送信は queue_full で失敗します |
| distribution あたりの送信速度 | 毎秒 100 件、瞬間的には 1,000 件まで。超えると rate_limited |
delay_seconds | 0〜604,800(7 日) |
| バッチサイズ | 1〜100 件(既定 10)、本文の合計 1 MiB まで |
batch_wait_seconds | 0〜60(既定 5) |
| キューあたりの同時バッチ数 | 1〜10(既定 2) |
max_attempts | 1〜10(既定 3) |
| 待機中メッセージの保持 | retention_days で 1〜14 日(既定 4)。過ぎると expired として dead になります |
| dead メッセージの保持 | 14 日 |
| Webhook コンシューマーのタイムアウト | バッチごとに 30 秒 |
| 再試行の間隔 | min(2^attempt × 10 秒, 1 時間) ± 20 %、またはコンシューマーが返した delay_seconds |
idempotency_key | 128 文字まで。メッセージがキューにある間、重複を防ぎます |
1 回の呼び出しで env.queue が送れるメッセージ | 訪問者のリクエストで 10 件、バックグラウンドジョブで 100 件 |
ワークフロー
| 上限 | 値 |
|---|---|
| distribution あたりの実行中・sleep 中・待機中の実行 | 1,000。超える開始は limit_reached で失敗します |
| 実行あたりのステップ数 | 200 |
| 実行の寿命 | 90 日。過ぎると expired で失敗します |
| ステップの入力・出力・シグナルのペイロード | それぞれ JSON で 256 KiB |
sleep と wait | それぞれ最大 30 日 |
| ステップごとの再試行 | 0〜5 回(既定 2)、間隔は min(2^attempt × 5 秒, 10 分) ± 20 % |
| 実行が待つ前に保持するシグナル | 10 |
edge_workflow_get のステップ履歴 | ジョブ実行として 30 日保持 |
1 回の呼び出しでの env.workflow の呼び出し | 訪問者のリクエストで 10 回、バックグラウンドジョブで 50 回 |
1 つの関数の workflow_starts に入れられるスクリプト | 50 件、または ["*"] |
キーバリューと SQL
| 項目 | 値 |
|---|---|
| キーバリューの値のサイズ | 64 KiB |
| distribution あたりのキーバリューのキー数 | 10,000 |
| キーバリューのキーの長さと深さ | 256 文字、8 セグメント |
env.kv.getMany 1 回あたりのキー数 | 25 |
env.kv.list 1 ページあたりのキー数 | 100(既定 50) |
キーバリューの有効期限(ttl) | 60 秒から 1 年 |
| SQL の文のテキスト | 64 KiB |
| 文あたりの SQL パラメーター | 100 |
env.sql.batch あたりの SQL 文 | 20 |
| 1 回あたりに返す SQL の行数 | 1,000 |
| 1 回あたりの SQL の結果 | 1 MiB |
| SQL データベースのサイズ | 100 MiB |
関数からキーバリューと SQL ストレージを使う を参照してください。
ソースは自己完結している必要があります。ビルド時に Edge は npm や pip の依存関係を解決しません。依存関係は提出するソースにまとめてください。関数ランタイム と エンドポイントを追加する を参照してください。
データオブジェクト、プロキシ、関数ランタイムのマッピング規則は エンドポイント にあります。
フォームのアップロード
| 項目 | 値 | 超えた場合 |
|---|---|---|
| distribution あたりのアップロード付きフォーム | 20 | 422 |
| フォームあたりのアップロードフィールド | 10 | 422 |
フィールドあたりのファイル数(max_files) | 1〜10 | 422 |
1 ファイル(max_bytes) | 1 バイト〜5 GiB。既定は 100 MiB | チケットが 400 invalid_upload、reason は size |
| 1 回の送信 | 合計 10 ファイル、10 GiB | 422 |
| ファイル名 | 255 文字 | チケットが 400 invalid_upload、reason は name |
| 1 リクエストでのアップロード | 100 MiB まで。それより大きいファイルは 16 MiB のパート | — |
| 1 回の呼び出しで返すパート URL | 100 | /parts で追加を要求 |
| single のチケットの有効期間 | 10 分 | ストレージが POST を拒否 |
| パート URL の有効期間 | 1 時間 | ストレージが PUT を拒否 |
| IP アドレスあたりのチケット | 1 分に 20 | 429 rate_limited |
| 訪問者セッションあたりのチケット | 1 日に 50 | 429 rate_limited |
| 組織あたりのアップロード | 1 か月に 100 GiB、50,000 ファイル | 403 quota_exceeded |
| 添付されなかったアップロード | 1 日後に削除 | — |
| 抽出テキスト | 200 MiB までの PDF、Word、テキスト、CSV から最大 1 MiB | テキストなし。has_text は false |
エンドポイント を参照してください。
関数で受け付ける訪問者のアップロード
関数が env.upload で署名するアップロードに適用されます。
| 項目 | 値 | 超えた場合 |
|---|---|---|
| 1 ファイル | 1 バイト〜5 GiB | too_large |
| 1 リクエストでのアップロード | 100 MiB まで。それより大きいファイルは 16 MiB のパート | — |
sign または parts 1 回で返すパート URL | 100 | parts で追加を要求 |
| single のチケットの有効期間 | 10 分 | ストレージが POST を拒否 |
| パート URL の有効期間 | 1 時間 | ストレージが PUT を拒否 |
env.upload.read 1 回の呼び出しのバイト数 | 4 MiB | too_large |
sign、parts、complete、status、keep | env.document、env.file と共通の「呼び出しあたり 8 回」のホスト呼び出し | budget_exhausted |
| 組織あたりのアップロード | 1 か月に 100 GiB、50,000 ファイル。フォームのアップロードと共通 | quota_exceeded |
| 保存(keep)されなかったアップロード | 1 日後に削除 | — |
関数ランタイム を参照してください。
フォームの送信内容
送信内容とそのファイルの読み取りに適用されます。
| 項目 | 値 |
|---|---|
| 一覧の 1 ページあたりの送信内容 | 50 |
| 一覧の既定の期間 | 直近 30 日 |
| 一覧のプレビュー | 200 文字 |
| 抽出テキストの 1 ページ | 100,000 文字 |
インラインで返すファイル(content) | 10 MiB までの画像と PDF |
エージェント用のダウンロードリンク(link) | 15 分 |
| ダウンロードのリダイレクト先 | 60 秒 |
Webhook の download_url | イベントから 7 日 |
| 1 日の送信内容の読み取り | 1,000 回。エージェントは人ごと、パーソナルアクセストークンはトークンごと |
| 1 日のファイルの読み取り | 200 回。エージェントは人ごと、パーソナルアクセストークンはトークンごと |
| 1 日のリセット | 00:00 UTC |
| 1 回で返すアクセスログのエントリー | 100、新しい順 |
| アクセスログの保存期間 | 365 日 |
1 日の上限を超えると、リセットまで読み取りは 429 rate_limited を返します。自分のサインインで読む人には上限がありません。フォームの送信内容をエージェントに読ませる を参照してください。
Webhook とフック
| 項目 | 値 |
|---|---|
| ワークスペースあたりの Webhook サブスクリプション | 25 |
| サブスクリプションあたりのイベントパターン | 32 |
| 配信のタイムアウト | 試行あたり 10 秒 |
| 配信の試行回数 | 9 回、約 22.7 時間にわたる |
| サブスクリプションが無効になる条件 | 10 回連続の配信失敗、または 410 Gone 1 回 |
| ローテーション後に旧シークレットが有効な期間 | 24 時間 |
| イベント、配信、試行の履歴 | 30 日 |
| distribution あたりのフック数 | 20 |
| フックのリクエストボディ | 256 KB(413) |
| 冪等キー | 255 文字(400) |
| フックの受信記録 | 7 日 |
| フックのレート | クライアント IP ごとに 5 分あたり 600 リクエスト |
invalidate アクションあたりのキャッシュパス | 15 |
イベント、Webhook、フック を参照してください。
訪問者アクセス
| 制限 | 値 |
|---|---|
| セッションの長さ | 1 時間から 24 時間。既定は 8 時間 |
| distribution あたりのアクセスルール | 200 |
| ワークスペースあたりのアクセスルール | 500 |
| distribution あたりの有効なサインアウト | 1,000 |
| サインイン完了コード | 30 秒、1 回限り |
アクセス制御 を参照してください。
ネットワークルール
| 制限 | 値 |
|---|---|
| distribution あたりのネットワークルール | 200 |
| ワークスペースあたりのネットワークルール | 200 |
| 1 回の要求あたりのルール | 200 |
| 自分とワークスペースのルールをまとめたあとの、distribution あたりの IP 範囲 | 250 |
| 最も広い範囲 | IPv4 は /8、IPv6 は /16 |
| メモ | 200 文字 |
重なる範囲と隣り合う範囲は、250 を数える前にまとめられます。192.0.2.0/25 と 192.0.2.128/25 は 1 つと数えます。制限を超えると 409 NETWORK_RULE_LIMIT になり、その要求のルールは 1 つも追加されません。アクセス制御 を参照してください。
パーソナルアクセストークン
| 制限 | 値 |
|---|---|
| 1 人あたり、組織あたりの有効なトークン | 50 |
| 1 人あたり 1 時間に作成できるトークン | 20 |
| 名前の長さ | 64 文字 |
| 無期限 以外の最長の有効期限 | 365 日 |
| 既定の有効期限 | 30 日 |
取り消し済みや期限切れのトークンは、有効なトークンの上限に数えません。
ストリーミング
アナリティクスとログのストリームは、永続的な接続ではなく寿命の長い HTTP レスポンスです。ログのストリームは 150 回のポーリングのあと閉じ、クライアント側の再接続を前提としています。ストリームの終了はエラーではなく通常の動作として扱い、再接続してください。
あわせて読む
- コンテンツをアップロードする — インライン書き込みとバンドル、どちらのエラーがどちらか
- エラー — これらの制限が返すステータスコード
- エンドポイント
- distribution のタイプ
- 権限スコープ
- HTTP API