Class: IControl::GlobalLB::Monitor

Inherits:
Base
  • Object
show all
Defined in:
lib/icontrol/global_lb/monitor.rb,
lib/icontrol/global_lb.rb

Overview

The Monitor interface enables you to manipulate a load balancer’s monitor templates and instances. For example, use the Monitor interface to enable or disable a monitor instance, or to create a monitor template, or to get and set different attributes of a monitor template.

Defined Under Namespace

Classes: CommonAttributes, CommonAttributesSequence, IntPropertyType, IntPropertyTypeSequence, IntegerValue, IntegerValueSequence, MonitorTemplate, MonitorTemplateSequence, StrPropertyType, StrPropertyTypeSequence, StringValue, StringValueSequence, TemplateType, TemplateTypeSequence, UserDefinedStringValue, UserDefinedStringValueSequence

Instance Method Summary collapse

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class IControl::Base

Instance Method Details

#create_template(opts) ⇒ Object

Creates monitor template with some basic attributes. If the "parent_template“ attribute in "template_attributes” is empty, then the new template is based on the template type field given in "template“. If the "parent_template” attribute in "template_attributes“ is specified, then the new template is derived from the "parent_template”, and template type field in "template“ is ignored. If "parent_template” is empty, and the template type field in "template“ is not specified, then the new template is a root template.

Parameters:

  • opts (Hash)

Options Hash (opts):

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



44
45
46
47
 
# File 'lib/icontrol/global_lb/monitor.rb', line 44

def create_template(opts)
  opts = check_params(opts,[:templates,:template_attributes])
  super(opts)
end

#delete_all_templates ⇒ Object

Deletes all user-defined (non-root) monitor template.

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



55
56
57
 
# File 'lib/icontrol/global_lb/monitor.rb', line 55

def delete_all_templates
  super
end

#delete_template ⇒ Object

Deletes this monitor template.

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



65
66
67
 
# File 'lib/icontrol/global_lb/monitor.rb', line 65

def delete_template
  super
end

#ignore_down_response_state ⇒ EnabledState

Gets the monitor template’ ignore down response states. When enabled, the system will mark objects down only if the monitor timer expires without receiving an "up“ response.

Returns:

  • (EnabledState)

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



78
79
80
 
# File 'lib/icontrol/global_lb/monitor.rb', line 78

def ignore_down_response_state
  super
end

#instance_state(opts) ⇒ MonitorInstanceState

Gets the enabled/disabled states of the monitor instances.

Parameters:

  • opts (Hash)

Options Hash (opts):

Returns:

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



91
92
93
94
 
# File 'lib/icontrol/global_lb/monitor.rb', line 91

def instance_state(opts)
  opts = check_params(opts,[:instances])
  super(opts)
end

#is_template_directly_usable ⇒ boolean

Determines if this monitor template can be used directly, or a user-defined monitor based on each monitor must be created first before it can be used.

Returns:

  • (boolean)

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



258
259
260
 
# File 'lib/icontrol/global_lb/monitor.rb', line 258

def is_template_directly_usable
  super
end

#is_template_read_only ⇒ boolean

Determines if this monitor template are read-only. The user can only modify properties for read/write monitor template.

Returns:

  • (boolean)

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



270
271
272
 
# File 'lib/icontrol/global_lb/monitor.rb', line 270

def is_template_read_only
  super
end

#is_template_root ⇒ boolean

Determines if this monitor template are of the base monitor template.

Returns:

  • (boolean)

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



281
282
283
 
# File 'lib/icontrol/global_lb/monitor.rb', line 281

def is_template_root
  super
end

#manual_resume_state ⇒ EnabledState

Gets the monitor template’ manual resume states. When enabled and a monitor has marked an object down, that object will not be marked up by the monitor, i.e. the object will be manually marked up.

Returns:

  • (EnabledState)

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



105
106
107
 
# File 'lib/icontrol/global_lb/monitor.rb', line 105

def manual_resume_state
  super
end

#parent_template ⇒ String

Gets the parent monitor template from which this monitor template are derived. A user-defined monitor template will get its defaults from its parent monitor template.

