Skip to main content

catch_alls

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

Overview​

Namecatch_alls
TypeResource
Idcloudflare.email_routing.catch_alls

Fields​

The following fields are returned by SELECT queries:

Get catch-all rule response

NameDatatypeDescription
idstringRouting rule identifier. (example: a7e6fb77503c41d8a7f3113c6918f10c)
namestringRouting rule name. (example: Send to user@example.net rule.)
actionsarrayList actions for the catch-all routing rule.
enabledbooleanRouting rule status. (true, false)
matchersarrayList of matchers for the catch-all routing rule.
tagstringRouting rule tag. (Deprecated, replaced by routing rule identifier) (example: a7e6fb77503c41d8a7f3113c6918f10c)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
listselectzone_idGet information on the default catch-all routing rule.
updatereplacezone_id, actions, matchersEnable or disable catch-all routing rule, or change action to forward to specific destination address. Forward actions require all destination addresses to be verified.

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.

NameDatatypeDescription
zone_idstringThe Cloudflare zone ID.

SELECT examples​

Get information on the default catch-all routing rule.

SELECT
id,
name,
actions,
enabled,
matchers,
tag
FROM cloudflare.email_routing.catch_alls
WHERE zone_id = '{{ zone_id }}' -- required
;

REPLACE examples​

Enable or disable catch-all routing rule, or change action to forward to specific destination address. Forward actions require all destination addresses to be verified.

REPLACE cloudflare.email_routing.catch_alls
SET
actions = '{{ actions }}',
enabled = {{ enabled }},
matchers = '{{ matchers }}',
name = '{{ name }}'
WHERE
zone_id = '{{ zone_id }}' --required
AND actions = '{{ actions }}' --required
AND matchers = '{{ matchers }}' --required
RETURNING
errors,
messages,
result,
success;