---
title: DNS Firewall
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/go)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# DNS Firewall

##### [List DNS Firewall Clusters](https://developers.cloudflare.com/api/go/resources/dns_firewall/methods/list)

client.DNSFirewall.List(ctx, params) (\*V4PagePaginationArray\[[DNSFirewallListResponse](<https://developers.cloudflare.com/api/go/resources/dns_firewall#(resource)%20dns_firewall%20%3E%20(model)%20DNSFirewallListResponse%20%3E%20(schema)>)], error)

GET/accounts/{account\_id}/dns\_firewall

##### [DNS Firewall Cluster Details](https://developers.cloudflare.com/api/go/resources/dns_firewall/methods/get)

client.DNSFirewall.Get(ctx, dnsFirewallID, query) (\*[DNSFirewallGetResponse](<https://developers.cloudflare.com/api/go/resources/dns_firewall#(resource)%20dns_firewall%20%3E%20(model)%20DNSFirewallGetResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/dns\_firewall/{dns\_firewall\_id}

##### [Create DNS Firewall Cluster](https://developers.cloudflare.com/api/go/resources/dns_firewall/methods/create)

client.DNSFirewall.New(ctx, params) (\*[DNSFirewallNewResponse](<https://developers.cloudflare.com/api/go/resources/dns_firewall#(resource)%20dns_firewall%20%3E%20(model)%20DNSFirewallNewResponse%20%3E%20(schema)>), error)

POST/accounts/{account\_id}/dns\_firewall

##### [Update DNS Firewall Cluster](https://developers.cloudflare.com/api/go/resources/dns_firewall/methods/edit)

client.DNSFirewall.Edit(ctx, dnsFirewallID, params) (\*[DNSFirewallEditResponse](<https://developers.cloudflare.com/api/go/resources/dns_firewall#(resource)%20dns_firewall%20%3E%20(model)%20DNSFirewallEditResponse%20%3E%20(schema)>), error)

PATCH/accounts/{account\_id}/dns\_firewall/{dns\_firewall\_id}

##### [Delete DNS Firewall Cluster](https://developers.cloudflare.com/api/go/resources/dns_firewall/methods/delete)

client.DNSFirewall.Delete(ctx, dnsFirewallID, body) (\*[DNSFirewallDeleteResponse](<https://developers.cloudflare.com/api/go/resources/dns_firewall#(resource)%20dns_firewall%20%3E%20(model)%20DNSFirewallDeleteResponse%20%3E%20(schema)>), error)

DELETE/accounts/{account\_id}/dns\_firewall/{dns\_firewall\_id}

##### ModelsExpand Collapse

<details>

<summary>

type AttackMitigation struct{…}

Attack mitigation settings

</summary>

Enabled boolOptional

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

<a href="#(resource)%20dns_firewall%20%3E%20(model)%20attack_mitigation%20%3E%20(schema)%20%3E%20(property)%20enabled">Link to this property</a>

OnlyWhenUpstreamUnhealthy boolOptional

Only mitigate attacks when upstream servers seem unhealthy

<a href="#(resource)%20dns_firewall%20%3E%20(model)%20attack_mitigation%20%3E%20(schema)%20%3E%20(property)%20only_when_upstream_unhealthy">Link to this property</a>

</details>

[Link to this property](<#(resource)%20dns_firewall%20%3E%20(model)%20attack_mitigation%20%3E%20(schema)>)

type FirewallIPs string

Cloudflare-assigned DNS IPv4 address

[Link to this property](<#(resource)%20dns_firewall%20%3E%20(model)%20firewall_ips%20%3E%20(schema)>)

type UpstreamIPs string

Upstream DNS Server IPv4 address

[Link to this property](<#(resource)%20dns_firewall%20%3E%20(model)%20upstream_ips%20%3E%20(schema)>)

#### DNS FirewallAnalytics

#### DNS FirewallAnalyticsReports

##### [Table](https://developers.cloudflare.com/api/go/resources/dns_firewall/subresources/analytics/subresources/reports/methods/get)

Deprecated

client.DNSFirewall.Analytics.Reports.Get(ctx, dnsFirewallID, params) (\*[Report](<https://developers.cloudflare.com/api/go/resources/dns#(resource)%20dns.analytics.reports%20%3E%20(model)%20report%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/dns\_firewall/{dns\_firewall\_id}/dns\_analytics/report

#### DNS FirewallAnalyticsReportsBytimes

##### [By Time](https://developers.cloudflare.com/api/go/resources/dns_firewall/subresources/analytics/subresources/reports/subresources/bytimes/methods/get)

Deprecated

client.DNSFirewall.Analytics.Reports.Bytimes.Get(ctx, dnsFirewallID, params) (\*[ByTime](<https://developers.cloudflare.com/api/go/resources/dns#(resource)%20dns.analytics.reports.bytimes%20%3E%20(model)%20by_time%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/dns\_firewall/{dns\_firewall\_id}/dns\_analytics/report/bytime

#### DNS FirewallReverse DNS

##### [Show DNS Firewall Cluster Reverse DNS](https://developers.cloudflare.com/api/go/resources/dns_firewall/subresources/reverse_dns/methods/get)

client.DNSFirewall.ReverseDNS.Get(ctx, dnsFirewallID, query) (\*[ReverseDNSGetResponse](<https://developers.cloudflare.com/api/go/resources/dns_firewall#(resource)%20dns_firewall.reverse_dns%20%3E%20(model)%20ReverseDNSGetResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/dns\_firewall/{dns\_firewall\_id}/reverse\_dns

##### [Update DNS Firewall Cluster Reverse DNS](https://developers.cloudflare.com/api/go/resources/dns_firewall/subresources/reverse_dns/methods/edit)

client.DNSFirewall.ReverseDNS.Edit(ctx, dnsFirewallID, params) (\*[ReverseDNSEditResponse](<https://developers.cloudflare.com/api/go/resources/dns_firewall#(resource)%20dns_firewall.reverse_dns%20%3E%20(model)%20ReverseDNSEditResponse%20%3E%20(schema)>), error)

PATCH/accounts/{account\_id}/dns\_firewall/{dns\_firewall\_id}/reverse\_dns