Load balancer configurations
Set up custom routing policies and maintain session stickiness for incoming requests to route your traffic to an optimal data source with the Application Load Balancer Cloudlet.
Get load balancer configurations
-
Get a list your load balancing configurations.
List-CloudletLoadBalancers
originId : example_load_balancer akamaized : False checksum : checksum70c2105edf8bb65425b399cd0 description : Default load balancer type : APPLICATION_LOAD_BALANCER originId : example_load_balancer2 akamaized : True checksum : checksum859fd8e624cda617802dcfa47 description : Backup load balancer type : APPLICATION_LOAD_BALANCER ...
The response provides an
originId
needed for downstream actions. -
Using the returned origin ID, get a list of configuration versions.
List-CloudletLoadBalancingVersions -OriginID my_origin_id
createdBy : jsmith createdDate : 12/22/2021 2:21:51 PM deleted : False description : Updated version immutable : True lastModifiedBy : jsmith lastModifiedDate : 12/22/2022 2:21:51 PM originId : example_load_balancer version : 2 createdBy : jsmith createdDate : 10/27/2021 9:37:10 AM deleted : False description : Initial version immutable : True lastModifiedBy : jsmith lastModifiedDate : 09/18/2022 2:11:14 PM originId : example_load_balancer2 version : 1
-
Use the version parameter along with your origin ID to get the configuration settings.
Get-CloudletLoadBalancingVersion -OriginID my_origin_id -Version latest
balancingType : WEIGHTED createdBy : jsmith createdDate : 12/22/2021 2:21:51 PM dataCenters : {@{cloudServerHostHeaderOverride=False; cloudService=False; continent=NA; country=US; hostname=example.com; latitude=42.3601; livenessHosts=System.Object[]; longitude=71.0332; originId=example_load_balancer; percent=100}} deleted : False description : Update version immutable : True lastModifiedBy : jsmith lastModifiedDate : 12/22/2021 2:21:51 PM originId : example_load_balancer version : 2
You can use the returned configuration on a new load balancer or make changes and create a new version.
Create a load balancer
To create a new load balancer, pass your -OriginID
in the New-CloudletLoadBalancer
command.
# Create new load balancer without a configuration
New-CloudletLoadBalancer -OriginID my_origin_id
originId : whythisdoesntworkagain
akamaized : False
checksum : ex1chk1sum6e9817662a9cb18481def75
description : Created new load balancer
type : APPLICATION_LOAD_BALANCER
This creates a load balancer without a configuration. To add a configuration, you can use an existing configuration as is or make and version your updates.
Use existing configuration
If you want to configure your new load balancer with a version of your existing configuration, use a pipe to get and set the version.
# Create a new load balancer and assign an existing configuration
# The existing config v10 becomes v1 on the new load balancer
New-CloudletLoadBalancer -OriginID new_origin_id
$LBConfig = Get-CloudletLoadBalancingVersion -OriginID old_origin_id -Version 10
# Make changes
# Save your changes until you're ready to activate it
Set-CloudletLoadBalancingVersion $LBConfig new_origin_id -Version 1
Update and create new version
You can make changes to your configuration's settings directly in the shell or in a JSON file to which you pipe.
-
Determine your configuration's activation status.
List-CloudletLoadBalancingActivations -OriginID my_origin_id
activatedBy : jsmith activatedDate : 12/22/2022 2:21:51 PM network : PRODUCTION originId : example_load_balancer status : activated version : 2 activatedBy : jsmith activatedDate : 09/18/2022 2:11:14 PM network : PRODUCTION originId : example_load_balancer status : deactivated version : 1
Status Description Versioning path active
Currently active on the network. - Make changes
- Create new version to apply your changes.
- Activate configuration.
inactive
Configuration has never been activated on any network. - Make changes
- Activate configuration.
deactivated
A previously active configuration that has been replaced by a newer version - Make changes
- Create new version to apply your changes.
- Activate configuration.
pending
Configuration activation is in progress. - Treat the configuration as if it is active.
- Make changes
- Create new version to apply your changes.
- Activate configuration.
failed
Unsuccessful configuration activation. Not active on any network. - Make changes
- Activate configuration.
-
If the configuration status does not require a new version, make changes in the shell or a JSON file, saving them with the
Set-CloudLoadBalancingVersion
command until you're ready to activate it. -
If the configuration status requires a new version, make your changes to the configuration in the shell or a JSON file and version them. Before you activate your new version, you can continue to make changes, saving them with the
Set-CloudLoadBalancingVersion
command until you're ready to activate it.# Create a new version of an activated or previously activated config $Config | New-CloudletLoadBalancingVersion -OriginID my_origin_id New-CloudletLoadBalancingVersion -OriginID my_origin_id -LoadBalancer $Config # Save changes to a configuration that is not active $Config | Set-CloudletLoadBalancingVersion -OriginID my_origin_id -Version 10
When you're done making changes, activate your configuration on the network.
Activate version
To activate your configuration on a network, pass your origin ID, your version value as latest
and identify the network, PRODUCTION
or STAGING
, in which to use the configuration.
Activate-CloudletLoadBalancingVersion -OriginID my_origin_id -Network PRODUCTION -Version latest
Updated 9 months ago