4.5.5.1. Monitor

class dyn.tm.services.gslb.Monitor(protocol, interval, retries=None, timeout=None, port=None, path=None, host=None, header=None, expected=None)[source]

A Monitor for a GSLB Service

__init__(protocol, interval, retries=None, timeout=None, port=None, path=None, host=None, header=None, expected=None)[source]

Create a Monitor object

Parameters:
  • protocol – The protocol to monitor. Must be either HTTP, HTTPS, PING, SMTP, or TCP
  • interval – How often (in minutes) to run the monitor. Must be 1, 5, 10, or 15,
  • retries – The number of retries the monitor attempts on failure before giving up
  • timeout – The amount of time in seconds before the connection attempt times out
  • port – For HTTP(S)/SMTP/TCP probes, an alternate connection port
  • path – For HTTP(S) probes, a specific path to request
  • host – For HTTP(S) probes, a value to pass in to the Host
  • header – For HTTP(S) probes, additional header fields/values to pass in, separated by a newline character.
  • expected – For HTTP(S) probes, a string to search for in the response. For SMTP probes, a string to compare the banner against. Failure to find this string means the monitor will report a down status.
expected

For HTTP(S) probes, a string to search for in the response. For SMTP probes, a string to compare the banner against. Failure to find this string means the monitor will report a down status

header

For HTTP(S) probes, additional header fields/values to pass in, separated by a newline character

host

For HTTP(S) probes, a value to pass in to the Host

interval

How often to run this monitor

path

For HTTP(S) probes, a specific path to request

port

For HTTP(S)/SMTP/TCP probes, an alternate connection port

protocol

The protocol to monitor

retries

The number of retries the monitor attempts on failure before giving up

status

Get the current status of this HealthMonitor from the DynECT System

timeout

The amount of time in seconds before the connection attempt times out

to_json()[source]

Convert this HealthMonitor object to a JSON blob

4.5.5.2. GSLBRegionPoolEntry

class dyn.tm.services.gslb.GSLBRegionPoolEntry(zone, fqdn, region_code, address, *args, **kwargs)[source]

GSLBRegionPoolEntry

__init__(zone, fqdn, region_code, address, *args, **kwargs)[source]

Create a GSLBRegionPoolEntry object

Parameters:
  • zone – Zone monitored by this GSLBRegionPoolEntry
  • fqdn – The fqdn of the specific node which will be monitored by this GSLBRegionPoolEntry
  • region_code – ISO Region Code for this GSLBRegionPoolEntry
  • address – The IP address or FQDN of this Node IP
  • label – Identifying descriptive information for this GSLBRegionPoolEntry
  • weight – A number in the range of 1-14 controlling the order in which this GSLBRegionPoolEntry will be served
  • serve_mode – Sets the behavior of this particular record. Must be one of ‘always’, ‘obey’, ‘remove’, ‘no’
address

The IP address or FQDN of this Node IP

delete()[source]

Delete this GSLBRegionPoolEntry from the DynECT System

fqdn

The fqdn of the specific node which will be monitored by this GSLBRegionPoolEntry

label

Identifying descriptive information for this GSLBRegionPoolEntry

region_code

ISO Region Code for this GSLBRegionPoolEntry

serve_mode

Sets the behavior of this particular record. Must be one of ‘always’, ‘obey’, ‘remove’, or ‘no’

sync()[source]

Sync this GSLBRegionPoolEntry object with the DynECT System

task

Task for most recent system action on this ActiveFailover.

to_json()[source]

Convert this object into a json blob

weight

A number in the range of 1-14 controlling the order in which this GSLBRegionPoolEntry will be served.

zone

Zone monitored by this GSLBRegionPoolEntry

4.5.5.3. GSLBRegion

class dyn.tm.services.gslb.GSLBRegion(zone, fqdn, region_code, *args, **kwargs)[source]

docstring for GSLBRegion

__init__(zone, fqdn, region_code, *args, **kwargs)[source]

