スキーマ学習

Schema Learning は、選択したオペレーションの対象トラフィックを観測します。Schema Profile に対して、想定されるリクエストフィールドと制約を学習します。

Cloudflare は、学習済みプロファイルが利用可能になったあと 常時検出（always-on detection） を実行します。検出だけではリクエストを緩和しません。

結果を調べるには、プロファイル検出を分析する を参照してください。違反を緩和するには、Custom Rules でプロファイルを適用する を参照してください。

学習は週次で実行され、直近 7 日間の対象トラフィックを使います。2xx レスポンスを受け取ったリクエストだけが対象です。

フィールド学習のしきい値は、対象リクエスト 1,000 件です。境界学習のしきい値は、対象リクエスト 10,000 件です。

最初のプロファイルは、次の週次学習の実行後に表示されます。該当するしきい値を満たしてから最大 7 日かかることがあります。

サポートするリクエストコンポーネント、制約、制限については、Schema Profiles を参照してください。

エクスポートは、現在の学習済みプロファイルから別の OpenAPI ファイルを作成します。プロファイルとその検出は変わりません。

エクスポートしたスキーマには、servers セクションに記載したホスト名が含まれます。ホスト名、メソッド、パスごとのオペレーションも含まれます。

十分なトラフィックがあるオペレーションでは、次の内容も含まれます。

• 検出されたパス変数とフォーマット
• 検出されたクエリパラメーターとフォーマット
• application/json のコンテンツタイプに対する、検出された POST、PUT、PATCH の本文変数名とフォーマット

エクスポートしたスキーマには、API Shield のレート制限の推奨を任意で含められます。

固定の Schema Profile にする場合は、エクスポートしたファイルを Schema validation からアップロードします。