ページルール

ページルールでは、特定の条件を満たす URL を個別に処理できます。たとえば、静的アセットのキャッシュ期間を延ばしたり、管理エリアのキャッシュを無効にしたり、古いパスを新しいアドレスにリダイレクトしたりできます。

CDN → CDN ドメインに移動し、ドメインを開いて ページルールを選択します。コンソールの URL は /cdn/domains/<domain>/rules です。

#ルールの構成

#URL の一致条件

ページルールは、ファイアウォールルールと同じ条件エンジンを使用します。URL の指定には、次のフィールドと演算子がよく使用されます。

使用できる演算子は、等しい、等しくない、含む、含まない、前方一致、後方一致、正規表現、リストに含まれる、リストに含まれない、より大きい・小さい（以上・以下を含む）、存在する、存在しないです。

#有効なアクション

次の設定は、まだ有効になりません。代わりにドメイン自体の各ページで設定してください。

• キャッシュパネル: キャッシュ時間のモード、クエリ文字列の処理、キャッシュホストモード、デバイス・国・言語によるキャッシュの区別、古いコンテンツの配信。これらは キャッシュページで設定してください。
• ブラウザーキャッシュパネルは、まだ順次提供中です。ブラウザーキャッシュはキャッシュページで設定してください。
• 最適化パネル（Gzip、Brotli、最小化）。これらは 最適化ページで設定してください。

#ルールの作成

1. ページルールで ルールを追加をクリックします。
2. 名前を入力し、必要に応じて優先度を変更して、有効をオンのままにします。
3. 一致条件で条件を追加し、すべて一致またはいずれか一致を選択します。
4. 実行アクションで、使用する各アクションパネルの 有効化をクリックし、設定を入力します。パネルを削除するには、削除をクリックします。
5. OK をクリックして保存します。ルールは数秒から 1 分以内にエッジで有効になります。

条件とアクションがそれぞれ 1 つ以上ないと、ルールを保存できません。

#例: 静的アセットを 7 日間キャッシュする

• 条件: ファイル拡張子がリストに含まれる jpg, png, css, js
• アクション: キャッシュ、モードは有効、キャッシュ時間は 604800

#例: 管理エリアをキャッシュしない

• 条件: パスが前方一致 /admin
• アクション: キャッシュ、モードは無効

#複数のルールに一致する場合

1 つのリクエストが複数のページルールに一致することがあり、一致するすべてのルールのアクションがまとめて適用されます。リダイレクトまたは HTTPS の強制は処理を即座に終了するため、それ以降のルールは実行されません。

#ルールのクォータ

プランによっては、作成できるページルール数に上限があります。上限がある場合、ページ上部のバナーに「ルール利用枠：3/5」などの使用状況が表示されます。上限に達したら、不要なルールを削除するか、プランをアップグレードしてください。

#API

ページルールのエンドポイントは /api/user/cdn/rules の配下にあります。

curl -X POST "https://api.yeap.cloud/api/user/cdn/rules/create" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "domain_id": 123,
    "name": "Static assets 7d",
    "priority": 100,
    "enabled": true,
    "settings": {
      "matcher": {"op": "and", "conditions": [
        {"collection": "EXTENSION", "op": "in", "var": ["jpg", "png", "css", "js"]}
      ]},
      "action": {"cache": {"enabled": "on", "ttl": 604800}}
    }
  }'

その他のエンドポイント:

• ルールの一覧取得: GET /api/user/cdn/rules?domain_id=123
• ルールの更新: POST /api/user/cdn/rules/update。ボディに id を指定します
• ルールの削除: DELETE /api/user/cdn/rules/delete?id=<id>

#関連項目

• WAF とセキュリティ
• キャッシュとパージ
• SSL/TLS