Skip to main content

status

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

Overview

Namestatus
TypeResource
Idcloudflare.email_sending.status

Fields

The following fields are returned by SELECT queries:

Get sending subdomain DNS status response

NameDatatypeDescription
namestringDNS record name (or @ for the zone apex). (example: example.com)
contentstringDNS record content. (example: route1.mx.cloudflare.net)
prioritynumberRequired for MX, SRV and URI records. Unused by other record types. Records with lower priorities are preferred.
ttlnumberTime to live, in seconds, of the DNS record. Must be between 60 and 86400, or 1 for 'automatic'. (1)
typestringDNS record type. (A, AAAA, CNAME, HTTPS, TXT, SRV, LOC, MX, NS, CERT, DNSKEY, DS, NAPTR, SMIMEA, SSHFP, SVCB, TLSA, URI) (example: NS)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
listselectsubdomain_id, zone_idReturns the desired DNS records for a sending subdomain along with a live diff against actual DNS state. Use this to detect missing, unlocked, foreign, or multi-record conflicts before deciding whether to call the fix endpoint.

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
subdomain_idstring
zone_idstringThe Cloudflare zone ID.

SELECT examples

Returns the desired DNS records for a sending subdomain along with a live diff against actual DNS state. Use this to detect missing, unlocked, foreign, or multi-record conflicts before deciding whether to call the fix endpoint.

SELECT
name,
content,
priority,
ttl,
type
FROM cloudflare.email_sending.status
WHERE subdomain_id = '{{ subdomain_id }}' -- required
AND zone_id = '{{ zone_id }}' -- required
;