Details of API functions

Knowledge Base

Details of API functions


Icons/System/eye-open Created with Sketch. 271 Views 29.09.2025 Cloud / OVHcloud Load Balancer

Objective

This guide provides a detailed description of all API functions for the OVHcloud Load Balancer.

Prerequisite

Instructions

Manage your OVHcloud Load Balancer service via the API

All API calls that are made in the section /ipLoadbalancing are available on this page.

In the calls below all fields marked with an asterisk * are mandatory.

The Frontends, Farms and Servers are specific to the protocol (HTTP, TCP or UDP) in which they are defined. Compatibility between these components is only possible within the same protocol. For example, an HTTP Frontend can only be paired with an HTTP Farm, and cannot be used with a UDP Farm.

Services and zones

OVHcloud Load Balancer

List active services

List the zones available for the OVHcloud Load Balancer

Return details of a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, ex: IP-1.2.3.4 (String of characters)

Modify a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, ex: IP-1.2.3.4 (String of characters)
Ip.displayNameThe name you want to give to the service (String of characters)
Ip.sslConfigurationThe SSL configuration you want to assign to the service (Value)

List the services attached to the OVHcloud Load Balancer

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, ex: IP-1.2.3.4 (String of characters)

List existing farms and their type

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, ex: IP-1.2.3.4 (String of characters)
vrackNetworkIdAllows filtering according to the vrack network

List the areas that can be attached to a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, ex: IP-1.2.3.4 (String of characters)

List the different probes that can be used

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, ex: IP-1.2.3.4 (String of characters)

List the different types of farms that can be used

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, ex: IP-1.2.3.4 (String of characters)

List the different types of frontends that can be used

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, ex: IP-1.2.3.4 (String of characters)

List the different types of routing actions that can be used

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, ex: IP-1.2.3.4 (String of characters)

List the different types of routing rules that can be used

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, ex: IP-1.2.3.4 (String of characters)

Service

Get service information

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, ex: IP-1.2.3.4 (String of characters)

Modify service information

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, ex: IP-1.2.3.4 (String of characters)
Service.automaticEnables automatic service renewal (Boolean))
Service.deleteAtExpirationEnables the deletion of the service upon expiration. (Boolean)
Service.forcedForces automatic renewal (Boolean)
Service.periodFill in the renewal term (String of characters)

Zones

List active zones for a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, ex. : IP-1.2.3.4 (String of characters)

Get the details of a zone

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
nameYesThe name of the requested zone

Delete a zone

The service will be discontinued on the expiry date.

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
nameYesThe service will be discontinued on the expiry date.

Undo the deletion of a zone

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
nameYesThe name of the zone to be deleted

HTTP Protocol

Accessing HTTP protocol related elements (Frontend, Firmware, etc.).

HTTP farms

List HTTP farms attached to a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
zoneThe name of the zone (String of characters)

Adding a new HTTP farm to a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
zoneYesThe name of the zone (String of characters)
displayNameThe name you wish to give to your farm (String of characters)
balanceYour farm's load distribution method (Value)
portThe listening port on your farm. Inherited from the frontend if undefined (Number, 1..65535)
stickinessThe type of connection persistence to use for your farm (Value)
probeThe type of probe to use on your farm (Probe HTTP)
probe.forceSslSSL activation is forced for the probe (Boolean)
probe.intervalThe interval in seconds between each probe test. Must be greater than 30. Default is 30. (Number)
probe.matchThe method of correspondence used. default' uses the standard behavior of HAProxy. status' is only supported for HTTP probes (value) [contains, default, internal, matches, status]
probe.negateThe behavior of the 'match' operator is reversed (Boolean)
probe.methodThe HTTP method used in type 'http'. HEAD' can save bandwidth. GET' by default (Value) [HEAD, GET, OPTIONS, internal]
probe.patternThe format of the server response when "UP". Empty for 'default', comma separated status list for 'status', text for 'contains', regular expression for 'matches' (String of characters)
probe.portThe port that the probe should use to test the servers attached to your farm. Ignored for 'oco' probes. If not defined, the farm port is used (Number)
probe.typeThe type of the probe; its operation (Value) [HTTP, internal, MySQL, OCO, PgSQL, SMTP, TCP]
probe.urlThe address to be used by the probe for HTTP type probes. The type is ignored if this parameter is set to (String of characters)

Getting the details of an HTTP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
farmIdYesThe identifier of your HTTP farm (Number)

