community / community.network / 0.1.0 / module / bigip_security_port_list Manage port lists on BIG-IP AFM Authors: Tim Rupp (@caphrim007), Wojciech Wypior (@wojtek0806)community.network.bigip_security_port_list (0.1.0) — module
Install with ansible-galaxy collection install community.network:==0.1.0
collections: - name: community.network version: 0.1.0
Manages the AFM port lists on a BIG-IP. This module can be used to add and remove port list entries.
- name: Create a simple port list bigip_firewall_port_list: name: foo ports: - 80 - 443 state: present provider: password: secret server: lb.mydomain.com user: admin delegate_to: localhost
- name: Override the above list of ports with a new list bigip_firewall_port_list: name: foo ports: - 3389 - 8080 - 25 state: present provider: password: secret server: lb.mydomain.com user: admin delegate_to: localhost
- name: Create port list with series of ranges bigip_firewall_port_list: name: foo port_ranges: - 25-30 - 80-500 - 50-78 state: present provider: password: secret server: lb.mydomain.com user: admin delegate_to: localhost
- name: Use multiple types of port arguments bigip_firewall_port_list: name: foo port_ranges: - 25-30 - 80-500 - 50-78 ports: - 8080 - 443 state: present provider: password: secret server: lb.mydomain.com user: admin delegate_to: localhost
- name: Remove port list bigip_firewall_port_list: name: foo state: absent provider: password: secret server: lb.mydomain.com user: admin delegate_to: localhost
- name: Create port list from a file with one port per line bigip_firewall_port_list: name: lot-of-ports ports: "{{ lookup('file', 'my-large-port-list.txt').split('\n') }}" state: present provider: password: secret server: lb.mydomain.com user: admin delegate_to: localhost
name: description: - Specifies the name of the port list. required: true type: str ports: description: - Simple list of port values to add to the list type: list state: choices: - present - absent default: present description: - When C(present), ensures that the address list and entries exists. - When C(absent), ensures the address list is removed. type: str provider: description: - A dict object containing connection details. suboptions: auth_provider: description: - Configures the auth provider for to obtain authentication tokens from the remote device. - This option is really used when working with BIG-IQ devices. type: str password: aliases: - pass - pwd description: - The password for the user account used to connect to the BIG-IP. - You may omit this option by setting the environment variable C(F5_PASSWORD). required: true type: str server: description: - The BIG-IP host. - You may omit this option by setting the environment variable C(F5_SERVER). required: true type: str server_port: default: 443 description: - The BIG-IP server port. - You may omit this option by setting the environment variable C(F5_SERVER_PORT). type: int ssh_keyfile: description: - Specifies the SSH keyfile to use to authenticate the connection to the remote device. This argument is only used for I(cli) transports. - You may omit this option by setting the environment variable C(ANSIBLE_NET_SSH_KEYFILE). type: path timeout: description: - Specifies the timeout in seconds for communicating with the network device for either connecting or sending commands. If the timeout is exceeded before the operation is completed, the module will error. type: int transport: choices: - cli - rest default: rest description: - Configures the transport connection to use when connecting to the remote device. type: str user: description: - The username to connect to the BIG-IP with. This user must have administrative privileges on the device. - You may omit this option by setting the environment variable C(F5_USER). required: true type: str validate_certs: default: true description: - If C(no), SSL certificates are not validated. Use this only on personally controlled sites using self-signed certificates. - You may omit this option by setting the environment variable C(F5_VALIDATE_CERTS). type: bool type: dict partition: default: Common description: - Device partition to manage resources on. type: str port_lists: description: - Simple list of existing port lists to add to this list. Port lists can be specified in either their fully qualified name (/Common/foo) or their short name (foo). If a short name is used, the C(partition) argument will automatically be prepended to the short name. type: list description: description: - Description of the port list type: str port_ranges: description: - A list of port ranges where the range starts with a port number, is followed by a dash (-) and then a second number. - If the first number is greater than the second number, the numbers will be reversed so-as to be properly formatted. ie, 90-78 would become 78-90. type: list
description: description: The new description of the port list. returned: changed sample: My port list type: str port_lists: description: The new list of port list names applied to the port list. returned: changed sample: - /Common/list1 - /Common/list2 type: list port_ranges: description: The new list of port ranges applied to the port list. returned: changed sample: - 80-100 - 200-8080 type: list ports: description: The new list of ports applied to the port list. returned: changed sample: - 80 - 443 type: list