Understanding How The API Works »
Creating a pool entry for the Load Balance service using the API requires specific syntax depending on whether you are using REST or SOAP. Use this table to find the syntax for your command.
NOTE: The Load Balance Service is deprecated. Legacy users of the service should contact Concierge for any questions on adding a Load Balance service to your zone. All other users should use the GSLB service instead. |
REST Syntax
Click to view all REST Resources |
/REST/LoadBalancePoolEntry/ POST — Creates a new Load Balance service pool entry.
HTTP Action — POST
URIs — https://api.dynect.net/REST/LoadBalancePoolEntry/<zone>/<fqdn>/
|
Arguments — Click for More Info
- string
address — Required. The IP address or FQDN of the Node IP
- string
label — A descriptive string describing this IP
- string
weight — A number from 1-15 describing how often this record should be served. Higher means more
- string
serve_mode — Sets the behavior of this particular record.
Valid values:
always – Always serve this IP address
obey – Serve this address based upon its monitoring status
remove – Serve this address based upon its monitoring status. However, if it goes down, don’t automatically bring it back up when monitoring reports it up.
no – Never serve this IP address
|
Response — Click for More Info
- string
address — The IP address or FQDN of the Node IP
- string
label — A descriptive string describing this IP
- string
weight — A number from 1-15 describing how often this record should be served. Higher means more
- string
serve_mode — Sets the behavior of this particular record.
Valid values:
always – Always serve this IP address
obey – Serve this address based upon its monitoring status
remove – Serve this address based upon its monitoring status. However, if it goes down, don’t automatically bring it back up when monitoring reports it up.
no – Never serve this IP address
- string
status — The current state of the Node IP.
Valid values:
unk – The state of the IP address is not yet known
up – The IP address is up
down – The IP address is down
- array
log — Recent monitoring logs for this IP.
- string
status — The state of the Node IP at the time of the log entry.
Valid values:
unk – The state of the IP address is not yet known
up – The IP address is up
down – The IP address is down
- string
message — If status is ‘down’, an error message explaining the failure
- string
time — The time or probe interval that this log entry was generated at.
- string
site_code — The airport code of the monitoring site that generated this log entry.
- string
fqdn — Name of node where the service will exist.
- string
zone — Name of the zone where the service will exist.
|
SOAP Syntax
Click to view all SOAP Commands |
CreateLoadBalancePoolEntry — Creates a new entry in a Load Balancing service pool.
|
Arguments — Click for More Info
- string
address — Required. The IP address or FQDN of the Node IP
- string
label — A descriptive string describing this IP
- string
weight — A number from 1-15 describing how often this record should be served. Higher means more
- string
serve_mode — Sets the behavior of this particular record.
Valid values:
always – Always serve this IP address
obey – Serve this address based upon its monitoring status
remove – Serve this address based upon its monitoring status. However, if it goes down, don’t automatically bring it back up when monitoring reports it up.
no – Never serve this IP address
- string
fqdn — Required. Name of node where the service exists.
- string
token — Required. The session identifier.
- string
zone — Required. Name of the zone where the service exists.
|
Response — Click for More Info
hash data
- string
address — The IP address or FQDN of the Node IP
- string
label — A descriptive string describing this IP
- string
weight — A number from 1-15 describing how often this record should be served. Higher means more
- string
serve_mode — Sets the behavior of this particular record.
Valid values:
always – Always serve this IP address
obey – Serve this address based upon its monitoring status
remove – Serve this address based upon its monitoring status. However, if it goes down, don’t automatically bring it back up when monitoring reports it up.
no – Never serve this IP address
- string
status — The current state of the Node IP.
Valid values:
unk – The state of the IP address is not yet known
up – The IP address is up
down – The IP address is down
- array
log — Recent monitoring logs for this IP.
- string
status — The state of the Node IP at the time of the log entry.
Valid values:
unk – The state of the IP address is not yet known
up – The IP address is up
down – The IP address is down
- string
message — If status is ‘down’, an error message explaining the failure
- string
time — The time or probe interval that this log entry was generated at.
- string
site_code — The airport code of the monitoring site that generated this log entry.
- string
fqdn — Name of node where the service will exist.
- string
zone — Name of the zone where the service will exist.
|
Example Request — Click for More Info
{
'zone' => 'example.com',
'fqdn' => 'somehost.example.com',
'token' => 'asdlj34ot879834cdzjklfK',
'address' => '1.2.3.4',
'serve_mode' => 'obey',
}
|
<< DNS API Knowledge Base