You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
excerpt: 'Frequently Asked Questions on the OVHcloud Load Balancer'
4
+
updated: 2025-11-12
5
5
---
6
6
7
-
## How do I configure my Firewall to accept traffic from the OVHcloud Load Balancer?
8
-
When using the Load Balancer, your clients do not connect directly to your servers. A good practice is to setup a firewall to allow only traffic from the OVHcloud Load Balancer service.
7
+
## Objective
9
8
10
-
- To determine which IPs to allow in your firewall, you can use the following API call:
9
+
This document provides a set of the most frequently asked questions and their corresponding OVHcloud API calls for performing common management and configuration tasks on your OVHcloud Load Balancer service.
10
+
11
+
## FAQ
12
+
13
+
### How do I configure my Firewall to accept traffic from the OVHcloud Load Balancer?
14
+
15
+
When using the Load Balancer, your clients do not connect directly to your servers. A good practice is to set up a firewall to allow only traffic from the OVHcloud Load Balancer service.
16
+
17
+
#### Via the OVHcloud API
18
+
19
+
To determine which IP addresses you need to allow in your firewall, you can use the following API call:
11
20
12
21
> [!api]
13
22
>
14
23
> @api {v1} /ipLoadbalancing GET /ipLoadbalancing/{serviceName}/natIp
15
24
>
16
25
17
-
## How do I know the status of my service?
26
+
#### Via the OVHcloud Control Panel
27
+
28
+
In your Load Balancer service, navigate to the `Home`{.action} tab, and find the **Information** section. On the **Outbound IPv4** line, click the ellipsis, and select "Read".
29
+
A window will open, listing the IP addresses you need to allow in your firewall.
30
+
31
+
### How do I know the status of my service?
32
+
18
33
Sometimes it may be useful to know the status of your OVHcloud Load Balancer.
19
34
20
-
- To determine the status of your service, you can use the following API call :
35
+
#### Via the OVHcloud API
36
+
37
+
To determine the status of your service, you can use the following API call:
21
38
22
39
> [!api]
23
40
>
@@ -26,45 +43,75 @@ Sometimes it may be useful to know the status of your OVHcloud Load Balancer.
26
43
27
44
The different statuses of the OVHcloud Load Balancer can be `running`{.action} (Active), `reload`{.action} (Refresh in progress), `unknown`{.action} (Not yet started), or `dead`{.action} (inactive).
28
45
29
-
## How to add an Additional IP to the OVHcloud Load Balancer?
30
-
An Additional IP is an additional IP in which can be joined with your primary IP. The Additional IP can be switched from one server to another in seconds.
46
+
#### Via the OVHcloud Control Panel
47
+
48
+
In your Load Balancer service dashboard, navigate to the `Home`{.action} tab, and find the **Status** section, which lists the internal service name of your Load Balancer and its status.
49
+
50
+
### How to add an Additional IP to the OVHcloud Load Balancer?
51
+
52
+
An Additional IP is an secondary IP address which can be associated to your service in addition to your primary IP. The Additional IP can be switched from one server to another in seconds.
53
+
54
+
#### Via the OVHcloud API
31
55
32
-
- To add an Additional IP to an OVHcloud Load Balancer service:
56
+
- To add an Additional IP to an OVHcloud Load Balancer service:
33
57
34
58
> [!api]
35
59
>
36
60
> @api {v1} /ip POST /ip/{ip}/move
37
61
>
38
62
39
-
- Apply the change:
63
+
- Apply the change:
40
64
41
65
> [!api]
42
66
>
43
67
> @api {v1} /ipLoadbalancing POST /ipLoadbalancing/{serviceName}/refresh
44
68
>
45
69
46
-
## How to list the Additional IPs routed to the OVHcloud Load Balancer?
70
+
#### Via the OVHcloud Control Panel
71
+
72
+
In your Load Balancer service dashboard, click on `Front-ends`{.action}, then on `Add a front-end`{.action}.
73
+
Then, expand the `Advanced settings`{.action}, and select the Additional IPs you would like to add to your front-end *(listed on the interface as "Dedicated failover IP")*.
74
+
75
+
### How to list the Additional IPs routed to the OVHcloud Load Balancer?
47
76
48
77
> [!api]
49
78
>
50
79
> @api {v1} /ipLoadbalancing GET /ipLoadbalancing/{serviceName}/failover
51
80
>
52
81
53
-
## How do I order a free SSL certificate ?
54
-
It is possible to order a free SSL ceritificate for the OVHcloud Load Balancer..
82
+
### How do I order a free SSL certificate?
83
+
84
+
#### Via the OVHcloud Control Panel
85
+
86
+
In your Load Balancer service dashboard, navigate to the `SSL certificates`{.action} tab, and click on `Order an SSL certificate`{.action}.
87
+
Fill in the FQDN in the dedicated field, then click on `Order`{.action}.
88
+
89
+
For the order to be completed, it is required that the domain name points to your OVHcloud Load Balancer.
90
+
91
+
#### Via the OVHcloud API
92
+
93
+
It is possible to order a free SSL certificate for the OVHcloud Load Balancer.
55
94
56
-
- To order a free SSL certificate, you can use the following API call and entering your domain in the `fqdn` field:
95
+
- To order a free SSL certificate, you can use the following API call and enter your domain in the ‘fqdn’ field:
57
96
58
97
> [!api]
59
98
>
60
99
> @api {v1} /ipLoadbalancing POST /ipLoadbalancing/{serviceName}/freeCertificate
61
100
>
62
101
63
-
It is possible to order a multi-domain certificate; the `fqdn`fields accepts a sting type input.
102
+
It is possible to order a multi-domain certificate; the `fqdn`field accepts a string type input.
64
103
65
-
For the orer to be completed, it is required that the domain name points to your OVHcloud Load Balancer.
104
+
For the order to be completed, it is required that the domain name points to your OVHcloud Load Balancer.
66
105
67
-
## How to list the SSL certificates associated with the OVHcloud Load Balancer ?
106
+
### How to list the SSL certificates associated with the OVHcloud Load Balancer?
107
+
108
+
#### Via the OVHcloud Control Panel
109
+
110
+
In your Load Balancer service dashboard, navigate to the `SSL certificates`{.action} section, where you will find a table listing the certificates associated to that Load Balancer.
111
+
112
+
To retrieve the details of an SSL certificate, click the ellipsis button to the right of the desired certificate, then click on `See a preview`{.action}.
113
+
114
+
#### Via the OVHcloud API
68
115
69
116
- To list the SSL certificates associated with the OVHcloud Load Balancer, you can use the following API call:
70
117
@@ -73,14 +120,19 @@ For the orer to be completed, it is required that the domain name points to your
73
120
> @api {v1} /ipLoadbalancing GET /ipLoadbalancing/{serviceName}/ssl
74
121
>
75
122
76
-
The SSL certificates that have been ordered (free or not) will appear as `built`. Those added by yourself are will appear as `custom`.
123
+
The SSL certificates that have been ordered (free or not) will appear as `built`. Those added by yourself will appear as `custom`.
77
124
78
-
An SSL certificate appearing as `built_not_routed` is a certificate that has been order and delivered, but whose domain cannot be validated. Usually, this is because the domain to longer points to the OVHcloud Load Balancer.
125
+
An SSL certificate appearing as `built_not_routed` is a certificate that has been ordered and delivered, but whose domain cannot be validated. Usually, this is because the domain no longer points to the OVHcloud Load Balancer.
79
126
80
-
- To retrieve the details of an SSL certificate, you can use the following API call:
127
+
- To retrieve the details of an SSL certificate, you can use the following API call:
81
128
82
129
> [!api]
83
130
>
84
131
> @api {v1} /ipLoadbalancing GET /ipLoadbalancing/{serviceName}/ssl/{id}
85
132
>
86
133
134
+
## Go further
135
+
136
+
Find details about all the API calls related to the OVHcloud Load Balancer in [this guide](/pages/network/load_balancer/use_api_details).
excerpt: 'Frequently Asked Questions on the OVHcloud Load Balancer'
4
+
updated: 2025-11-12
5
5
---
6
6
7
-
## How do I configure my Firewall to accept traffic from the OVHcloud Load Balancer?
8
-
When using the Load Balancer, your clients do not connect directly to your servers. A good practice is to setup a firewall to allow only traffic from the OVHcloud Load Balancer service.
7
+
## Objective
9
8
10
-
- To determine which IPs to allow in your firewall, you can use the following API call:
9
+
This document provides a set of the most frequently asked questions and their corresponding OVHcloud API calls for performing common management and configuration tasks on your OVHcloud Load Balancer service.
10
+
11
+
## FAQ
12
+
13
+
### How do I configure my Firewall to accept traffic from the OVHcloud Load Balancer?
14
+
15
+
When using the Load Balancer, your clients do not connect directly to your servers. A good practice is to set up a firewall to allow only traffic from the OVHcloud Load Balancer service.
16
+
17
+
#### Via the OVHcloud API
18
+
19
+
To determine which IP addresses you need to allow in your firewall, you can use the following API call:
11
20
12
21
> [!api]
13
22
>
14
23
> @api {v1} /ipLoadbalancing GET /ipLoadbalancing/{serviceName}/natIp
15
24
>
16
25
17
-
## How do I know the status of my service?
26
+
#### Via the OVHcloud Control Panel
27
+
28
+
In your Load Balancer service, navigate to the `Home`{.action} tab, and find the **Information** section. On the **Outbound IPv4** line, click the ellipsis, and select "Read".
29
+
A window will open, listing the IP addresses you need to allow in your firewall.
30
+
31
+
### How do I know the status of my service?
32
+
18
33
Sometimes it may be useful to know the status of your OVHcloud Load Balancer.
19
34
20
-
- To determine the status of your service, you can use the following API call :
35
+
#### Via the OVHcloud API
36
+
37
+
To determine the status of your service, you can use the following API call:
21
38
22
39
> [!api]
23
40
>
@@ -26,45 +43,75 @@ Sometimes it may be useful to know the status of your OVHcloud Load Balancer.
26
43
27
44
The different statuses of the OVHcloud Load Balancer can be `running`{.action} (Active), `reload`{.action} (Refresh in progress), `unknown`{.action} (Not yet started), or `dead`{.action} (inactive).
28
45
29
-
## How to add an Additional IP to the OVHcloud Load Balancer?
30
-
An Additional IP is an additional IP in which can be joined with your primary IP. The Additional IP can be switched from one server to another in seconds.
46
+
#### Via the OVHcloud Control Panel
47
+
48
+
In your Load Balancer service dashboard, navigate to the `Home`{.action} tab, and find the **Status** section, which lists the internal service name of your Load Balancer and its status.
49
+
50
+
### How to add an Additional IP to the OVHcloud Load Balancer?
51
+
52
+
An Additional IP is an secondary IP address which can be associated to your service in addition to your primary IP. The Additional IP can be switched from one server to another in seconds.
53
+
54
+
#### Via the OVHcloud API
31
55
32
-
- To add an Additional IP to an OVHcloud Load Balancer service:
56
+
- To add an Additional IP to an OVHcloud Load Balancer service:
33
57
34
58
> [!api]
35
59
>
36
60
> @api {v1} /ip POST /ip/{ip}/move
37
61
>
38
62
39
-
- Apply the change:
63
+
- Apply the change:
40
64
41
65
> [!api]
42
66
>
43
67
> @api {v1} /ipLoadbalancing POST /ipLoadbalancing/{serviceName}/refresh
44
68
>
45
69
46
-
## How to list the Additional IPs routed to the OVHcloud Load Balancer?
70
+
#### Via the OVHcloud Control Panel
71
+
72
+
In your Load Balancer service dashboard, click on `Front-ends`{.action}, then on `Add a front-end`{.action}.
73
+
Then, expand the `Advanced settings`{.action}, and select the Additional IPs you would like to add to your front-end *(listed on the interface as "Dedicated failover IP")*.
74
+
75
+
### How to list the Additional IPs routed to the OVHcloud Load Balancer?
47
76
48
77
> [!api]
49
78
>
50
79
> @api {v1} /ipLoadbalancing GET /ipLoadbalancing/{serviceName}/failover
51
80
>
52
81
53
-
## How do I order a free SSL certificate ?
54
-
It is possible to order a free SSL ceritificate for the OVHcloud Load Balancer..
82
+
### How do I order a free SSL certificate?
83
+
84
+
#### Via the OVHcloud Control Panel
85
+
86
+
In your Load Balancer service dashboard, navigate to the `SSL certificates`{.action} tab, and click on `Order an SSL certificate`{.action}.
87
+
Fill in the FQDN in the dedicated field, then click on `Order`{.action}.
88
+
89
+
For the order to be completed, it is required that the domain name points to your OVHcloud Load Balancer.
90
+
91
+
#### Via the OVHcloud API
92
+
93
+
It is possible to order a free SSL certificate for the OVHcloud Load Balancer.
55
94
56
-
- To order a free SSL certificate, you can use the following API call and entering your domain in the `fqdn` field:
95
+
- To order a free SSL certificate, you can use the following API call and enter your domain in the ‘fqdn’ field:
57
96
58
97
> [!api]
59
98
>
60
99
> @api {v1} /ipLoadbalancing POST /ipLoadbalancing/{serviceName}/freeCertificate
61
100
>
62
101
63
-
It is possible to order a multi-domain certificate; the `fqdn`fields accepts a sting type input.
102
+
It is possible to order a multi-domain certificate; the `fqdn`field accepts a string type input.
64
103
65
-
For the orer to be completed, it is required that the domain name points to your OVHcloud Load Balancer.
104
+
For the order to be completed, it is required that the domain name points to your OVHcloud Load Balancer.
66
105
67
-
## How to list the SSL certificates associated with the OVHcloud Load Balancer ?
106
+
### How to list the SSL certificates associated with the OVHcloud Load Balancer?
107
+
108
+
#### Via the OVHcloud Control Panel
109
+
110
+
In your Load Balancer service dashboard, navigate to the `SSL certificates`{.action} section, where you will find a table listing the certificates associated to that Load Balancer.
111
+
112
+
To retrieve the details of an SSL certificate, click the ellipsis button to the right of the desired certificate, then click on `See a preview`{.action}.
113
+
114
+
#### Via the OVHcloud API
68
115
69
116
- To list the SSL certificates associated with the OVHcloud Load Balancer, you can use the following API call:
70
117
@@ -73,14 +120,19 @@ For the orer to be completed, it is required that the domain name points to your
73
120
> @api {v1} /ipLoadbalancing GET /ipLoadbalancing/{serviceName}/ssl
74
121
>
75
122
76
-
The SSL certificates that have been ordered (free or not) will appear as `built`. Those added by yourself are will appear as `custom`.
123
+
The SSL certificates that have been ordered (free or not) will appear as `built`. Those added by yourself will appear as `custom`.
77
124
78
-
An SSL certificate appearing as `built_not_routed` is a certificate that has been order and delivered, but whose domain cannot be validated. Usually, this is because the domain to longer points to the OVHcloud Load Balancer.
125
+
An SSL certificate appearing as `built_not_routed` is a certificate that has been ordered and delivered, but whose domain cannot be validated. Usually, this is because the domain no longer points to the OVHcloud Load Balancer.
79
126
80
-
- To retrieve the details of an SSL certificate, you can use the following API call:
127
+
- To retrieve the details of an SSL certificate, you can use the following API call:
81
128
82
129
> [!api]
83
130
>
84
131
> @api {v1} /ipLoadbalancing GET /ipLoadbalancing/{serviceName}/ssl/{id}
85
132
>
86
133
134
+
## Go further
135
+
136
+
Find details about all the API calls related to the OVHcloud Load Balancer in [this guide](/pages/network/load_balancer/use_api_details).
0 commit comments