Create a GSLBRegion object

Parameters:
  • zone – Zone monitored by this GSLBRegion
  • fqdn – The fqdn of the specific node which will be monitored by this GSLBRegion
  • region_code – ISO region code of this GSLBRegion
  • pool – (*arg) The IP Pool list for this GSLBRegion
  • serve_count – How many records will be returned in each DNS response
  • failover_mode – How the GSLBRegion should failover. Must be one of ‘ip’, ‘cname’, ‘region’, ‘global’
  • failover_data – Dependent upon failover_mode. Must be one of ‘ip’, ‘cname’, ‘region’, ‘global’
delete()[source]

Delete this GSLBRegion

failover_data

Dependent upon failover_mode. Must be one of ‘ip’, ‘cname’, ‘region’, ‘global’

failover_mode

How the GSLBRegion should failover. Must be one of ‘ip’, ‘cname’, ‘region’, ‘global’

fqdn

The fqdn of the specific node which will be monitored by this GSLBRegion

pool

The IP Pool list for this GSLBRegion

region_code

ISO region code of this GSLBRegion

serve_count

How many records will be returned in each DNS response

sync()[source]

Sync this GSLBRegion object with the DynECT System

task

Task for most recent system action on this ActiveFailover.

zone

Zone monitored by this GSLBRegion

4.5.5.4. GSLB

class dyn.tm.services.gslb.GSLB(zone, fqdn, *args, **kwargs)[source]

A Global Server Load Balancing (GSLB) service

__init__(zone, fqdn, *args, **kwargs)[source]

Create a GSLB object

Parameters:
  • auto_recover – Indicates whether or not the service should automatically come out of failover when the IP addresses resume active status or if the service should remain in failover until manually reset. Must be ‘Y’ or ‘N’
  • ttl – Time To Live in seconds of records in the service. Must be less than 1/2 of the Health Probe’s monitoring interval. Must be one of 30, 60, 150, 300, or 450
  • notify_events – A comma separated list of the events which trigger notifications. Must be one of ‘ip’, ‘svc’, or ‘nosrv’
  • syslog_server – The Hostname or IP address of a server to receive syslog notifications on monitoring events
  • syslog_port – The port where the remote syslog server listens for notifications
  • syslog_ident – The ident to use when sending syslog notifications
  • syslog_facility – The syslog facility to use when sending syslog notifications. Must be one of ‘kern’, ‘user’, ‘mail’, ‘daemon’, ‘auth’, ‘syslog’, ‘lpr’, ‘news’, ‘uucp’, ‘cron’, ‘authpriv’, ‘ftp’, ‘ntp’, ‘security’, ‘console’, ‘local0’, ‘local1’, ‘local2’, ‘local3’, ‘local4’, ‘local5’, ‘local6’, or ‘local7’
  • syslog_delivery – The syslog delivery action type. ‘all’ will deliver notifications no matter what the endpoint state. ‘change’ (default) will deliver only on change in the detected endpoint state
  • region – A list of GSLBRegion‘s
  • monitor – The health Monitor for this service
  • contact_nickname – Name of contact to receive notifications
  • syslog_probe_fmt – see below for format:
  • syslog_status_fmt – see below for format: Use the following format for syslog_xxxx_fmt paramaters. %hos hostname %tim current timestamp or monitored interval %reg region code %sta status %ser record serial %rda rdata %sit monitoring site %rti response time %msg message from monitoring %adr address of monitored node %med median value %rts response times (RTTM)
  • recovery_delay – number of up status polling intervals to consider service up
activate()[source]

Activate this GSLB service on the DynECT System

active

Indicates if the service is active. When setting directly, rather than using activate/deactivate valid arguments are ‘Y’ or True to activate, or ‘N’ or False to deactivate. Note: If your service is already active and you try to activate it, nothing will happen. And vice versa for deactivation.

Returns:An Active object representing the current state of this GSLB Service
auto_recover

