Cloudflare/dns

@swamp/cloudflare/dnsv2026.08.11.1· 11d agoMODELS

01README

Cloudflare dns infrastructure models

02Release Notes

Updated: dns_records

03Models3

@swamp/cloudflare/dns/dns-firewallv2026.07.21.1dns_firewall.ts

Global Arguments

Argument	Type	Required	Description
account_id	string	yes	Cloudflare account ID
attack_mitigation?	object	no	Attack mitigation settings
deprecate_any_requests?	boolean	no	Whether to refuse to answer queries for the ANY type
ecs_fallback?	boolean	no	Whether to forward client IP (resolver) subnet if no EDNS Client Subnet is sent
maximum_cache_ttl?	number	no	By default, Cloudflare attempts to cache responses for as long as\nindicated by the TTL received from upstream nameservers. This setting\nsets an upper bound on this duration. For caching purposes, higher TTLs\nwill be decreased to the maximum value defined by this setting.\n\nThis setting does not affect the TTL value in the DNS response\nCloudflare returns to clients. Cloudflare will always forward the TTL\nvalue received from upstream nameservers.\n
minimum_cache_ttl?	number	no	By default, Cloudflare attempts to cache responses for as long as\nindicated by the TTL received from upstream nameservers. This setting\nsets a lower bound on this duration. For caching purposes, lower TTLs\nwill be increased to the minimum value defined by this setting.\n\nThis setting does not affect the TTL value in the DNS response\nCloudflare returns to clients. Cloudflare will always forward the TTL\nvalue received from upstream nameservers.\n\nNote that, even with this setting, there is
name?	string	no	DNS Firewall cluster name
negative_cache_ttl?	number	no	This setting controls how long DNS Firewall should cache negative\nresponses (e.g., NXDOMAIN) from the upstream servers.\n\nThis setting does not affect the TTL value in the DNS response\nCloudflare returns to clients. Cloudflare will always forward the TTL\nvalue received from upstream nameservers.\n
ratelimit?	number	no	Maximum number of DNS queries per second that will be forwarded to your upstream nameservers. The limit is enforced per server, where each server receives a fraction of the configured value. The actual aggregate rate for a data center may vary depending on how many servers are present. Responses served from cache do not count toward this limit. Set to null to disable rate limiting.
retries?	number	no	Number of retries for fetching DNS responses from upstream nameservers (not counting the initial attempt)
upstream_ips?	array	no
dns_firewall_ip_count?	number	no	Number of IPv4 addresses to assign to the DNS Firewall cluster. Only used during cluster creation and cannot be changed later.
apiToken?	string	no	Cloudflare API token; overrides the CLOUDFLARE_API_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
apiKey?	string	no	Cloudflare API key for the legacy key+email auth path; overrides the CLOUDFLARE_API_KEY environment variable. Wire with a vault.get(...) expression. Requires email.
email?	string	no	Cloudflare account email for the legacy key+email auth path; overrides the CLOUDFLARE_EMAIL environment variable. Requires apiKey.

fn create()

Create a Dns Firewall

fn get(id: string)

Get a Dns Firewall

Argument	Type	Required	Description
id	string	yes	The ID of the Dns Firewall

fn lookup()

Look up an existing Dns Firewall by matching global argument values and import it into state

fn adopt(id: string)

Import an existing Dns Firewall by ID into state for management

Argument	Type	Required	Description
id	string	yes	The ID of the Dns Firewall to import

fn update(identifier?: string)

Update Dns Firewall attributes

Argument	Type	Required	Description
identifier?	string	no	Target a specific Dns Firewall by id (e.g. one discovered by list)

fn delete(id: string)

Delete the Dns Firewall

Argument	Type	Required	Description
id	string	yes	The ID of the Dns Firewall

fn sync(identifier?: string)

Sync Dns Firewall state from Cloudflare

Argument	Type	Required	Description
identifier?	string	no	Target a specific Dns Firewall by id (e.g. one discovered by list)

Resources

state(infinite)— Dns Firewall resource state

@swamp/cloudflare/dns/dns-recordsv2026.08.11.1dns_records.ts

Global Arguments