Returns:

  • (String)

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



117
118
119
 
# File 'lib/icontrol/global_lb/monitor.rb', line 117

def parent_template
  super
end

#set_ignore_down_response_state(opts) ⇒ Object

Sets the monitor template’ ignore down response states. When enabled, the system will mark objects down only if the monitor timer expires without receiving an "up“ response. This is useful because probe_num_probes is not effective with ECV monitors. To get similar functionality, enable ignore down response, and set timeout and probe timeout.

Parameters:

  • opts (Hash)

Options Hash (opts):

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



297
298
299
300
 
# File 'lib/icontrol/global_lb/monitor.rb', line 297

def set_ignore_down_response_state(opts)
  opts = check_params(opts,[:states])
  super(opts)
end

#set_instance_state(opts) ⇒ Object

Sets the enabled/disabled states of the monitor instances.

Parameters:

  • opts (Hash)

Options Hash (opts):

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



310
311
312
313
 
# File 'lib/icontrol/global_lb/monitor.rb', line 310

def set_instance_state(opts)
  opts = check_params(opts,[:instance_states])
  super(opts)
end

#set_manual_resume_state(opts) ⇒ Object

Sets the monitor template’ manual resume states. When enabled and a monitor has marked an object down, that object will not be marked up by the monitor, i.e. the object will be manually marked up.

Parameters:

  • opts (Hash)

Options Hash (opts):

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



325
326
327
328
 
# File 'lib/icontrol/global_lb/monitor.rb', line 325

def set_manual_resume_state(opts)
  opts = check_params(opts,[:states])
  super(opts)
end

#set_template_destination(opts) ⇒ Object

Sets the destination IP:port values for this template. NOTE: This should only be done when the monitor template in "template_names“ have NOT been associated to any node addresses or pool members.

Parameters:

  • opts (Hash)

Options Hash (opts):

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



340
341
342
343
 
# File 'lib/icontrol/global_lb/monitor.rb', line 340

def set_template_destination(opts)
  opts = check_params(opts,[:destinations])
  super(opts)
end

#set_template_integer_property(opts) ⇒ Object

Sets an integer property values of this monitor template.

Parameters:

  • opts (Hash)

Options Hash (opts):

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



353
354
355
356
 
# File 'lib/icontrol/global_lb/monitor.rb', line 353

def set_template_integer_property(opts)
  opts = check_params(opts,[:values])
  super(opts)
end

#set_template_reverse_mode(opts) ⇒ Object

Sets the reverse mode states of this monitor template. When in reverse mode, a successful test marks the node down instead of up.

Parameters:

  • opts (Hash)

Options Hash (opts):

  • :reverse_modes (boolean) —

    The reverse mode states of the monitor templates.

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



367
368
369
370
 
# File 'lib/icontrol/global_lb/monitor.rb', line 367

def set_template_reverse_mode(opts)
  opts = check_params(opts,[:reverse_modes])
  super(opts)
end

#set_template_state(opts) ⇒ Object

Sets the monitor template’ enabled/disabled states. This will enable/disable all instances that use this template. This serves as a quick and convenient method to enable/disable all instances, but if you want only to enable/disable a specific instance, use set_instance_enabled.

Parameters:

  • opts (Hash)

Options Hash (opts):

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



383
384
385
386
 
# File 'lib/icontrol/global_lb/monitor.rb', line 383

def set_template_state(opts)
  opts = check_params(opts,[:states])
  super(opts)
end

#set_template_string_property(opts) ⇒ Object

Sets a string property values of this monitor template.

Parameters:

  • opts (Hash)

Options Hash (opts):

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



396
397
398
399
 
# File 'lib/icontrol/global_lb/monitor.rb', line 396

def set_template_string_property(opts)
  opts = check_params(opts,[:values])
  super(opts)
end

#set_template_transparent_mode(opts) ⇒ Object

Sets the transparent mode states of this monitor template. Transparent mode is used when a user has to go through a firewall to do monitoring.

Parameters:

  • opts (Hash)

