#!/usr/bin/python # -*- coding: utf-8 -*- # # Ansible module to manage PaloAltoNetworks Firewall # (c) 2016, techbizdev # # This file is part of Ansible # # Ansible is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # Ansible is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with Ansible. If not, see . DOCUMENTATION = ''' --- module: panos_restart short_description: restart a device description: - Restart a device author: "Luigi Mori (@jtschichold), Ivan Bojer (@ivanbojer)" requirements: - pan-python deprecated: alternative: Use U(https://galaxy.ansible.com/PaloAltoNetworks/paloaltonetworks) instead. removed_in: "2.12" why: Consolidating code base. extends_documentation_fragment: - community.general.panos ''' EXAMPLES = ''' - panos_restart: ip_address: "192.168.1.1" username: "admin" password: "admin" ''' RETURN = ''' status: description: success status returned: success type: str sample: "okey dokey" ''' ANSIBLE_METADATA = {'metadata_version': '1.1', 'status': ['deprecated'], 'supported_by': 'community'} import sys import traceback try: import pan.xapi HAS_LIB = True except ImportError: HAS_LIB = False from ansible.module_utils.basic import AnsibleModule from ansible.module_utils._text import to_native def main(): argument_spec = dict( ip_address=dict(), password=dict(no_log=True), username=dict(default='admin') ) module = AnsibleModule(argument_spec=argument_spec, supports_check_mode=False) if not HAS_LIB: module.fail_json(msg='pan-python required for this module') ip_address = module.params["ip_address"] if not ip_address: module.fail_json(msg="ip_address should be specified") password = module.params["password"] if not password: module.fail_json(msg="password is required") username = module.params['username'] xapi = pan.xapi.PanXapi( hostname=ip_address, api_username=username, api_password=password ) try: xapi.op(cmd="") except Exception as e: if 'succeeded' in to_native(e): module.exit_json(changed=True, msg=to_native(e)) else: module.fail_json(msg=to_native(e), exception=traceback.format_exc()) module.exit_json(changed=True, msg="okey dokey") if __name__ == '__main__': main()