namedacl : Named ACL object.

A named ACL (Access Control List) is a list of IPv4/IPv6 addresses, networks, TSIG-based anonymous access controls, and other named ACLs, to which you can grant or deny permission for operations such as dynamic DNS updates or zone transfers.

Object Reference

References to namedacl are object references.

The name part of the named ACL object reference has the following components:

  • The name of the named ACL object

Example: namedacl/ZG5zLm5ldHdvcmtfdmlldyQxMTk:ACL1

Restrictions

The object does not support the following operations:

  • Scheduling
  • CSV export

The object cannot be managed on Cloud Platform members.

Fields

These fields are actual members of the object; thus, they can be requested by using _return_fields, if the fields are readable.

The basic version of the object contains the field(s): comment, name.

The following fields are required to create this object:

Field Notes
name  

access_list

access_list

The access control list of IPv4/IPv6 addresses, networks, TSIG-based anonymous access controls, and other named ACLs.

Type

One of the following: Address ac struct, TSIG ac struct array.

Create

The default value is:

empty

Search

The field is not available for search.

comment

comment

Comment for the named ACL; maximum 256 characters.

Type

String.

Values with leading or trailing white space are not valid for this field.

Create

The default value is empty.

Search

The field is available for search via

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

Notes

The comment is part of the base object.

exploded_access_list

exploded_access_list

The exploded access list for the named ACL. This list displays all the access control entries in a named ACL and its nested named ACLs, if applicable.

Type

One of the following: Address ac struct, TSIG ac struct array.

Search

The field is not available for search.

Notes

The exploded_access_list cannot be updated.

exploded_access_list cannot be written.

extattrs

extattrs

Extensible attributes associated with the object.

For valid values for extensible attributes, see the following information.

Type

Extensible attributes.

This field allows +/- to be specified as part of the field name when updating the object, see the following information.

Create

The default value is empty.

Search

For how to search extensible attributes, see the following information.

name

name

The name of the named ACL.

Type

String.

Values with leading or trailing white space are not valid for this field.

Create

The field is required on creation.

Search

The field is available for search via

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

Notes

The name is part of the base object.

Function Calls

validate_acl_items

This function is used to validate ACL items and return the validated result in a CSV file format if the validation fails, and return nothing if validation succeeds.

This function does not support multiple object matches when called as part of an atomic insertion operation.

Input fields

None

Output fields

token ( String. ) The token used for calling the downloadcomplete function.

url ( String. ) For local (not remote) uploads, the URL from which the requested file is downloaded.

Fields List

Field Type Req R/O Base Search
access_list [struct] N N N N/A
comment String N N Y : = ~
exploded_access_list [struct] N Y N N/A
extattrs Extattr N N N ext
name String Y N Y : = ~