createLiveLoadBalancer


SoftLayer_Network_Application_Delivery_Controller::createLiveLoadBalancer

Add to or create load balancer service from a virtual IP address

Description

Create or add to an application delivery controller based load balancer service. The loadBalancer parameter must have its ‘’name’’, ‘’type’’, ‘‘sourcePort’’, and ‘‘virtualIpAddress’’ properties populated. Changes are reflected immediately in the application delivery controller.

Parameters

Name Type Description
loadBalancer SoftLayer_Network_LoadBalancer_VirtualIpAddress The virtual IP address interface you wish to attach to the load balancer service

Required Headers

Optional Headers

  • None

Return Values

  • boolean

Error Handling

  • Throw the exception “Invalid port supplied.” if the ‘‘sourcePort’’ property in the loadBalancr parameter is empty.
  • Throw the exception “A service with the name of ‘’name’’ already exists.” if a load balancer service with the ‘’name’’ parameter in the loadBalancer parameter already exists.
  • Throw the exception “The ip address provided is either invalid or does not belong to your account.” if an invalid ‘‘virtualIpAddress’’ property in the loadBalancer parameter is provided.
  • Throw the exception “Only public IP addresses may be used.” if the ‘‘virtualIpAddress’’ parameter in the loadBalancer parameter contains a private IP address.

Associated Methods

curl -g -u $SL_USER:$SL_APIKEY -X POST -d '{"parameters": [SoftLayer_Network_LoadBalancer_VirtualIpAddress]}' \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Network_Application_Delivery_Controller/{SoftLayer_Network_Application_Delivery_ControllerID}/createLiveLoadBalancer'