fallback_domains

Creates, updates, deletes, gets or lists a fallback_domains resource.

Overview

Name	fallback_domains
Type	Resource
Id	cloudflare.zero_trust.fallback_domains

Fields

The following fields are returned by SELECT queries:

list_by_policy

Get the Local Domain Fallback list for a device settings profile response.

Name	Datatype	Description
description	string	A description of the fallback domain, displayed in the client UI. (example: Domain bypass for local development)
dns_server	array	A list of IP addresses to handle domain resolution.
suffix	string	The domain suffix to match when resolving locally. (example: example.com)

list_by_account

Get your Local Domain Fallback list response.

Name	Datatype	Description
description	string	A description of the fallback domain, displayed in the client UI. (example: Domain bypass for local development)
dns_server	array	A list of IP addresses to handle domain resolution.
suffix	string	The domain suffix to match when resolving locally. (example: example.com)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_by_policy	select	policy_id, account_id		Fetches the list of domains to bypass Gateway DNS resolution from a specified device settings profile. These domains will use the specified local DNS resolver instead.
list_by_account	select	account_id		Fetches a list of domains to bypass Gateway DNS resolution. These domains will use the specified local DNS resolver instead.
set_by_policy	replace	policy_id, account_id		Sets the list of domains to bypass Gateway DNS resolution. These domains will use the specified local DNS resolver instead. This will only apply to the specified device settings profile.
set	replace	account_id		Sets the list of domains to bypass Gateway DNS resolution. These domains will use the specified local DNS resolver instead.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
account_id	string	The Cloudflare account ID.
policy_id	string	The Access policy ID.

SELECT examples

list_by_policy

Fetches the list of domains to bypass Gateway DNS resolution from a specified device settings profile. These domains will use the specified local DNS resolver instead.

SELECT
description,
dns_server,
suffix
FROM cloudflare.zero_trust.fallback_domains
WHERE policy_id = '{{ policy_id }}' -- required
AND account_id = '{{ account_id }}' -- required
;

list_by_account

Fetches a list of domains to bypass Gateway DNS resolution. These domains will use the specified local DNS resolver instead.

SELECT
description,
dns_server,
suffix
FROM cloudflare.zero_trust.fallback_domains
WHERE account_id = '{{ account_id }}' -- required
;

REPLACE examples

set_by_policy

Sets the list of domains to bypass Gateway DNS resolution. These domains will use the specified local DNS resolver instead. This will only apply to the specified device settings profile.

REPLACE cloudflare.zero_trust.fallback_domains
SET 
-- No updatable properties
WHERE 
policy_id = '{{ policy_id }}' --required
AND account_id = '{{ account_id }}' --required
RETURNING
errors,
messages,
result,
result_info,
success;

set

Sets the list of domains to bypass Gateway DNS resolution. These domains will use the specified local DNS resolver instead.

REPLACE cloudflare.zero_trust.fallback_domains
SET 
-- No updatable properties
WHERE 
account_id = '{{ account_id }}' --required
RETURNING
errors,
messages,
result,
result_info,
success;