Options Hash (opts):

  • :transparent_modes (boolean) —

    The transparent mode states of the monitor templates.

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



410
411
412
413
 
# File 'lib/icontrol/global_lb/monitor.rb', line 410

def set_template_transparent_mode(opts)
  opts = check_params(opts,[:transparent_modes])
  super(opts)
end

#set_template_user_defined_string_property(opts) ⇒ Object

Sets the user-defined string property values of this monitor template.

Parameters:

  • opts (Hash)

Options Hash (opts):

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



423
424
425
426
 
# File 'lib/icontrol/global_lb/monitor.rb', line 423

def set_template_user_defined_string_property(opts)
  opts = check_params(opts,[:values])
  super(opts)
end

#template_address_type ⇒ AddressType

Gets the destination address types of the monitor template. This allows the user to determine what node IP:port can be associated with this monitor when creating a monitor instance.

Returns:

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



130
131
132
 
# File 'lib/icontrol/global_lb/monitor.rb', line 130

def template_address_type
  super
end

#template_destination ⇒ MonitorIPPort

Gets the destination IP:port values of this monitor template.

Returns:

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



141
142
143
 
# File 'lib/icontrol/global_lb/monitor.rb', line 141

def template_destination
  super
end

#template_integer_property(opts) ⇒ IntegerValue

Gets the integer property values of this monitor template.

Parameters:

  • opts (Hash)

Options Hash (opts):

Returns:

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



154
155
156
157
 
# File 'lib/icontrol/global_lb/monitor.rb', line 154

def template_integer_property(opts)
  opts = check_params(opts,[:property_types])
  super(opts)
end

#template_list ⇒ MonitorTemplate

Gets the list of monitor template.

Returns:

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



166
167
168
 
# File 'lib/icontrol/global_lb/monitor.rb', line 166

def template_list
  super
end

#template_reverse_mode ⇒ boolean

Gets the reverse mode states of this monitor template.

Returns:

  • (boolean)

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



177
178
179
 
# File 'lib/icontrol/global_lb/monitor.rb', line 177

def template_reverse_mode
  super
end

#template_state ⇒ EnabledState

Gets the enabled/disabled states of this monitor template.

Returns:

  • (EnabledState)

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



188
189
190
 
# File 'lib/icontrol/global_lb/monitor.rb', line 188

def template_state
  super
end

#template_string_property(opts) ⇒ StringValue

Gets a string property values of this monitor template.

Parameters:

  • opts (Hash)

Options Hash (opts):

Returns:

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



201
202
203
204
 
# File 'lib/icontrol/global_lb/monitor.rb', line 201

def template_string_property(opts)
  opts = check_params(opts,[:property_types])
  super(opts)
end

#template_transparent_mode ⇒ boolean

Gets the transparent mode states of this monitor template.

Returns:

  • (boolean)

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



213
214
215
 
# File 'lib/icontrol/global_lb/monitor.rb', line 213

def template_transparent_mode
  super
end

#template_type ⇒ TemplateType

Gets the template types of this monitor template.

Returns:

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



224
225
226
 
# File 'lib/icontrol/global_lb/monitor.rb', line 224

def template_type
  super
end

#template_user_defined_string_property(opts) ⇒ UserDefinedStringValue

Gets the string property values of this monitor template.

Parameters:

  • opts (Hash)

Options Hash (opts):

  • :property_names (String) —

    The user-defined string property names from which to get values for the monitor templates.

Returns:

Raises:

  • (IControl::IControl::Common::AccessDenied) —

    raised if the client credentials are not valid.

  • (IControl::IControl::Common::InvalidArgument) —

    raised if one of the arguments is invalid.

  • (IControl::IControl::Common::OperationFailed) —

    raised if an operation error occurs.



237
238
239
240
 
# File 'lib/icontrol/global_lb/monitor.rb', line 237

def template_user_defined_string_property(opts)
  opts = check_params(opts,[:property_names])
  super(opts)
end

#version ⇒ String

Gets the version information for this interface.

Returns:

  • (String) 


246
247
248
 
# File 'lib/icontrol/global_lb/monitor.rb', line 246

def version
  super
end