Modify the properties of an HTTP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
farmIdYesThe identifier of your HTTP farm (Number)
BackendHttp.displayNameThe name of the farm (String of characters)
BackendHttp.balanceThe type of load distribution (Value)
BackendHttp.portThe farm's listening port (Number, 1..65000)
BackendHttp.probeThe type of probe to be used (HTTP probe)
BackendHttp.stickinessThe type of connection persistence (Value)

Delete an HTTP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
farmIdYesThe identifier of your HTTP farm (Number)

HTTP Servers

List the servers linked to the HTTP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
farmIdYesThe identifier of your HTTP farm (Number)
cookieFilter Values by Cookie (String of characters)
addressFilter Values by IPv4 address (IPv4)
statusFilter Values by server status (Value)

Adding a server to an HTTP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
farmIdYesThe identifier of your farm (Number)
addressYesThe IPv4 address of your server (IPv4)
backupIf your server is configured as a backup server (Boolean)
chainThe Value of the Intermediate SSL Certificate (String of characters)
cookieThe Value of your Cookie (String of characters)
displayNameThe name given to your server (String of characters)
portThe listening port of your server. Inherited from your farm if not defined (Number, 1..65535)
probeThe type of probe to be used (Value)
proxyProtocolVersionThe proxyProtocol version to use,
sslYesIf the requests sent to your servers need to be encrypted with SSL (Boolean)
weightYesThe weight of your server for your farm. A server with high weight receives more requests (Number)
statusYesIf your server is activated or not (Boolean)

Get the details of a server linked to an HTTP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
serverIdYesThe identifier of your server (Number)
farmIdYesThe identifier of your farm (Number)

Modify the properties of an HTTP server

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
serverIdYesThe identifier of your server-link (Number)
farmIdYesThe identifier of your farm (Number)
BackendHttpServer.backupIf your server is configured as a backup server (Boolean)
BackendHttpServer.chainThe Value of the Intermediate SSL Certificate (String of characters)
BackendHttpServer.cookieThe Value of your Cookie (String of characters)
BackendHttpServer.displayNameThe name of your server (String of characters)
BackendHttpServer.portThe listening port of your server (Number, 1..65535)
BackendHttpServer.probeThe type of probe to be used (Value)
BackendHttpServer.proxyProtocolVersionThe proxyProtocol version to use,
BackendHttpServer.sslIf the requests sent to your servers need to be encrypted with SSL (Boolean)
BackendHttpServer.statusIf your server is activated or not (Boolean)
BackendHttpServer.weightThe weight of your server for your farm (Number)

Removing a server from an HTTP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
serverIdYesThe identifier of your server (Number)
farmIdYesThe identifier of your farm (Number)

Frontends HTTP

List HTTP frontends attached to a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
defaultFarmIdThe identifier of the HTTP farm to which the HTTP frontend is linked (Number)
portThe listening port on your frontend (Number, 1..65535)
zoneThe name of your zone, ex: all (String of characters)

Add an HTTP frontend to a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
allowedSourceThe list of client IP addresses that have access to the Load Balancer (IPv4)
dedicatedIpfoThe list of IP addresses of the remote servers to which your Load Balancer is connected (IPv4[])
defaultFarmIdThe default HTTP farm identifier for your frontend (Number)
defaultSslIdThe default SSL Certificate ID (Number)
disabledIf your HTTP frontend is disabled or enabled (Boolean)
displayNameThe name of your HTTP frontend (String of characters)
hstsIf support for https strict, HTTP Strict Transport Security is enabled or disabled (Boolean)
httpHeaderThe custom http header to add (String of characters)
portYesThe listening port on your frontend (Number, 1..65535)
redirectLocationThe redirection URL http (String of characters)
sslWhether requests sent to the HTTP farm should be encrypted with SSL or not (Boolean)
zoneYesThe name of your zone, ex: all (String of characters)

Get the details of an HTTP frontend

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
frontendIdYesThe identifier of your HTTP frontend (Number)

Modify the properties of an HTTP frontend

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
frontendIdYesThe identifier of your HTTP frontend (Number)
FrontendHttp.allowedSourceThe list of client IP addresses that have access to the Load Balancer (IPv4[])
FrontendHttp.dedicatedIpfoThe list of IP addresses of the remote servers to which your Load Balancer is connected (IPv4[])
FrontendHttp.defaultSslIdThe default SSL Certificate ID (Number)
FrontendHttp.disabledIf your HTTP frontend is disabled or enabled (Boolean)
FrontendHttp.displayNameThe name of your HTTP frontend (String of characters)
FrontendHttp.hstsIf support for https strict, HTTP Strict Transport Security is enabled or disabled (Boolean)
FrontendHttp.httpHeaderThe custom http header to add (String of characters)
FrontendHttp.sslWhether requests sent to the HTTP farm should be encrypted with SSL or not (Boolean)

