paloaltonetworks.panos.panos_registered_ip module – Register IP addresses for use with dynamic address groups on PAN-OS devices.
Note
This module is part of the paloaltonetworks.panos collection (version 3.1.1).
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install paloaltonetworks.panos
.
You need further requirements to be able to use this module,
see Requirements for details.
To use it in a playbook, specify: paloaltonetworks.panos.panos_registered_ip
.
New in paloaltonetworks.panos 1.0.0
Synopsis
Registers tags for IP addresses that can be used to build dynamic address groups.
Aliases: panos_dag_tags
Requirements
The below requirements are needed on the host that executes this module.
pan-python can be obtained from PyPI https://pypi.python.org/pypi/pan-python
pandevice can be obtained from PyPI https://pypi.python.org/pypi/pandevice
Parameters
Parameter |
Comments |
---|---|
Deprecated Use provider to specify PAN-OS connectivity instead. The API key to use instead of generating it using username / password. |
|
Deprecated Use provider to specify PAN-OS connectivity instead. The IP address or hostname of the PAN-OS device being configured. |
|
List of IP addresses to register/unregister. |
|
Deprecated Use provider to specify PAN-OS connectivity instead. The password to use for authentication. This is ignored if api_key is specified. |
|
Deprecated Use provider to specify PAN-OS connectivity instead. The port number to connect to the PAN-OS device on. Default: |
|
A dict object containing connection details. |
|
The API key to use instead of generating it using username / password. |
|
The IP address or hostname of the PAN-OS device being configured. |
|
The password to use for authentication. This is ignored if api_key is specified. |
|
The port number to connect to the PAN-OS device on. Default: |
|
The serial number of a firewall to use for targeted commands. If ip_address is not a Panorama PAN-OS device, then this param is ignored. |
|
The username to use for authentication. This is ignored if api_key is specified. Default: |
|
The state. Choices:
|
|
List of tags that the IP address will be registered to. |
|
Deprecated Use provider to specify PAN-OS connectivity instead. The username to use for authentication. This is ignored if api_key is specified. Default: |
|
The vsys this object belongs to. Default: |
Notes
Note
Check mode is supported.
PAN-OS connectivity should be specified using provider or the classic PAN-OS connectivity params (ip_address, username, password, api_key, and port). If both are present, then the classic params are ignored.
Examples
- name: Add 'First_Tag' tag to 1.1.1.1
paloaltonetworks.panos.panos_registered_ip:
provider: '{{ provider }}'
ips: ['1.1.1.1']
tags: ['First_Tag']
state: 'present'
- name: Add 'First_Tag' tag to 1.1.1.2
paloaltonetworks.panos.panos_registered_ip:
provider: '{{ provider }}'
ips: ['1.1.1.2']
tags: ['First_Tag']
state: 'present'
- name: Add 'Second_Tag' tag to 1.1.1.1
paloaltonetworks.panos.panos_registered_ip:
provider: '{{ provider }}'
ips: ['1.1.1.1']
tags: ['Second_Tag']
state: 'present'
- name: Remove 'Second_Tag' from 1.1.1.1
paloaltonetworks.panos.panos_registered_ip:
provider: '{{ provider }}'
ips: ['1.1.1.1']
tags: ['Second_Tag']
state: 'absent'
- name: Remove 'First_Tag' from 1.1.1.2 (will unregister entirely)
paloaltonetworks.panos.panos_registered_ip:
provider: '{{ provider }}'
ips: ['1.1.1.2']
tags: ['First_Tag']
state: 'absent'
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
After performing action, returns tags for given IPs. IP addresses as keys, tags as values. Returned: always Sample: |