Skip to content
Cloudflare API
Start here
API Reference

DNS Firewall

List DNS Firewall Clusters
client.DNSFirewall.List(ctx, params) (*V4PagePaginationArray[DNSFirewallListResponse], error)
GET/accounts/{account_id}/dns_firewall
DNS Firewall Cluster Details
client.DNSFirewall.Get(ctx, dnsFirewallID, query) (*DNSFirewallGetResponse, error)
GET/accounts/{account_id}/dns_firewall/{dns_firewall_id}
Create DNS Firewall Cluster
client.DNSFirewall.New(ctx, params) (*DNSFirewallNewResponse, error)
POST/accounts/{account_id}/dns_firewall
Update DNS Firewall Cluster
client.DNSFirewall.Edit(ctx, dnsFirewallID, params) (*DNSFirewallEditResponse, error)
PATCH/accounts/{account_id}/dns_firewall/{dns_firewall_id}
Delete DNS Firewall Cluster
client.DNSFirewall.Delete(ctx, dnsFirewallID, body) (*DNSFirewallDeleteResponse, error)
DELETE/accounts/{account_id}/dns_firewall/{dns_firewall_id}
ModelsExpand Collapse
type AttackMitigation struct{…}

Attack mitigation settings

Enabled booloptional

When enabled, automatically mitigate random-prefix attacks to protect upstream DNS servers

OnlyWhenUpstreamUnhealthy booloptional

Only mitigate attacks when upstream servers seem unhealthy

type FirewallIPs string

Cloudflare-assigned DNS IPv4 address

type UpstreamIPs string

Upstream DNS Server IPv4 address

DNS FirewallAnalytics

DNS FirewallAnalyticsReports

Table
client.DNSFirewall.Analytics.Reports.Get(ctx, dnsFirewallID, params) (*Report, error)
GET/accounts/{account_id}/dns_firewall/{dns_firewall_id}/dns_analytics/report

DNS FirewallAnalyticsReportsBytimes

By Time
client.DNSFirewall.Analytics.Reports.Bytimes.Get(ctx, dnsFirewallID, params) (*ByTime, error)
GET/accounts/{account_id}/dns_firewall/{dns_firewall_id}/dns_analytics/report/bytime

DNS FirewallReverse DNS

Show DNS Firewall Cluster Reverse DNS
client.DNSFirewall.ReverseDNS.Get(ctx, dnsFirewallID, query) (*ReverseDNSGetResponse, error)
GET/accounts/{account_id}/dns_firewall/{dns_firewall_id}/reverse_dns
Update DNS Firewall Cluster Reverse DNS
client.DNSFirewall.ReverseDNS.Edit(ctx, dnsFirewallID, params) (*ReverseDNSEditResponse, error)
PATCH/accounts/{account_id}/dns_firewall/{dns_firewall_id}/reverse_dns