community.general.nios_ptr_record – Configure Infoblox NIOS PTR records
community.general.nios_ptr_record – Configure Infoblox NIOS PTR records
Note
This plugin is part of the community.general collection (version 2.0.1).
To install it use: ansible-galaxy collection install community.general
.
To use it in a playbook, specify: community.general.nios_ptr_record
.
Synopsis
- Adds and/or removes instances of PTR record objects from Infoblox NIOS servers. This module manages NIOS
record:ptr
objects using the Infoblox WAPI interface over REST.
Requirements
The below requirements are needed on the host that executes this module.
- infoblox_client
Parameters
Parameter | Choices/Defaults | Comments | |
---|---|---|---|
comment string |
Configures a text string comment to be associated with the instance of this object. The provided text string will be configured on the object instance. Maximum 256 characters. | ||
extattrs dictionary |
Allows for the configuration of Extensible Attributes on the instance of the object. This argument accepts a set of key / value pairs for configuration. | ||
ipv4addr string |
The IPv4 Address of the record. Mutually exclusive with the ipv6addr.
| ||
ipv6addr string |
The IPv6 Address of the record. Mutually exclusive with the ipv4addr.
| ||
name string |
The name of the DNS PTR record in FQDN format to add or remove from the system. The field is required only for an PTR object in Forward Mapping Zone. | ||
provider dictionary |
A dict object containing connection details. | ||
host string |
Specifies the DNS host name or address for connecting to the remote instance of NIOS WAPI over REST Value can also be specified using | ||
http_pool_connections integer |
Default: 10 |
Number of pools to be used by the This is passed as-is to the underlying | |
http_pool_maxsize integer |
Default: 10 |
Maximum number of connections per pool to be used by the This is passed as-is to the underlying | |
http_request_timeout integer |
Default: 10 |
The amount of time before to wait before receiving a response Value can also be specified using | |
max_results integer |
Default: 1000 |
Specifies the maximum number of objects to be returned, if set to a negative number the appliance will return an error when the number of returned objects would exceed the setting. Value can also be specified using | |
max_retries integer |
Default: 3 |
Configures the number of attempted retries before the connection is declared usable Value can also be specified using | |
password string |
Specifies the password to use to authenticate the connection to the remote instance of NIOS. Value can also be specified using | ||
silent_ssl_warnings boolean |
|
Disable This is passed as-is to the underlying | |
username string |
Configures the username to use to authenticate the connection to the remote instance of NIOS. Value can also be specified using | ||
validate_certs boolean |
|
Boolean value to enable or disable verifying SSL certificates Value can also be specified using
| |
wapi_version string |
Default: "2.1" |
Specifies the version of WAPI to use Value can also be specified using Until ansible 2.8 the default WAPI was 1.4 | |
ptrdname string |
The domain name of the DNS PTR record in FQDN format. | ||
state string |
|
Configures the intended state of the instance of the object on the NIOS server. When this value is set to | |
ttl integer |
Time To Live (TTL) value for the record. A 32-bit unsigned integer that represents the duration, in seconds, that the record is valid (cached). Zero indicates that the record should not be cached. | ||
view string |
Sets the DNS view to associate this a record with. The DNS view must already be configured on the system
|
Notes
Note
- This module must be run locally, which can be achieved by specifying
connection: local
. - Please read the Infoblox Guide for more detailed information on how to use Infoblox with Ansible.
Examples
- name: Create a PTR Record
community.general.nios_ptr_record:
ipv4: 192.168.10.1
ptrdname: host.ansible.com
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: Delete a PTR Record
community.general.nios_ptr_record:
ipv4: 192.168.10.1
ptrdname: host.ansible.com
state: absent
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
Authors
- Trebuchet Clement (@clementtrebuchet)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/nios_ptr_record_module.html