Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

制限

最終更新 Markdown で表示Agent セットアップ

Cloudflare GraphQL API は、70 を超えるデータセットを公開しています。各データセットは 製品を表し、ゾーンとアカウントのプランごとに設定とデータの可用性が異なります。

この多様性に対応するため、Cloudflare GraphQL API には 3 層の制限があります。

  • グローバル制限
  • ユーザー制限
  • ノード(データセット)制限

グローバル制限

次の制限は、すべてのプランのすべてのクエリに適用されます。

  • ゾーンスコープのクエリに含められるゾーンは最大 10 件 です
  • アカウントスコープのクエリに含められるアカウントは 1 件 のみです

加えて、1 リクエストあたりのクエリ数にも上限があります。リクエスト内のクエリ総数は、ゾーン / アカウントスコープの数に、適用先ノードの数を掛けた値です。

ユーザー制限

Cloudflare GraphQL API は、ユーザーごとに送信できる GraphQL リクエスト数を制限します。 デフォルトのクォータは 5 分間あたり 300 GraphQL クエリ です。少なくとも 1 秒に 1 クエリ を実行するか、300 クエリをまとめて実行したあと、次のクエリまで 5 分待つことができます。

このレート制限は、Cloudflare API が適用する一般的なレート制限 に加えて適用されます。

アカウントベースのレート制限

多数のゾーンまたはアカウントをまたいで分析をクエリする場合は、 アカウントベースのレート制限 を選べます。制限はユーザーや API トークンではなく、 アカウント単位およびゾーン単位で適用されます。アカウントとゾーンごとに独立した 予算があるため、1 人のユーザーまたは 1 つのトークンで、全体としてより多くの リクエストを送れます。制限の引き上げもリソース単位で適用でき、すぐに反映されます。

有効化の方法とクエリ要件は、 アカウントベースのレート制限 を参照してください。

ノード制限と可用性

各データノードには、次のような制限があります。

  • データをどこまで遡ってリクエストできるか
  • 1 クエリでリクエストできる最大期間(秒)
  • 1 クエリでリクエストできるフィールド数の上限
  • 1 クエリで返せるレコード数の上限

ノード制限は、リクエストした zoneTag または accountTag に紐づきます。上位プランでは、 より多くのデータセットやフィールドを使え、より長い履歴期間をクエリできます。

ゾーンまたはアカウントの正確な境界と可用性は、settings を参照してください。

役に立ちましたか?