acls

Creates, updates, deletes, gets or lists an acls resource.

Overview

Name	acls
Type	Resource
Id	cloudflare.dns.acls

Fields

The following fields are returned by SELECT queries:

get

ACL Details response.

Name	Datatype	Description
id	string	(example: 23ff594956f20c2a721606e94745a8aa)
name	string	The name of the acl. (example: my-acl-1)
ip_range	string	Allowed IPv4/IPv6 address range of primary or secondary nameservers. This will be applied for the entire account. The IP range is used to allow additional NOTIFY IPs for secondary zones and IPs Cloudflare allows AXFR/IXFR requests from for primary zones. CIDRs are limited to a maximum of /24 for IPv4 and /64 for IPv6 respectively. (example: 192.0.2.53/28)

list

List ACLs response.

Name	Datatype	Description
id	string	(example: 23ff594956f20c2a721606e94745a8aa)
name	string	The name of the acl. (example: my-acl-1)
ip_range	string	Allowed IPv4/IPv6 address range of primary or secondary nameservers. This will be applied for the entire account. The IP range is used to allow additional NOTIFY IPs for secondary zones and IPs Cloudflare allows AXFR/IXFR requests from for primary zones. CIDRs are limited to a maximum of /24 for IPv4 and /64 for IPv6 respectively. (example: 192.0.2.53/28)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	acl_id, account_id		Get ACL.
list	select	account_id		List ACLs.
create	insert	account_id, name, ip_range		Create ACL.
update	replace	acl_id, account_id, name, ip_range		Modify ACL.
delete	delete	acl_id, account_id		Delete ACL.

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.
acl_id	string

SELECT examples

get

Get ACL.

SELECT
id,
name,
ip_range
FROM cloudflare.dns.acls
WHERE acl_id = '{{ acl_id }}' -- required
AND account_id = '{{ account_id }}' -- required
;

list

List ACLs.

SELECT
id,
name,
ip_range
FROM cloudflare.dns.acls
WHERE account_id = '{{ account_id }}' -- required
;

INSERT examples

create

Create ACL.

INSERT INTO cloudflare.dns.acls (
ip_range,
name,
account_id
)
SELECT 
'{{ ip_range }}' /* required */,
'{{ name }}' /* required */,
'{{ account_id }}'
RETURNING
errors,
messages,
result,
success
;

Manifest

# Description fields are for documentation purposes
- name: acls
props:
  - name: account_id
    value: "{{ account_id }}"
    description: Required parameter for the acls resource.
  - name: ip_range
    value: "{{ ip_range }}"
    description: |
      Allowed IPv4/IPv6 address range of primary or secondary nameservers. This will be applied for the entire account. The IP range is used to allow additional NOTIFY IPs for secondary zones and IPs Cloudflare allows AXFR/IXFR requests from for primary zones. CIDRs are limited to a maximum of /24 for IPv4 and /64 for IPv6 respectively.
  - name: name
    value: "{{ name }}"
    description: |
      The name of the acl.

REPLACE examples

update

Modify ACL.

REPLACE cloudflare.dns.acls
SET 
ip_range = '{{ ip_range }}',
name = '{{ name }}'
WHERE 
acl_id = '{{ acl_id }}' --required
AND account_id = '{{ account_id }}' --required
AND name = '{{ name }}' --required
AND ip_range = '{{ ip_range }}' --required
RETURNING
errors,
messages,
result,
success;

DELETE examples

delete

Delete ACL.

DELETE FROM cloudflare.dns.acls
WHERE acl_id = '{{ acl_id }}' --required
AND account_id = '{{ account_id }}' --required
;