Indicates whether or not the service should automatically come out of failover when the IP addresses resume active status or if the service should remain in failover until manually reset. Must be ‘Y’ or ‘N’

contact_nickname

Name of contact to receive notifications from this GSLB service

deactivate()[source]

Deactivate this GSLB service on the DynECT System

delete()[source]

Delete this GSLB service from the DynECT System

monitor

The health Monitor for this service

notify_events

A comma separated list of the events which trigger notifications. Must be one of ‘ip’, ‘svc’, or ‘nosrv’

recover(address=None)[source]

Recover the GSLB service on the designated zone node or a specific node IP within the service

recovery_delay
region

A list of GSLBRegion‘s

status

The current state of the service. Will be one of ‘unk’, ‘ok’, ‘trouble’, or ‘failover’

sync()[source]

Sync this GSLB object with the DynECT System

syslog_delivery
syslog_facility

The syslog facility to use when sending syslog notifications. Must be one of ‘kern’, ‘user’, ‘mail’, ‘daemon’, ‘auth’, ‘syslog’, ‘lpr’, ‘news’, ‘uucp’, ‘cron’, ‘authpriv’, ‘ftp’, ‘ntp’, ‘security’, ‘console’, ‘local0’, ‘local1’, ‘local2’, ‘local3’, ‘local4’, ‘local5’, ‘local6’, or ‘local7’

syslog_ident

The ident to use when sending syslog notifications

syslog_port

The port where the remote syslog server listens for notifications

syslog_probe_format
syslog_server

The Hostname or IP address of a server to receive syslog notifications on monitoring events

syslog_status_format
task

Task for most recent system action on this GSLB.

ttl

Time To Live in seconds of records in the service. Must be less than 1/2 of the Health Probe’s monitoring interval. Must be one of 30, 60, 150, 300, or 450

4.5.5.4.1. GSLB Examples

The following examples highlight how to use the GSLB class to get/create GSLB‘s on the dyn.tm System and how to edit these objects from within a Python script.

4.5.5.4.1.1. Creating a new GSLB Service

The following example shows how to create a new GSLB on the dyn.tm System and how to edit some of the fields using the returned GSLB object.

>>> from dyn.tm.services.gslb import Monitor, GSLBRegionPoolEntry, \
...    GSLBRegion, GSLB
>>> # Create a dyn.tmSession
>>> # Assuming you own the zone 'example.com'
>>> zone = 'example.com'
>>> fqdn = zone + '.'
>>> pool = GSLBRegionPoolEntry(zone, fqdn, 'global', '8.8.4.4', None,
...                            label='APIv2 GSLB')
>>> region = GSLBRegion(zone, fqdn, 'mycontactnickname', pool=[pool])
>>> monitor = Monitor('HTTP', 5, expected='Example')
>>> gslb = GSLB(zone, fqdn, 'mycontactname', region=[region], monitor=monitor)

4.5.5.4.1.2. Getting an Existing GSLB Service

The following example shows how to get an existing GSLB from the dyn.tm System and how to edit some of the same fields mentioned above.

>>> from dyn.tm.services.gslb import GSLB
>>> # Create a dyn.tmSession
>>> # Once again, assuming you own 'example.com'
>>> zone = 'example.com'
>>> fqdn = zone + '.'
>>> gslb = GSLB(zone, fqdn)

4.5.5.4.1.3. Replacing a GSLB Monitor

If you’d like to create a brand new Monitor for your GSLB service, rather than update your existing one, the following example shows how simple it is to accomplish this task

>>> from dyn.tm.services.gslb import GSLB, Monitor
>>> zone = 'example.com'
>>> fqdn = zone + '.'
>>> gslb = GSLB(zone, fqdn)
>>> gslb.monitor.protocol
'HTTP'
>>> expected_text = "This is the text you're looking for."
>>> new_monitor = Monitor('HTTPS', 10, timeout=500, port=5005,
                          expected=expected_text)
>>> gslb.monitor = new_monitor
>>> gslb.monitor.protocol
'HTTPS'