#!/usr/bin/python # -*- coding: utf-8 -*- # Copyright (c) 2018, Juergen Wiebe # GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt) # SPDX-License-Identifier: GPL-3.0-or-later from __future__ import absolute_import, division, print_function __metaclass__ = type DOCUMENTATION = ''' --- module: utm_network_interface_address author: - Juergen Wiebe (@steamx) short_description: Create, update or destroy network/interface_address object description: - Create, update or destroy a network/interface_address object in SOPHOS UTM. - This module needs to have the REST Ability of the UTM to be activated. options: name: type: str description: - The name of the object. Will be used to identify the entry required: true address: type: str description: - The ip4 address of the network/interface_address object. required: true address6: type: str description: - The ip6 address of the network/interface_address object. required: false comment: type: str description: - An optional comment to add to the object default: '' resolved: type: bool description: - Whether or not the object is resolved resolved6: type: bool description: - Whether or not the object is resolved extends_documentation_fragment: - community.general.utm ''' EXAMPLES = """ - name: Create a network interface address utm_proxy_backend: utm_host: sophos.host.name utm_token: abcdefghijklmno1234 name: TestNetworkInterfaceAddress address: 0.0.0.0 state: present - name: Remove a network interface address network_interface_address: utm_host: sophos.host.name utm_token: abcdefghijklmno1234 name: TestNetworkInterfaceAddress address: 0.0.0.0 state: absent """ RETURN = """ result: description: The utm object that was created returned: success type: complex contains: _ref: description: The reference name of the object type: str _locked: description: Whether or not the object is currently locked type: bool _type: description: The type of the object type: str name: description: The name of the object type: str address: description: The ip4 address of the network/interface_address object type: str address6: description: The ip6 address of the network/interface_address object type: str comment: description: The comment string type: str resolved: description: Whether or not the object is resolved type: bool resolved6: description: Whether or not the object is resolved type: bool """ from ansible_collections.community.general.plugins.module_utils.utm_utils import UTM, UTMModule from ansible.module_utils.common.text.converters import to_native def main(): endpoint = "network/interface_address" key_to_check_for_changes = ["comment", "address"] module = UTMModule( argument_spec=dict( name=dict(type='str', required=True), address=dict(type='str', required=True), comment=dict(type='str', required=False, default=""), address6=dict(type='str', required=False), resolved=dict(type='bool', required=False), resolved6=dict(type='bool', required=False), ) ) try: UTM(module, endpoint, key_to_check_for_changes).execute() except Exception as e: module.fail_json(msg=to_native(e)) if __name__ == '__main__': main()