ANSIBLE.BIGIP_POOL_MEMBER(3)

NAME
bigip_pool_member - Manages F5 BIG-IP LTM pool members

DESCRIPTION

Manages F5 BIG-IP LTM pool members via iControl SOAP API

OPTIONS

connection_limit
    Pool member connection limit. Setting this to 0 disables the limit.

description
    Pool member description

host
    Pool member IP(required)

partition
    Partition (default: Common)

password
    BIG-IP password(required)

pool
    Pool name. This pool must exist.(required)

port
    Pool member port(required)

rate_limit
    Pool member rate limit (connections-per-second). Setting this to 0 disables the limit.

ratio
    Pool member ratio weight. Valid values range from 1 through 100. New pool members -- unless overriden with this value -- default to 1.

server
    BIG-IP host(required)

state
    Pool member state Choices: present,absent.(required) (default: present)

user
    BIG-IP username(required).

NOTES

Requires BIG-IP software version >= 11

F5 developed module 'bigsuds' required (see http://devcentral.f5.com)

Best run as a local_action in your playbook

Supersedes bigip_pool for managing pool members

EXAMPLES
## playbook task examples:
---
# file bigip-test.yml
# ...
- hosts: bigip-test
  tasks:
  - name: Add pool member
    local_action: >
      bigip_pool_member
      server=lb.mydomain.com
      user=admin
      password=mysecret
      state=present
      pool=matthite-pool
      partition=matthite
      host="{{ ansible_default_ipv4["address"] }}"
      port=80
      description="web server"
      connection_limit=100
      rate_limit=50
      ratio=2
  - name: Modify pool member ratio and description
    local_action: >
      bigip_pool_member
      server=lb.mydomain.com
      user=admin
      password=mysecret
      state=present
      pool=matthite-pool
      partition=matthite
      host="{{ ansible_default_ipv4["address"] }}"
      port=80
      ratio=1
      description="nginx server"
  - name: Remove pool member from pool
    local_action: >
      bigip_pool_member
      server=lb.mydomain.com
      user=admin
      password=mysecret
      state=absent
      pool=matthite-pool
      partition=matthite
      host="{{ ansible_default_ipv4["address"] }}"
      port=80

AUTHOR
Matt Hite

SEE ALSO
ansible(1), http://ansible.github.com/modules.html#bigip-pool-member