The SoftLayer_Network_LoadBalancer_Global_Host data type represents a single host that belongs to a global load balancer account's load balancing pool.

The destination IP address of a host must be one that belongs to your SoftLayer customer account, or to a datacenter load balancer virtual ip that belongs to your SoftLayer customer account. The destination IP address and port of a global load balancer host is a required field and must exist during creation and can not be removed. The acceptable values for the health check type are ‘none’, ‘http’, and ‘tcp’. The status property is updated in 5 minute intervals and the hits property is updated in 10 minute intervals.

The order of the host is only important if you are using the ‘failover’ load balance method, and the weight is only important if you are using the ‘weighted round robin’ load balance method.




The IP address of the host that will be returned by the global load balancers in response to a dns request.
Type: string


The port of the host that will be used for health checks.
Type: integer


Whether the host is enabled or not. The value can be ‘0’ for disabled, or ‘1’ for enabled.
Type: integer


The health check type of a host. Valid values include ‘none’, ‘http’, and ‘tcp’.
Type: string


The number of times the host was selected by the load balance method.
Type: float


The unique identifier of a global load balancer host.
Type: integer


The order of this host within the load balance pool. This is only significant if the load balance method is set to failover.
Type: integer


The location of a host in a datacenter.serverRoom format.
Type: string


The health status of a host. The status can be either ‘UP’, ‘DOWN’, or null which could mean that the health check type is set to ‘none’ or an update to the ip, port, or health check type was recently done and the host is waiting for the new status.
Type: string


The load balance weight of a host. The total weight of all hosts in the load balancing pool must not exceed 100.
Type: integer



The global load balancer account a host belongs to.
Type: SoftLayer_Network_LoadBalancer_Global_Account


© SoftLayer 2015
Built with Hugo