/
PTR Record

PTR Record

Use the nios_ptr_record module to create, update, or remove a PTR record object from a NIOS Grid.

The following table describes the parameters you can define in the nios_ptr_record module:

Parameter

Required/Optional

Description

Parameter

Required/Optional

Description

name

Optional

Specifies the fully qualified host name of the record to add, update, or remove from NIOS.
This field is required only if you are creating a PTR record in a forward mapping zone; it is not required for a reverse mapping zone.

view

Optional

Specifies the DNS view to associate the PTR record with.
If a value is not specified, the default view configured in NIOS is used.

ipv4addr

Optional

Specifies the IPv4 address of the record.
This is a required field when creating a PTR record in a reverse mapping zone. It is mutually exclusive with ipv6addr.

ipv6addr

Optional

Specifies the IPv6 address of the record.
This is a required field when creating a PTR record in a reverse mapping zone. It is mutually exclusive with ipv4addr.

ptrdname

Required

Specifies the domain name of the DNS PTR record in the FQDN format.

ttl

Optional

Specifies the Time To Live (TTL) value for the record.
The duration that the record is valid for, in seconds (cached).

extattrs

Optional

Specifies extensible attributes for the PTR record object.

state

Optional

Specifies the state of the PTR record instance on the NIOS server.
Set one of the following values:

  • present (default): Configures the record.

  • absent: Removes the record.

comment

Optional

Describes the PTR record object.

provider

Required

Defines the details of the connection:

  • host: The DNS host name or IP address to connect to the remote instance of NIOS.

  • username: The user name to use for authenticating the connection to the remote instance.

  • password: The password to use for authenticating the connection to the remote instance.

For information on additional fields you can define, see the list of subparameters in the NIOS Modules for Ansible Collections topic.

connection

Required

The nios_ptr_record module must be run locally.

Examples

name: Create a PTR Record
infoblox.nios_modules.nios_ptr_record:
  ipv4: 192.168.10.1
  ptrdname: host.ansible.com
  state: present
  provider:
    host: <nios_hostname_or_hostip>
    username: <nios_username>
    password: <nios_password>
connection: local

Related content