Delete an HTTP frontend

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
frontendIdYesThe identifier of your frontend (Number)

Routes HTTP

Routes are evaluated one by one, testing their routing rules. The first route validating all its rules sees its action executed, and stops the evaluation of the remaining routes. The order of execution is defined by the type and weight of the route.

List the HTTP routes attached to a Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
frontendIdThe identifier of an HTTP frontend (Number)

Add a new HTTP route to a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
actionYesThe action triggered when all the rules of your route are validated (RouteHttpAction)
action.statusThe expected HTTP return code (Number)
action.targetThe farm identifier, or the template for the URL (String of characters)
action.typeThe action on your route (String of characters)
displayNameThe name of your route (String of characters)
frontendIdThe Identifier of the HTTP frontend for which your route is applied (Number)
weightThe priority of your route. (Number) [0 - 255]

Get the details of an HTTP route

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
routeIdYesThe identifier of your route (number)

Modify the properties of an HTTP route

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
routeIdYesThe identifier of your route (number)
routeHttp.actionYesThe action triggered when all the rules of your route are validated (RouteHttpAction)
routeHttp.statusThe expected HTTP return code (Number)
routeHttp.targetThe farm identifier, or the template for the URL (String of characters)
routeHttp.typeThe action on your route (String of characters)
routeHttp.displayNameThe name of your route (String of characters)
routeHttp.frontendIdThe Identifier of the HTTP frontend for which your route is applied (Number)
routeHttp.weightThe priority of your route. (Number) [0 - 255]

Delete an HTTP route

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
routeIdYesThe identifier of your route (number)

Routing rules

List the routing rules attached to an HTTP route

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
routeIdYesThe identifier of your HTTP route (Number)

Add routing rules attached to an HTTP route

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
routeIdYesThe identifier of your HTTP route (Number)
fieldYesThe name of the field to be tested with the "match" operator (String of characters)
matchYesThe comparison operator (value) (contains, endsWith, exists, in, internal, is, matches, startsWith)
negateThe behavior of the operator :code:match is reversed (Boolean)
patternThe schema or the regular expression used by the "match" operator (Regex / String of characters)
subFieldThe name of the sub-field, if applicable. Can be a cookie or a header name, for example (String of characters)

Get the details of a routing rule

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
routeIdYesThe identifier of your HTTP route (Number)
ruleIdYesThe identifier of your HTTP routing rule (Number)

Modify the properties of a routing rule

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
routeIdYesThe identifier of your HTTP route (Number)
ruleIdYesThe identifier of your HTTP routing rule (Number)
RouteRule.fieldThe name of the field to be tested via the "match" operator (String of characters)
RouteRule.matchThe comparison operator to use (contains, endsWith, exists, in, internal, is, matches, startsWith)
RouteRule.negateIf the "match" operator is inverted or not (Boolean)
RouteRule.patternThe Value or regular expression to use with the "match" operator (Regex / String of characters)
RouteRule.subFieldThe name of the sub-field if applicable (String of characters)

Delete a routing rule

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
routeIdYesThe identifier of your HTTP route (Number)
ruleIdYesThe identifier of your HTTP routing rule (Number)

Protocol TCP

Access the elements related to the TCP protocol (Frontend, Farm, etc.).

TCP Farms

List TCP farms attached to a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
zoneThe name of your zone, ex: all (String of characters)

Add a new TCP farm to a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
balanceYour farm's load sharing method (Value)
displayNameThe name you wish to give to your farm (String of characters)
portThe listening port on your farm. Inherited from the frontend if not defined (Number, 1..65535)
probeThe type of probe to use on your farm (HTTP probe)
probe.forceSslActivation of the SSL is forced for the probe (Boolean)
probe.intervalThe interval (in seconds) between each probe test. Must be greater than 30. Default is 30 (Number)
probe.matchThe method of correspondence used. default' uses the standard HAProxy behavior. status' is only supported for HTTP probes. (Value) (contains, default, internal, matches, status)
probe.negateThe behavior of the :code:match operator is reversed. (Boolean)
probe.methodThe HTTP method used in :code:type 'http'. HEAD' can save bandwidth. GET' by default (Value) (HEAD, GET, OPTIONS, internal)
probe.patternserver response when "UP". Empty for 'default', comma separated status list for 'status', text for 'contains', regular expression for 'matches'. (String of characters)
probe.portThe port that the probe should use to test the servers attached to your farm. Ignored for 'oco' probes. If not defined, the farm port is used (Number)
probe.typeThe type of the probe; its operation (Value) (HTTP, internal, MySQL, OCO, PgSQL, SMTP ou TCP)
probe.urlThe address to be used by the probe for HTTP type probes. The :code:type is ignored if this parameter is defined (String of characters)
stickinessThe type of connection persistence to use for your farm (Value)
zoneYesThe name of your zone, ex: all (String of characters)

