diff options
Diffstat (limited to 'lib/ansible')
| -rw-r--r-- | lib/ansible/modules/net_tools/nios/nios_naptr_record.py | 191 |
1 files changed, 191 insertions, 0 deletions
diff --git a/lib/ansible/modules/net_tools/nios/nios_naptr_record.py b/lib/ansible/modules/net_tools/nios/nios_naptr_record.py new file mode 100644 index 0000000000..e50955a6a2 --- /dev/null +++ b/lib/ansible/modules/net_tools/nios/nios_naptr_record.py @@ -0,0 +1,191 @@ +#!/usr/bin/python +# Copyright (c) 2018 Red Hat, Inc. +# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt) + +from __future__ import absolute_import, division, print_function +__metaclass__ = type + +ANSIBLE_METADATA = {'metadata_version': '1.1', + 'status': ['preview'], + 'supported_by': 'community'} + + +DOCUMENTATION = ''' +--- +module: nios_naptr_record +version_added: "2.6" +author: "Blair Rampling (@brampling)" +short_description: Configure Infoblox NIOS NAPTR records +description: + - Adds and/or removes instances of NAPTR record objects from + Infoblox NIOS servers. This module manages NIOS C(record:naptr) objects + using the Infoblox WAPI interface over REST. +requirements: + - infoblox_client +extends_documentation_fragment: nios +options: + name: + description: + - Specifies the fully qualified hostname to add or remove from + the system + required: true + view: + description: + - Sets the DNS view to associate this a record with. The DNS + view must already be configured on the system + required: true + default: default + aliases: + - dns_view + order: + description: + - Configures the order (0-65535) for this NAPTR record. This parameter + specifies the order in which the NAPTR rules are applied when + multiple rules are present. + required: true + preference: + description: + - Configures the preference (0-65535) for this NAPTR record. The + preference field determines the order NAPTR records are processed + when multiple records with the same order parameter are present. + required: true + replacement: + description: + - Configures the replacement field for this NAPTR record. + For nonterminal NAPTR records, this field specifies the + next domain name to look up. + required: true + services: + description: + - Configures the services field (128 characters maximum) for this + NAPTR record. The services field contains protocol and service + identifiers, such as "http+E2U" or "SIPS+D2T". + required: false + flags: + description: + - Configures the flags field for this NAPTR record. These control the + interpretation of the fields for an NAPTR record object. Supported + values for the flags field are "U", "S", "P" and "A". + required: false + regexp: + description: + - Configures the regexp field for this NAPTR record. This is the + regular expression-based rewriting rule of the NAPTR record. This + should be a POSIX compliant regular expression, including the + substitution rule and flags. Refer to RFC 2915 for the field syntax + details. + required: false + ttl: + description: + - Configures the TTL to be associated with this NAPTR record + extattrs: + description: + - Allows for the configuration of Extensible Attributes on the + instance of the object. This argument accepts a set of key / value + pairs for configuration. + comment: + description: + - 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. + state: + description: + - Configures the intended state of the instance of the object on + the NIOS server. When this value is set to C(present), the object + is configured on the device and when this value is set to C(absent) + the value is removed (if necessary) from the device. + default: present + choices: + - present + - absent +''' + +EXAMPLES = ''' +- name: configure a NAPTR record + nios_naptr_record: + name: '*.subscriber-100.ansiblezone.com' + order: 1000 + preference: 10 + replacement: replacement1.network.ansiblezone.com + state: present + provider: + host: "{{ inventory_hostname_short }}" + username: admin + password: admin + connection: local + +- name: add a comment to an existing NAPTR record + nios_naptr_record: + name: '*.subscriber-100.ansiblezone.com' + order: 1000 + preference: 10 + replacement: replacement1.network.ansiblezone.com + comment: this is a test comment + state: present + provider: + host: "{{ inventory_hostname_short }}" + username: admin + password: admin + connection: local + +- name: remove a NAPTR record from the system + nios_naptr_record: + name: '*.subscriber-100.ansiblezone.com' + order: 1000 + preference: 10 + replacement: replacement1.network.ansiblezone.com + state: absent + provider: + host: "{{ inventory_hostname_short }}" + username: admin + password: admin + connection: local +''' + +RETURN = ''' # ''' + +from ansible.module_utils.basic import AnsibleModule +from ansible.module_utils.six import iteritems +from ansible.module_utils.net_tools.nios.api import WapiModule + + +def main(): + ''' Main entry point for module execution + ''' + + ib_spec = dict( + name=dict(required=True, ib_req=True), + view=dict(default='default', aliases=['dns_view'], ib_req=True), + + order=dict(type='int', ib_req=True), + preference=dict(type='int', ib_req=True), + replacement=dict(ib_req=True), + services=dict(), + flags=dict(), + regexp=dict(), + + ttl=dict(type='int'), + + extattrs=dict(type='dict'), + comment=dict(), + ) + + argument_spec = dict( + provider=dict(required=True), + state=dict(default='present', choices=['present', 'absent']) + ) + + argument_spec.update(ib_spec) + argument_spec.update(WapiModule.provider_spec) + + module = AnsibleModule(argument_spec=argument_spec, + supports_check_mode=True) + + wapi = WapiModule(module) + result = wapi.run('record:naptr', ib_spec) + + module.exit_json(**result) + + +if __name__ == '__main__': + main() |