usage

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

Overview

Name	usage
Type	Resource
Id	cloudflare.dns.usage

Fields

The following fields are returned by SELECT queries:

list_by_account

Get DNS Record Usage response

Name	Datatype	Description
internal_record_quota	integer	Maximum number of DNS records allowed across all internal zones in the account. Only present if internal DNS is enabled.
internal_record_usage	integer	Current number of DNS records across all internal zones in the account. Only present if internal DNS is enabled.
record_quota	integer	Maximum number of DNS records allowed across all public zones in the account. Null if using zone-level quota.
record_usage	integer	Current number of DNS records across all public zones in the account.

list_by_zone

Get DNS Record Usage response

Name	Datatype	Description
internal_record_quota	integer	Maximum number of DNS records allowed across all internal zones in the account. Only present if internal DNS is enabled.
internal_record_usage	integer	Current number of DNS records across all internal zones in the account. Only present if internal DNS is enabled.
record_quota	integer	Maximum number of DNS records allowed across all public zones in the account. Null if using zone-level quota.
record_usage	integer	Current number of DNS records across all public zones in the account.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_by_account	select	account_id		Get the current DNS record usage and quota for an account or zone. May include internal DNS usage and quota.
list_by_zone	select	zone_id		Get the current DNS record usage and quota for an account or zone. May include internal DNS usage and quota.

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.
zone_id	string	The Cloudflare zone ID.

SELECT examples

list_by_account

Get the current DNS record usage and quota for an account or zone. May include internal DNS usage and quota.

SELECT
internal_record_quota,
internal_record_usage,
record_quota,
record_usage
FROM cloudflare.dns.usage
WHERE account_id = '{{ account_id }}' -- required
;

list_by_zone

Get the current DNS record usage and quota for an account or zone. May include internal DNS usage and quota.

SELECT
internal_record_quota,
internal_record_usage,
record_quota,
record_usage
FROM cloudflare.dns.usage
WHERE zone_id = '{{ zone_id }}' -- required
;