Get the details of a TCP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
farmIdYesThe identifier of your farm (Number)

Modify the properties of a TCP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
farmIdYesThe identifier of your farm (Number)
BackendTcp.balanceThe type of load distribution (Value)
BackendTcp.displayNameThe name of the farm (String of characters)
BackendTcp.portThe farm's listening port (Number, 1..65000)
BackendTcp.probeThe type of probe to be used (Sonde TCP)
BackendTcp.stickinessThe type of connection persistence (Value)

Delete a TCP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
farmIdYesThe identifier of your farm (Number)

TCP Servers

List the servers linked to the TCP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
farmIdYesThe identifier of your farm (Number)
cookieFilter Values by Cookie (String of characters)
addressFilter Values by IPv4 address (IPv4)
statusFilter Values by Server Status (Value)

Add a server to a TCP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
farmIdYesThe identifier of your farm (Number)
addressYesThe IPv4 address of your server (IPv4)
backupIf your server is configured as a backup server (Boolean)
chainThe Value of the Intermediate SSL Certificate (String of characters)
displayNameThe name given to your server (String of characters)
portThe listening port of your server. Inherited from your farm if not defined (Number, 1..65535)
probeThe type of probe to be used (Value)
proxyProtocolVersionThe proxyProtocol version to use,
sslYesIf the requests sent to your servers need to be encrypted with SSL (Boolean)
weightYesThe weight of your server for your farm. A high weight server receives more requests (Number)
statusYesIf your server is activated or not (Boolean)

Get the details of a server linked to a TCP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
serverIdYesThe identifier of your server (Number)
farmIdYesThe identifier of your farm (Number)

Modify the properties of a TCP server

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
serverIdYesThe identifier of your server-link (Number)
farmIdYesThe identifier of your farm (Number)
BackendTcpServer.backupIf your server is configured as a backup server (Boolean)
BackendTcpServer.chainThe Value of the Intermediate SSL Certificate (String of characters)
BackendTcpServer.displayNameThe name of your server (String of characters)
BackendTcpServer.portThe listening port of your server (Number, 1..65535)
BackendTcpServer.probeThe type of probe to be used (Value)
BackendTcpServer.proxyProtocolVersionThe proxyProtocol version to use,
BackendTcpServer.sslIf the requests sent to your servers need to be encrypted with SSL (Boolean)
BackendTcpServer.statusIf your server is activated or not (Boolean)
BackendTcpServer.weightThe weight of your server for your farm (Number)

Delete a server from a TCP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
serverIdYesThe identifier of your server (Number)
farmIdYesThe identifier of your farm (Number)

Frontends TCP

List TCP frontends attached to a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
defaultFarmIdThe identifier of the TCP farm to which the TCP frontend is linked (Number)
portThe listening port on your frontend (Number, 1..65535)
zoneThe name of your zone, ex: all (String of characters)

Add a TCP frontend to a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
allowedSourceThe list of client IP addresses that have access to the Load Balancer (IPv4)
dedicatedIpfoThe list of IP addresses of the remote servers to which your Load Balancer is connected (IPv4[])
defaultFarmIdThe default TCP farm identifier for your frontend (Number)
defaultSslIdThe default SSL Certificate ID (Number)
disabledIf your TCP frontend is disabled or enabled (Boolean)
displayNameThe name of your TCP frontend (String of characters)
portYesThe listening port on your frontend (Number, 1..65535)
sslWhether requests sent to the TCP farm should be encrypted with SSL or not (Boolean)
zoneYesThe name of your zone, ex: all (String of characters)

Get the details of a TCP frontend

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
frontendIdYesThe identifier of your frontend TCP (Number)

