Cloudflare API | DNS Firewall › Create DNS Firewall Cluster

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/dns_firewall \
    -H 'Content-Type: application/json' \
    -H "X-Auth-Email: $CLOUDFLARE_EMAIL" \
    -H "X-Auth-Key: $CLOUDFLARE_API_KEY" \
    -d '{
      "name": "My Awesome DNS Firewall cluster",
      "upstream_ips": [
        "192.0.2.1",
        "198.51.100.1",
        "string"
      ],
      "deprecate_any_requests": true,
      "maximum_cache_ttl": 900,
      "minimum_cache_ttl": 60,
      "negative_cache_ttl": 900,
      "ratelimit": 600,
      "retries": 2
    }'

200Example

{
  "errors": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "success": true,
  "result": {
    "id": "023e105f4ecef8ad9ca31a8372d0c353",
    "deprecate_any_requests": true,
    "dns_firewall_ips": [
      "203.0.113.1",
      "203.0.113.254",
      "string",
      "string"
    ],
    "ecs_fallback": false,
    "maximum_cache_ttl": 900,
    "minimum_cache_ttl": 60,
    "modified_on": "2014-01-01T05:20:00.12345Z",
    "name": "My Awesome DNS Firewall cluster",
    "negative_cache_ttl": 900,
    "ratelimit": 600,
    "retries": 2,
    "upstream_ips": [
      "192.0.2.1",
      "198.51.100.1",
      "string"
    ],
    "attack_mitigation": {
      "enabled": true,
      "only_when_upstream_unhealthy": false
    }
  }
}

Delete DNS Firewall Cluster -> Envelope<{ id }>

delete/accounts/{account_id}/dns_firewall/{dns_firewall_id}

Delete a DNS Firewall cluster

Update DNS Firewall Cluster -> Envelope<{ id, deprecate_any_requests, dns_firewall_ips, 10 more... }>

patch/accounts/{account_id}/dns_firewall/{dns_firewall_id}

Modify the configuration of a DNS Firewall cluster

DNS Firewall Cluster Details -> Envelope<{ id, deprecate_any_requests, dns_firewall_ips, 10 more... }>

get/accounts/{account_id}/dns_firewall/{dns_firewall_id}

Show a single DNS Firewall cluster for an account

List DNS Firewall Clusters -> V4PagePaginationArray<{ id, deprecate_any_requests, dns_firewall_ips, 10 more... }>

get/accounts/{account_id}/dns_firewall

List DNS Firewall clusters for an account

Domain types

AttackMitigation = { enabled, only_when_upstream_unhealthy }

FirewallIPs = string

UpstreamIPs = string

DNS Firewall

Analytics

dns_firewall.analytics

DNS Firewall Analytics

Reports

dns_firewall.analytics.reports

Methods

Table -> Envelope<

Report

get/accounts/{account_id}/dns_firewall/{dns_firewall_id}/dns_analytics/report

Retrieves a list of summarised aggregate metrics over a given time period.

See Analytics API properties for detailed information about the available query parameters.

DNS Firewall Analytics Reports

Bytimes

dns_firewall.analytics.reports.bytimes

Methods

By Time -> Envelope<

ByTime

get/accounts/{account_id}/dns_firewall/{dns_firewall_id}/dns_analytics/report/bytime

Retrieves a list of aggregate metrics grouped by time interval.

See Analytics API properties for detailed information about the available query parameters.

DNS Firewall

Reverse DNS

dns_firewall.reverse_dns

Methods

Update DNS Firewall Cluster Reverse DNS -> Envelope<{ ptr }>

patch/accounts/{account_id}/dns_firewall/{dns_firewall_id}/reverse_dns

Update reverse DNS configuration (PTR records) for a DNS Firewall cluster

Show DNS Firewall Cluster Reverse DNS -> Envelope<{ ptr }>

get/accounts/{account_id}/dns_firewall/{dns_firewall_id}/reverse_dns

Show reverse DNS configuration (PTR records) for a DNS Firewall cluster