3.1.5.6 loadBalancerManager

The loadBalancerManager resource is a singleton resource that configures the load balancing service of the Network Controller.

It is invoked through the following URI.

 https://<url>/networking/v1/loadBalancerManager/config

url: The address or name of the REST server of the Network Controller.

Note  The server MAY support additional versions, besides v1 in the URI.

The following HTTP methods can be performed on this resource.

HTTP method

Section

Description

PUT

3.1.5.6.1.1

Create a new loadBalancerManager resource or update an existing loadBalancerManager resource.

GET

3.1.5.6.1.2

Get the loadBalancerManager resource.

The following property elements are valid.

Element name

Type

Description

etag

Read-only

Specified in Common JSON Elements, section 2.2.2.

provisioningState

Read-only

Specified in Common JSON Elements, section 2.2.2.

loadBalancerManagerIPAddress

Required

The IP address of the load balancer service.  This is part of one of the vipIpPools as specified in the vipIpPools element in this resource.

outboundNatIPExemptions

Required

An array of v4 or v6 subnets masks with prefixes that will not have the source IP and Port changed by being NAT-ed.  This is typically used for datacenter services that will communicated with other services within the same datacenter or cluster.

Array of strings in the following format: 0.0.0.0/0.

Note  There is no validation that these IP addresses are known by the network controller.

vipIpPools

Required

An array of references to ipPool resources that will be used for the frontend IP addresses.

A loadBalancerManager is a singleton resource, it cannot be deleted once it is created. However, it can be updated.

The loadBalancerManager IP address MUST be part of one of the vipIpPools configured on the loadbalancerManager resource.

In any update removal of an ipPool reference form vipIpPools MUST only be attempted when no loadBalancers reference IP addresses from that pool in their frontendIPConfigurations and no public IPs are allocated from that ipPool. Removal of an in use ipPool is disallowed and will place the loadbalancerManager resource in a failed provisioning state.

Similarly, if an ipPool is added for use by the loadBalancerManager, it MUST have no IP address usage prior to being added to the loadBalancerManager.