paloaltonetworks / paloaltonetworks.panos / 2.19.1 / module / panos_object Manage address objects on PAN-OS devices. | "added in version" 1.0.0 of paloaltonetworks.panos" Authors: Michael Richardson (@mrichardson03), Garfield Lee Freeman (@shinmog)paloaltonetworks.panos.panos_object (2.19.1) — module
Install with ansible-galaxy collection install paloaltonetworks.panos:==2.19.1
collections: - name: paloaltonetworks.panos version: 2.19.1
Manage address objects on PAN-OS devices.
- name: Create object 'Test-One' paloaltonetworks.panos.panos_address_object: provider: '{{ provider }}' name: 'Test-One' value: '1.1.1.1' description: 'Description One' tag: ['Prod']
- name: Create object 'Test-Two' paloaltonetworks.panos.panos_address_object: provider: '{{ provider }}' name: 'Test-Two' address_type: 'ip-range' value: '1.1.1.1-2.2.2.2' description: 'Description Two' tag: ['SI']
- name: Create object 'Test-Three' paloaltonetworks.panos.panos_address_object: provider: '{{ provider }}' name: 'Test-Three' address_type: 'fqdn' value: 'foo.bar.baz' description: 'Description Three'
- name: Delete object 'Test-Two' paloaltonetworks.panos.panos_address_object: provider: '{{ provider }}' name: 'Test-Two' state: 'absent'
tag: description: - List of tags to add to this address object. elements: str type: list name: description: - Name of object to create. type: str port: default: 443 description: - B(Deprecated) - Use I(provider) to specify PAN-OS connectivity instead. - HORIZONTALLINE - The port number to connect to the PAN-OS device on. type: int vsys: default: vsys1 description: - The vsys this object belongs to. type: str state: choices: - present - absent - replaced - merged - deleted - gathered default: present description: - The state. type: str value: description: - IP address, IP range, or FQDN for the object. Must specify if state is I(present). type: str commit: description: - B(Deprecated) - Please use M(paloaltonetworks.panos.panos_commit_firewall), M(paloaltonetworks.panos.panos_commit_panorama), M(paloaltonetworks.panos.panos_commit_push) instead. - HORIZONTALLINE - Commit changes after creating object. If I(ip_address) is a Panorama device, and I(device_group) or I(template) are also set, perform a commit to Panorama and a commit-all to the device group/template. type: bool api_key: description: - B(Deprecated) - Use I(provider) to specify PAN-OS connectivity instead. - HORIZONTALLINE - The API key to use instead of generating it using I(username) / I(password). type: str password: description: - B(Deprecated) - Use I(provider) to specify PAN-OS connectivity instead. - HORIZONTALLINE - The password to use for authentication. This is ignored if I(api_key) is specified. type: str provider: description: - A dict object containing connection details. suboptions: api_key: description: - The API key to use instead of generating it using I(username) / I(password). type: str ip_address: description: - The IP address or hostname of the PAN-OS device being configured. type: str password: description: - The password to use for authentication. This is ignored if I(api_key) is specified. type: str port: default: 443 description: - The port number to connect to the PAN-OS device on. type: int serial_number: description: - The serial number of a firewall to use for targeted commands. If I(ip_address) is not a Panorama PAN-OS device, then this param is ignored. type: str username: default: admin description: - The username to use for authentication. This is ignored if I(api_key) is specified. type: str type: dict version_added: 1.0.0 version_added_collection: paloaltonetworks.panos username: default: admin description: - B(Deprecated) - Use I(provider) to specify PAN-OS connectivity instead. - HORIZONTALLINE - The username to use for authentication. This is ignored if I(api_key) is specified. type: str ip_address: description: - B(Deprecated) - Use I(provider) to specify PAN-OS connectivity instead. - HORIZONTALLINE - The IP address or hostname of the PAN-OS device being configured. type: str description: description: - Descriptive name for this address object. type: str address_type: choices: - ip-netmask - ip-range - fqdn - ip-wildcard default: ip-netmask description: - Type of address object. type: str device_group: default: shared description: - (Panorama only) The device group the operation should target. type: str gathered_filter: description: - When I(state=gathered). - An advanced filtering option to filter results returned from PAN-OS. - Refer to the guide discussing I(gathered_filter) for more information. type: str