フェーズエントリーポイントルールセットにルールを追加する

A phase entry point ruleset には、そのフェーズで実行されるルールの順序付きリストが含まれています。エントリーポイントルールセットのルールは、別のルールセットを実行することができます。アカウントレベルおよびゾーンレベルで各フェーズのエントリーポイントルールセットを持つことができます。

フェーズエントリーポイントルールセットに1つ以上のルールを追加するには、Rulesets API の ruleset update operations のいずれかを使用します。エントリーポイントルールセットにルールを追加すると、存在しない場合はエントリーポイントルールセットが自動的に作成されます。このAPIメソッドでは、ルールセットに保持したいすべてのルールをリクエストに含める必要があります。そうしないと、ルールは削除されます。

単一のルールをルールセットに追加する場合は、rule creation operations のいずれかを使用することを検討してください。この場合、リクエストには新しいルールの定義のみが含まれます。

例: ゾーンレベルでのフェーズエントリーポイントルールセットのルールを設定する

次の例は、Update a zone ruleset 操作を使用して、http_request_firewall_managed フェーズのゾーンレベルでのフェーズエントリーポイントルールセットのルールを設定します。

curl --request PUT \
https://api.cloudflare.com/client/v4/zones/{zone_id}/phases/http_request_firewall_managed/entrypoint \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{
  "rules": [
    {
      "action": "execute",
      "action_parameters": {
        "id": "<MANAGED_RULESET_ID_1>"
      },
      "expression": "true"
    },
    {
      "action": "execute",
      "action_parameters": {
        "id": "<MANAGED_RULESET_ID_2>"
      },
      "expression": "true"
    }
  ]
}'

{
  "result": {
    "id": "<RULESET_ID>",
    "name": "Default",
    "description": "",
    "kind": "zone",
    "version": "1",
    "rules": [
      {
        "id": "<RULE_ID_1>",
        "version": "1",
        "action": "execute",
        "expression": "true",
        "action_parameters": {
          "id": "<MANAGED_RULESET_ID_1>"
        },
        "last_updated": "2021-06-17T15:42:37.917815Z"
      },
      {
        "id": "<RULE_ID_2>",
        "version": "1",
        "action": "execute",
        "expression": "true",
        "action_parameters": {
          "id": "<MANAGED_RULESET_ID_2>"
        },
        "last_updated": "2021-06-17T15:42:37.917815Z"
      }
    ],
    "last_updated": "2021-06-17T15:42:37.917815Z",
    "phase": "http_request_firewall_managed"
  },
  "success": true,
  "errors": [],
  "messages": []
}

例: ゾーンレベルでのフェーズエントリーポイントルールセットに単一のルールを追加する

次の例は、Create a zone ruleset rule 操作を使用して、ゾーンレベルでフェーズエントリーポイントルールセット（ID {ruleset_id}）に単一のルールを追加します。

curl https://api.cloudflare.com/client/v4/zone/{zone_id}/rulesets/{ruleset_id}/rules \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{
  "action": "execute",
  "action_parameters": {
    "id": "<MANAGED_RULESET_ID>"
  },
  "expression": "true"
}'

{
  "result": {
    "id": "<RULESET_ID>",
    "name": "Zone-level phase entry point ruleset",
    "description": "",
    "kind": "root",
    "version": "2",
    "rules": [
      {
        "id": "<EXISTING_RULE_ID>",
        "version": "1",
        "action": "execute",
        "expression": "true",
        "action_parameters": {
          "id": "<ANOTHER_MANAGED_RULESET_ID>"
        },
        "last_updated": "2021-03-17T15:42:37.917815Z"
      },
      {
        "id": "<NEW_RULE_ID>",
        "version": "1",
        "action": "execute",
        "expression": "true",
        "action_parameters": {
          "id": "<MANAGED_RULESET_ID>"
        },
        "last_updated": "2021-06-30T15:42:37.917815Z"
      }
    ],
    "last_updated": "2021-06-30T15:42:37.917815Z",
    "phase": "http_request_firewall_managed"
  },
  "success": true,
  "errors": [],
  "messages": []
}

Cloudflare Dashboard Discord Community Learning Center Support Portal

Cookie Settings