panos_dag_tags – Create tags for DAG’s on PAN-OS devices.

From Get docs
Ansible/docs/2.7/modules/panos dag tags module


panos_dag_tags – Create tags for DAG’s on PAN-OS devices.

New in version 2.5.


Synopsis

  • Create the ip address to tag associations. Tags will in turn be used to create DAG’s

Requirements

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

Parameters

Parameter Choices/Defaults Comments

api_key

-

API key that can be used instead of username/password credentials.

commit

-

Default:

"yes"

commit if changed

description

-

The purpose / objective of the static Address Group

devicegroup

-

- Device groups are used for the Panorama interaction with Firewall(s). The group must exists on Panorama. If device group is not define we assume that we are contacting Firewall.

ip_address

- / required

IP address (or hostname) of PAN-OS device.

ip_to_register

-

IP that will be registered with the given tag names.

operation

-

The action to be taken. Supported values are add/update/find/delete.

password

- / required

Password for authentication.

tag_names

-

The list of the tags that will be added or removed from the IP address.

username

-

Default:

"admin"

Username for authentication.



Notes

Note

  • Checkmode is not supported.
  • Panorama is not supported.


Examples

- name: Create the tags to map IP addresses
  panos_dag_tags:
    ip_address: "{{ ip_address }}"
    password: "{{ password }}"
    ip_to_register: "{{ ip_to_register }}"
    tag_names: "{{ tag_names }}"
    description: "Tags to allow certain IP's to access various SaaS Applications"
    operation: 'add'
  tags: "adddagip"

- name: List the IP address to tag mapping
  panos_dag_tags:
    ip_address: "{{ ip_address }}"
    password: "{{ password }}"
    tag_names: "{{ tag_names }}"
    description: "List the IP address to tag mapping"
    operation: 'list'
  tags: "listdagip"

- name: Unregister an IP address from a tag mapping
  panos_dag_tags:
    ip_address: "{{ ip_address }}"
    password: "{{ password }}"
    ip_to_register: "{{ ip_to_register }}"
    tag_names: "{{ tag_names }}"
    description: "Unregister IP address from tag mappings"
    operation: 'delete'
  tags: "deletedagip"

Status

Authors

  • Vinay Venkataraghavan (@vinayvenkat)

Hint

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


© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/panos_dag_tags_module.html