panos_import - import file on PAN-OS devices

New in version 2.3.

Synopsis

Requirements

The below requirements are needed on the host that executes this module.

  • pan-python
  • requests
  • requests_toolbelt

Parameters

Parameter Choices/Defaults Comments
category Default:
software
Category of file uploaded. The default is software.
See API > Import section of the API reference for category options.
file
Location of the file to import into device.
ip_address
required
IP address (or hostname) of PAN-OS device.
password
required
Password for authentication.
url
URL of the file that will be imported to device.
username Default:
admin
Username for authentication.
validate_certs
bool

(added in 2.6)
    Choices:
  • no
  • yes ←
If no, SSL certificates will not be validated. Disabling certificate validation is not recommended.

Notes

Note

  • API reference documentation can be read from the /api/ directory of your appliance
  • Certificate validation is enabled by default as of Ansible 2.6. This may break existing playbooks but should be disabled with caution.

Examples

# import software image PanOS_vm-6.1.1 on 192.168.1.1
- name: import software image into PAN-OS
  panos_import:
    ip_address: 192.168.1.1
    username: admin
    password: admin
    file: /tmp/PanOS_vm-6.1.1
    category: software

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Maintenance

This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.

For a list of other modules that are also maintained by the Ansible Community, see here.

Author

  • Luigi Mori (@jtschichold), Ivan Bojer (@ivanbojer)

Hint

If you notice any issues in this documentation you can edit this document to improve it.