ANSIBLE.BIGIP_POOL_MEMBER(3)    ANSIBLE MODULES   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



1.4.5                             2014-02-12      ANSIBLE.BIGIP_POOL_MEMBER(3)