Modify the properties of a TCP frontend

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
frontendIdYesThe identifier of your frontend TCP (Number)
FrontendTcp.allowedSourceThe list of client IP addresses that have access to the Load Balancer (IPv4[])
FrontendTcp.dedicatedIpfoThe list of IP addresses of the remote servers to which your Load Balancer is connected (IPv4[])
FrontendTcp.defaultSslIdThe default SSL Certificate ID (Number)
FrontendTcp.disabledIf your HTTP frontend is disabled or enabled (Boolean)
FrontendTcp.displayNameThe name of your HTTP frontend (String of characters)
FrontendTcp.sslWhether requests sent to the HTTP farm should be encrypted with SSL or not (Boolean)

Delete a TCP frontend

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
frontendIdYesThe identifier of your frontend (Number)

Routes TCP

Routes are evaluated one by one, testing their routing rules. The first route validating all its rules sees its action executed, and stops the evaluation of the remaining routes. The order of execution is defined by the type and weight of the route.

List TCP routes attached to a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
frontendIdThe identifier of a TCP frontend (Number)

Add a new TCP route to a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
actionYesThe action triggered when all the rules of your route are validated (RouteHttpAction)
action.targetThe farm identifier, or the template for the URL (String of characters)
action.typeThe action on your route (String of characters)
displayNameThe name of your route (String of characters)
frontendIdThe Identifier of the TCP frontend for which your route is applied (Number)
weightThe priority of your route. (Number) [0 - 255]

Get the details of a TCP route

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
routeIdYesThe identifier of your route (number)

Modify the properties of a TCP route

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
routeIdYesThe identifier of your route (number)
routeTcp.actionThe action to carry out (routeTcpAction)
routeTcp.targetThe farm identifier, or the template for the URL (String of characters)
routeTcp.typeThe action on your route (String of characters)
routeTcp.displayNameThe name of your route (String of characters)
routeTcp.frontendIdThe TCP frontend for which your route is applied (Number)
routeTcp.weightThe priority of your route (Number) [0 - 255]

Delete a TCP route

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
routeIdYesThe identifier of your route (number)

Routing rules

List the routing rules attached to a TCP route

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
routeIdYesThe identifier of your TCP route (Number)

Add routing rules attached to a TCP route

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
routeIdYesThe identifier of your TCP route (Number)
fieldYesThe name of the field to be tested with the "match" operator (String of characters)
matchYesThe comparison operator (value) (contains, endsWith, exists, in, internal, is, matches, startsWith)
negateThe behavior of the :code:match operator is reversed. (Boolean)
patternThe schema or the regular expression used by the "match" operator (Regex / String of characters)
subFieldThe name of the sub-field, if applicable. Can be a cookie or a header name, for example (String of characters)

Get the details of a routing rule

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
routeIdYesThe identifier of your TCP route (Number)
ruleIdYesThe identifier of your HTTP routing rule (Number)

Modify the properties of a routing rule

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
routeIdYesThe identifier of your TCP route (Number)
ruleIdYesThe identifier of your HTTP routing rule (Number)
RouteRule.fieldThe name of the field to be tested via the "match" operator (String of characters)
RouteRule.matchThe comparison operator to use (contains, endsWith, exists, in, internal, is, matches, startsWith)
RouteRule.negateIf the "match" operator is inverted or not (Boolean)
RouteRule.patternThe Value or regular expression to use with the "match" operator (Regex / String of characters)
RouteRule.subFieldThe name of the sub-field if applicable (String of characters)

Delete a routing rule

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
routeIdYesThe identifier of your TCP route (Number)
ruleIdYesThe identifier of your HTTP routing rule (Number)

UDP Protocol

Access the UDP protocol elements (Frontend, Farm, etc.).

UDP Farms

List UDP trusses attached to a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
zoneThe name of your zone, ex: all (String of characters)

Add a new UDP farm to a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
displayNameThe name you wish to give to your farm (String of characters)
portThe listening port on your farm. Inherited from the frontend if not defined (Number, 1..65535)
zoneYesThe name of your zone, ex: all (String of characters)

Get the details of a UDP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
farmIdYesThe identifier of your farm (Number)

Modify the properties of a UDP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
farmIdYesThe identifier of your farm (Number)
BackendUdp.displayNameThe name of the farm (String of characters)
BackendUdp.portThe farm's listening port (Number, 1..65000)

Delete a UDP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
farmIdYesThe identifier of your farm (Number)

UDP Servers

List the servers linked to the UDP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
farmIdYesThe identifier of your farm (Number)
addressFilter Values by IPv4 address (IPv4)
statusFilter Values by Server Status (Value)

