---
title: "PTR Record"
canonical: "https://docs.infoblox.com/space/niosmodulesansible/44950844/PTR%20Record"
format: markdown
---
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** |
| --- | --- | --- |
| `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:<br>- `present` (default): Configures the record.
- `absent`: Removes the record. |
| `comment` | Optional | Describes the PTR record object. |
| `provider` | Required | Defines the details of the connection:<br>- `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.<br>For information on additional fields you can define, see <span style="color: #172b4d">the list of subparameters in the </span><span style="color: #172b4d">*[NIOS Modules for Ansible Collections](https://infoblox-docs.atlassian.net/wiki/spaces/niosmodulesansible/pages/44525470)*</span><span style="color: #172b4d"> topic.</span> |
| `connection` | Required | The `nios_ptr_record` module must be run locally. |

## <span style="color: #000000">Examples</span>

`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`