POST /accounts/{account_id}/dns_firewall
Create a DNS Firewall cluster
Servers
- https://api.cloudflare.com/client/v4
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id |
String | Yes |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
upstream_ips[] |
Array | Yes | |
negative_cache_ttl |
Number | No |
Negative DNS cache TTL This setting controls how long DNS Firewall should cache negative responses (e.g., NXDOMAIN) from the upstream servers. |
name |
String | Yes |
DNS Firewall cluster name |
deprecate_any_requests |
Boolean | No |
Whether to refuse to answer queries for the ANY type |
attack_mitigation |
Object | No |
Attack mitigation settings |
attack_mitigation.only_when_upstream_unhealthy |
Boolean | No |
Only mitigate attacks when upstream servers seem unhealthy Default value: true |
attack_mitigation.enabled |
Boolean | No |
When enabled, automatically mitigate random-prefix attacks to protect upstream DNS servers |
ecs_fallback |
Boolean | No |
Whether to forward client IP (resolver) subnet if no EDNS Client Subnet is sent |
minimum_cache_ttl |
Number | No |
Minimum DNS cache TTL This setting sets a lower bound on DNS TTLs for purposes of caching between DNS Firewall and the upstream servers. Lower TTLs will be increased to the minimum defined here for caching purposes. Default value: 60 |
ratelimit |
Number | No |
Ratelimit in queries per second per datacenter (applies to DNS queries sent to the upstream nameservers configured on the cluster) |
retries |
Number | No |
Number of retries for fetching DNS responses from upstream nameservers (not counting the initial attempt) Default value: 2 |
maximum_cache_ttl |
Number | No |
Maximum DNS cache TTL This setting sets an upper bound on DNS TTLs for purposes of caching between DNS Firewall and the upstream servers. Higher TTLs will be decreased to the maximum defined here for caching purposes. Default value: 900 |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.