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;