Argument	Type	Required	Description
zone_id	string	yes	Cloudflare zone ID
comment?	string	no	Comments or notes about the DNS record. This field has no effect on DNS responses.
name?	string	no	Complete DNS record name, including the zone name, in Punycode.
proxied?	boolean	no	Whether the record is receiving the performance and security benefits of Cloudflare.
settings?	object	no	Settings for the DNS record.
tags?	array	no	Custom tags for the DNS record. This field has no effect on DNS responses.
ttl?	number	no
content?	string	no	A valid IPv4 address.
private_routing?	boolean	no	Enables private network routing to the origin.
type?	enum	no	Record type.
priority?	number	no	Required for MX and URI records; ignored for other record types (but may still be returned by the API). Records with lower priorities are preferred. This field is to be deprecated in favor of the priority field within the data map.
data?	object	no	Components of a CAA record.
apiToken?	string	no	Cloudflare API token; overrides the CLOUDFLARE_API_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
apiKey?	string	no	Cloudflare API key for the legacy key+email auth path; overrides the CLOUDFLARE_API_KEY environment variable. Wire with a vault.get(...) expression. Requires email.
email?	string	no	Cloudflare account email for the legacy key+email auth path; overrides the CLOUDFLARE_EMAIL environment variable. Requires apiKey.

fn create()

Create a Dns Records

fn get(id: string)

Get a Dns Records

Argument	Type	Required	Description
id	string	yes	The ID of the Dns Records

fn lookup()

Look up an existing Dns Records by matching global argument values and import it into state

fn adopt(id: string)

Import an existing Dns Records by ID into state for management

Argument	Type	Required	Description
id	string	yes	The ID of the Dns Records to import

fn update(identifier?: string)

Update Dns Records attributes

Argument	Type	Required	Description
identifier?	string	no	Target a specific Dns Records by id (e.g. one discovered by list)

fn delete(id: string)

Delete the Dns Records

Argument	Type	Required	Description
id	string	yes	The ID of the Dns Records

fn sync(identifier?: string)

Sync Dns Records state from Cloudflare

Argument	Type	Required	Description
identifier?	string	no	Target a specific Dns Records by id (e.g. one discovered by list)

Resources

state(infinite)— Dns Records resource state

@swamp/cloudflare/dns/viewsv2026.07.21.1views.ts

Global Arguments

Argument	Type	Required	Description
account_id	string	yes	Cloudflare account ID
created_time?	string	no	When the view was created.
modified_time?	string	no	When the view was last modified.
name?	string	no	The name of the view.
zones?	array	no	The list of zones linked to this view.
apiToken?	string	no	Cloudflare API token; overrides the CLOUDFLARE_API_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
apiKey?	string	no	Cloudflare API key for the legacy key+email auth path; overrides the CLOUDFLARE_API_KEY environment variable. Wire with a vault.get(...) expression. Requires email.
email?	string	no	Cloudflare account email for the legacy key+email auth path; overrides the CLOUDFLARE_EMAIL environment variable. Requires apiKey.

fn create()

Create a Views

fn get(id: string)

Get a Views

Argument	Type	Required	Description
id	string	yes	The ID of the Views

fn lookup()

Look up an existing Views by matching global argument values and import it into state

fn adopt(id: string)

Import an existing Views by ID into state for management

Argument	Type	Required	Description
id	string	yes	The ID of the Views to import

fn update(identifier?: string)

Update Views attributes

Argument	Type	Required	Description
identifier?	string	no	Target a specific Views by id (e.g. one discovered by list)

fn delete(id: string)

Delete the Views

Argument	Type	Required	Description
id	string	yes	The ID of the Views

fn sync(identifier?: string)

Sync Views state from Cloudflare

Argument	Type	Required	Description
identifier?	string	no	Target a specific Views by id (e.g. one discovered by list)

Resources

state(infinite)— Views resource state

04Previous Versions7

2026.07.24.1Jul 24, 2026

Updated: dns_records

2026.07.21.1Jul 21, 2026

Updated: dns_firewall
Updated: dns_records
Updated: views

2026.07.18.2Jul 18, 2026

Modified 3 models

2026.07.14.1Jul 14, 2026

Updated: dns_records

Added 3, removed 1 models

2026.06.08.2Jun 8, 2026

Updated: dns_firewall
Updated: dns_records
Updated: views

2026.05.29.1May 29, 2026

Updated: dns_firewall
Updated: dns_records
Updated: views

2026.05.22.1May 22, 2026

Added: dns_firewall
Added: dns_records
Added: views

05Stats

100 / 100

Downloads

Archive size

21.8 KB

Verified by Swamp

Has README or module doc2/2earned
README has a code example1/1earned
README is substantive1/1earned
Most symbols documented1/1earned
No slow types (deprecated)1/1earned
Dependencies pass trust audit2/2earned
Has description1/1earned
Platform support declared (or universal)2/2earned
License declared1/1earned
Verified public repository2/2earned

Repository

https://github.com/swamp-club/swamp-extensions

06Platforms

linux · x86_64 linux · aarch64 macOS · x86_64 macOS · aarch64

07Labels

#cloudflare #dns #cloud #infrastructure