bigip_monitor_http - Manages F5 BIG-IP LTM http monitors

Author:Serge van Ginderachter

Synopsis

New in version 1.4.

Manages F5 BIG-IP LTM monitors via iControl SOAP API

Options

parameter required default choices comments
interval no none
    The interval specifying how frequently the monitor instance of this template will run. By default, this interval is used for up and down states. The default API setting is 5.
    ip no none
      IP address part of the ipport definition. The default API setting is "0.0.0.0".
      name yes
        Monitor name
        parent no http
          The parent template of this monitor template
          parent_partition no Common
            Partition for the parent monitor
            partition no Common
              Partition for the monitor
              password yes
                BIG-IP password
                port no none
                  port address part op the ipport definition. Tyhe default API setting is 0.
                  receive yes none
                    The receive string for the monitor call
                    receive_disable yes none
                      The receive disable string for the monitor call
                      send yes none
                        The send string for the monitor call
                        server yes
                          BIG-IP host
                          state no present
                          • present
                          • absent
                          Monitor state
                          time_until_up no none
                            Specifies the amount of time in seconds after the first successful response before a node will be marked up. A value of 0 will cause a node to be marked up immediately after a valid response is received from the node. The default API setting is 0.
                            timeout no none
                              The number of seconds in which the node or service must respond to the monitor request. If the target responds within the set time period, it is considered up. If the target does not respond within the set time period, it is considered down. You can change this number to any number you want, however, it should be 3 times the interval number of seconds plus 1 second. The default API setting is 16.
                              user yes
                                BIG-IP username

                                Note

                                Requires bigsuds

                                Examples


                                - name: BIGIP F5 | Create HTTP Monitor
                                  local_action:
                                    module:             bigip_monitor_http
                                    state:              present
                                    server:             "{{ f5server }}"
                                    user:               "{{ f5user }}"
                                    password:           "{{ f5password }}"
                                    name:               "{{ item.monitorname }}"
                                    send:               "{{ item.send }}"
                                    receive:            "{{ item.receive }}"
                                  with_items: f5monitors
                                - name: BIGIP F5 | Remove HTTP Monitor
                                  local_action:
                                    module:             bigip_monitor_http
                                    state:              absent
                                    server:             "{{ f5server }}"
                                    user:               "{{ f5user }}"
                                    password:           "{{ f5password }}"
                                    name:               "{{ monitorname }}"
                                

                                Note

                                Requires BIG-IP software version >= 11

                                Note

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

                                Note

                                Best run as a local_action in your playbook