panos_op - execute arbitrary OP commands on PANW devices (e.g. show interface all)¶
New in version 2.5.
Synopsis¶
- This module will allow user to pass and execute any supported OP command on the PANW device.
Requirements¶
The below requirements are needed on the host that executes this module.
- pan-python can be obtained from PyPi https://pypi.org/project/pan-python/
- pandevice can be obtained from PyPi https://pypi.org/project/pandevice/
Parameters¶
Parameter | Choices/Defaults | Comments |
---|---|---|
api_key |
API key that can be used instead of username/password credentials.
|
|
cmd
required |
The OP command to be performed.
|
|
ip_address
required |
IP address (or hostname) of PAN-OS device or Panorama management console being configured.
|
|
password
required |
Password credentials to use for authentication.
|
|
username |
Default: admin
|
Username credentials to use for authentication.
|
Examples¶
- name: show list of all interfaces
panos_op:
ip_address: '{{ ip_address }}'
username: '{{ username }}'
password: '{{ password }}'
cmd: 'show interfaces all'
- name: show system info
panos_op:
ip_address: '{{ ip_address }}'
username: '{{ username }}'
password: '{{ password }}'
cmd: 'show system info'
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
stdout
string
|
success |
output of the given OP command as JSON formatted string
Sample:
{system: {app-release-date: 2017/05/01 15:09:12}}
|
stdout_xml
string
|
success |
output of the given OP command as JSON formatted string
Sample:
<response status=success><result><system><hostname>fw2</hostname>
|
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¶
- Ivan Bojer (@ivanbojer)
Hint
If you notice any issues in this documentation you can edit this document to improve it.