Documentation

panos_lic - apply authcode to a device/instance

New in version 2.3.

Synopsis

  • Apply an authcode to a device.
  • The authcode should have been previously registered on the Palo Alto Networks support portal.
  • The device should have Internet access.

Requirements

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

  • pan-python

Parameters

Parameter Choices/Defaults Comments
auth_code
required
authcode to be applied
force Default:
false
whether to apply authcode even if device is already licensed
ip_address
required
IP address (or hostname) of PAN-OS device.
password
required
Password for authentication.
username Default:
admin
Username for authentication.

Examples

- hosts: localhost
  connection: local
  tasks:
    - name: fetch license
      panos_lic:
        ip_address: "192.168.1.1"
        password: "paloalto"
        auth_code: "IBADCODE"
      register: result
- name: Display serialnumber (if already registered)
  debug:
    var: "{{result.serialnumber}}"

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
serialnumber
string
success
serialnumber of the device in case that it has been already registered

Sample:
973080716


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.