Adding a server to a UDP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
farmIdYesThe identifier of your farm (Number)
addressYesThe IPv4 address of your server (IPv4)
displayNameThe name given to your server (String of characters)
portThe listening port of your server. Inherited from your farm if not defined (Number, 1..65535)
statusYesIf your server is activated or not (Boolean)

Get the details of a server linked to a UDP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
serverIdYesThe identifier of your server (Number)
farmIdYesThe identifier of your farm (Number)

Modify the properties of a UDP server

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
serverIdYesThe identifier of your server (Number)
farmIdYesThe identifier of your farm (Number)
BackendUdpServer.displayNameThe name of your server (String of characters)
BackendUdpServer.portThe listening port of your server (Number, 1..65535)
BackendUdpServer.statusIf your server is activated or not (Boolean)

Removing a server from a UDP farm

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
serverIdYesThe identifier of your server UDP (Number)
farmIdYesThe identifier of your farm UDP (Number)

Frontends UDP

List UDP frontends attached to a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
defaultFarmIdThe identifier of the UDP farm to which the UDP frontend is linked (Number)
portThe listening port on your frontend (Number, 1..65535)
zoneThe name of your zone, ex: all (String of characters)

Add a UDP frontend to a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
dedicatedIpfoThe list of IP addresses of the remote servers to which your Load Balancer is connected (IPv4[])
defaultFarmIdYesThe default UDP farm identifier for your frontend (Number)
disabledIf your UDP frontend is disabled or enabled (Boolean)
displayNameThe name of your UDP frontend (String of characters)
portYesThe listening port on your frontend (Number, 1..65535)
zoneYesThe name of your zone, ex: all (String of characters)

Get the details of a UDP frontend

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
frontendIdYesThe identifier of your frontend UDP (Number)

Modify the properties of a UDP frontend

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
frontendIdYesThe identifier of your frontend UDP (Number)
FrontendUdp.dedicatedIpfoThe list of IP addresses of the remote servers to which your Load Balancer is connected (IPv4[])
FrontendUdp.disabledIf your UDP frontend is disabled or enabled (Boolean)
FrontendUdp.displayNameThe name of your UDP frontend (String of characters)

Delete a UDP frontend

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
frontendIdYesThe identifier of your frontend UDP (Number)

Other features

Additional IP

List Additional IPs routed on a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)

Service Status

Obtenir l'état des instances d'un service OVHcloud Load Balancer

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)

List the output IPs used by OVH for NAT

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)

Apply changes to a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)

SSL Certificates

List SSL certificates of a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
fingerprintLists the fingerprint of the SSL certificate (String of characters)
serialLists the identification number of the SSL certificate (String of characters)
typeType of SSL certificate (Value)

Add a new SSL object

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
certificateYesAdding the SSL certificate (String of characters)
chainAdding the intermediate SSL certificate (String of characters)
keyYesAdding the private key (String of characters)

Get the details of an SSL object

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
idYesThe identifier of your SSL certificate (Number)

Delete an SSL object

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
idYesThe identifier of your SSL certificate (Number)

Tasks

List current tasks for a OVHcloud Load Balancer service

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
actionYesConsultation of available tasks (Values)

Get the details of a task

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
idYesThe identifier of your task (Number)

Contact

Initiate a contact change

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
contactAdminThe OVH NIC to be configured for the Admin contact of this service (String of characters)
contactBillingThe OVH NIC to be configured for the Admin contact of this service (String of characters)
contactTechThe OVH NIC to be configured for the Admin contact of this service (String of characters)

vRack

Description of the private networks attached to the load balancer

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
subnetAllows to filter according to the network used
vlanAllows to filter according to the vlan used

Add a private network in the vRack

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
displayNameThe name you want to give to the network (String of characters)
farmIdIdentification table of farms that you wish to attach to this private network
natIpAn IP block reserved for the load balancer to reach the servers.
subnetThe IP block of the private network
vlanVlan of the private network in the vRack. 0 if the private network is not in a vlan

Retrieve, modify or delete a private network

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
vrackNetworkIdYesThe identifier of the private network

Modify the list of farms attached to a private network

ParameterRequiredDescription
serviceNameYesThe identifier of your Load Balancer, for example : "loadbalancer-abcdef0123456789" (String of characters)
vrackNetworkIdYesThe identifier of the private network
farmIdYesTable of farm identifiers that you wish to attach to this private network. The Value "null" removes the vrack network id from all farms where it was configured.

Go further

Interact with our user community on https://community.ovh.com.

Related articles