---
title: "How to route an Additional IP"
description: "An Additional IP is an IP address that can be switched from one service to another. This capability helps you maintain infrastructure continuity by mitigating i"
url: https://docs.us.ovhcloud.com/en/network/load-balancer/howto-route-ipfo
lang: en
---
> For AI agents: the complete documentation index is available at https://docs.us.ovhcloud.com/en/llms.txt, the full documentation bundle is available at https://docs.us.ovhcloud.com/en/llms-full.txt.

# How to route an Additional IP

An Additional IP is an IP address that can be switched from one service to another. This capability helps you maintain infrastructure continuity by mitigating issues such as hardware failures, service overload, or maintenance downtime.

For more information on Additional IPs, see our [webpage](https://us.ovhcloud.com/network/additional-ip/).

The OVHcloud Load Balancer solution offers load balancing features for various protocols, including HTTP, HTTPS, and TCP. Linking it to an Additional IP provides the ability to switch over your existing infrastructure to a Load Balancer without service interruption. Since you continue using the Additional IP, you avoid the need to change your public IP address and wait for DNS zone propagation. Using an Additional IP means that you avoid the need to change your service's IP address, and no longer have to wait for your DNS zone to propagate changes.

For more information on the OVH Load Balancer solution, you can read our [Introduction to the OVHcloud Load Balancer](https://docs.us.ovhcloud.com/en/network/load-balancer/use-presentation.md).

 

## Requirements

- A configured [OVHcloud Load Balancer](https://us.ovhcloud.com/network/load-balancer/)
- An [Additional IP](https://us.ovhcloud.com/network/additional-ip/)
- Access to the [OVHcloud Control Panel](https://manager.us.ovhcloud.com/) or [OVHcloud API](https://api.us.ovhcloud.com/)

**Note:**

**Required Load Balancer configuration:**

Once you have confirmed the changes in the list of Additional IPs associated with the Load Balancer, you need to be able to refresh them. Several conditions need to be met for this to work.

- If the Load Balancer is in a vRack, all of the server clusters must also be in the vRack. The Load Balancer must also have its vLAN. Otherwise, there should not be any clusters in a vRack.
- At least one existing front-end. All of the front-ends must be valid. They can be enabled and disabled, with either:
- a valid route (with routing rules)
- a redirection (`redirectLocation`)
- a default server cluster
- Nothing else should be refreshed for the Load Balancer. A Load Balancer cannot be refreshed several times at once. Doing so would not make any changes to the resulting configuration.

 

## Instructions

In this document, we will look at two distinct uses:

- linking an Additional IP to the OVHcloud Load Balancer service
- linking an Additional IP to a single front-end of the OVHcloud Load Balancer service

 

### Add an Additional IP to the OVHcloud Load Balancer

You can link these IPs to your OVHcloud Load Balancer via the [OVHcloud API](https://api.us.ovhcloud.com/) using this call:

[POST /ip/{ip}/move](https://api.us.ovhcloud.com/console/?section=/ip&branch=v1#post-/ip/-ip-/move)

You can then list the Additional IPs linked to your OVH Load Balancer with the following API call:

[GET /ipLoadbalancing/{serviceName}/failover](https://api.us.ovhcloud.com/console/?section=/ipLoadbalancing&branch=v1#get-/ipLoadbalancing/-serviceName-/failover)

The Additional IPs linked to your Load Balancer are available for **all** of your front-ends. This differs from the next case, where an Additional IP is linked to a single front-end.

 

### Add a dedicated Additional IP to a front-end

Regardless of the front-end type, you can define a list of dedicated Additional IPs to be linked to it. In this specific case, your Additional IP will be attached to **a single** front-end. As a result, it will only grant access to the service provided by that front-end. Services for your other front-ends will remain accessible via your IP Load Balancer’s primary IP address.

**Tip:**

Click each tab across the top to view all content.

#### Via the API

**If you are creating a front-end:** From the [OVHcloud API](https://api.us.ovhcloud.com/), you can use the following call to define one or more Additional IPs on a front-end as you create it:
- HTTP protocol

  `POST /ipLoadbalancing/{serviceName}/http/frontend`

- TCP protocol

  `POST /ipLoadbalancing/{serviceName}/tcp/frontend`
 
**If you are updating an existing front-end:** From the [OVHcloud API](https://api.us.ovhcloud.com/), you can use the following call to define one or more Additional IPs on an existing front-end:
- HTTP protocol

  `PUT /ipLoadbalancing/{serviceName}/http/frontend/{frontendId}`

- TCP protocol

  `PUT /ipLoadbalancing/{serviceName}/tcp/frontend/{frontendId}`

#### Via the OVHcloud Control Panel

You can define dedicated Additional IPs via the [OVHcloud Control Panel](https://manager.us.ovhcloud.com/) by going to the `Bare Metal Cloud` section, then `Load Balancer`.
Once you have selected the Load Balancer you want to modify, navigate to the `Front-ends` tab, where you can create a new front-end or edit an existing one.
In `Advanced settings`, you can select the Additional IPs you would like to add to your front-end.

Once the front-end has been configured, click `Add` or `Modify`, depending on whether you are configuring a new or existing front-end.
Please remember to deploy the configuration. There are two ways of doing this:
- via the **Status** section of the OVHcloud Control Panel, by clicking on your Load Balancer’s _more options_ `...` button, then selecting `Apply configuration`.
- via the reminder box in the OVHcloud Control Panel, notifying you that the configuration has not been applied, by clicking `Apply configuration`.

 

## Go further

Browse all the [Load Balancer guides](https://docs.us.ovhcloud.com/en/network/load-balancer/landing-page-load-balancer.md).

Browse the rest of the [OVHcloud US documentation](https://docs.us.ovhcloud.com/en/index.md) for guides on our other products and services.

Learn more about [Load Balancer](https://us.ovhcloud.com/network/load-balancer/) on the OVHcloud US website.
