Détails des fonctions API

Base de connaissances

Détails des fonctions API


Icons/System/eye-open Created with Sketch. 266 vues 29.09.2025 Cloud / OVHcloud Load Balancer

Objectif

Ce guide fournit une description détaillée de toutes les fonctions de l'API pour le Load Balancer OVHcloud.

Prérequis

En pratique

Gérer son service OVHcloud Load Balancer via l'API

Toutes les fonctions d'API qui sont utilisées dans la section /ipLoadbalancing sont disponibles sur cette page.

Dans les appels ci-dessous, tous les champs marqués d'une astérisque * sont obligatoires.

Les frontends, fermes et serveurs sont spécifiques au protocole (HTTP, TCP ou UDP) dans lequel ils sont définies. La compatibilité entre ces composants n'est possible qu'au sein du même protocole. Par exemple, un frontend HTTP ne peut être associé qu'à une ferme HTTP, et ne peut pas être utilisé avec une ferme UDP.

Services et zones

Load Balancer OVHcloud

Lister les services actifs

Lister les zones disponibles pour le Load Balancer OVHcloud

Retourner les détails d'un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, ex: IP-1.2.3.4 (chaîne de caractères)

Modifier un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, ex: IP-1.2.3.4 (chaîne de caractères)
Ip.displayNameLe nom que vous souhaitez attribuer au service (chaîne de caractères)
Ip.sslConfigurationLa configuration SSL que vous souhaitez attribuer au service (valeur)

Lister les services attachés au Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, ex: IP-1.2.3.4 (chaîne de caractères)

Lister les fermes existantes et leur type

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, ex: IP-1.2.3.4 (chaîne de caractères)
vrackNetworkIdPermet de filtrer selon le réseau vrack

Lister les zones pouvant être attachées à un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, ex: IP-1.2.3.4 (chaîne de caractères)

Lister les différentes sondes pouvant être utilisées

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, ex: IP-1.2.3.4 (chaîne de caractères)

Lister les différents types de fermes pouvant être utilisées

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, ex: IP-1.2.3.4 (chaîne de caractères)

Lister les différents types de frontends pouvant être utilisés

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, ex: IP-1.2.3.4 (chaîne de caractères)

Lister les différents types d'actions de routage pouvant etre utilisés

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, ex: IP-1.2.3.4 (chaîne de caractères)

Lister les différents types de règles de routage pouvant être utilisés

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, ex: IP-1.2.3.4 (chaîne de caractères)

Service

Obtenir les informations du service

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, ex: IP-1.2.3.4 (chaîne de caractères)

Modifier les informations du service

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, ex: IP-1.2.3.4 (chaîne de caractères)
Service.automaticActive le renouvellement automatique du service (booléen))
Service.deleteAtExpirationActive la suppression du service lors de l'expiration (booléen)
Service.forcedForce le renouvellement automatique (booléen)
Service.periodRenseigne la durée de renouvellement (chaîne de caractères)

Zones

Lister les zones actives pour un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, ex. : IP-1.2.3.4 (chaîne de caractères)

Obtenir les détails d'une zone

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
nameYesLe nom de la zone demandée

Supprimer une zone

Le service sera supprimé à la date d'expiration.

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
nameYesLe nom de la zone à supprimer

Annuler la suppression d'une zone

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
nameYesLe nom de la zone a supprimer

Protocole HTTP

Accéder aux éléments relatifs au protocole HTTP (frontend, ferme, etc.).

Fermes HTTP

Lister les fermes HTTP attachées à un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
zoneLe nom de la zone (chaîne de caractères)

Ajouter une nouvelle ferme HTTP à un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
zoneYesLe nom de la zone (chaîne de caractères)
displayNamele nom que vous souhaitez attribuer à votre ferme (chaîne de caractères)
balanceLa méthode de répartition de charge de votre ferme (valeur)
portLe port d'écoute de votre ferme. Hérité du frontend si non-défini (nombre, 1..65535)
stickinessLe type de persistence de connexion à utiliser pour votre ferme (valeur)
probeLe type de sonde à utiliser sur votre ferme (sonde HTTP)
probe.forceSslL'activation du SSL est forcée pour la sonde (booléen)
probe.intervalL'intervalle en secondes entre chaque test de la sonde. Doit être supérieur à 30. 30 par défaut (nombre)
probe.matchLa méthode de correspondance utilisée. 'default' utilise le comportement standard de HAProxy. 'status' n'est supporté que pour les sondes HTTP (value) [contains, default, internal, matches, status]
probe.negateLe comportement de l'opérateur 'match' est inversé (booléen)
probe.methodLa méthode HTTP utilisée en type 'http'. 'HEAD' peut économiser de la bande passante. 'GET' par défaut (valeur) [HEAD, GET, OPTIONS, internal]
probe.patternLe format de la réponse du serveur quand "UP". Vide pour 'default', liste de statuts séparés par des virgules pour 'status', texte pour 'contains', expression régulière pour 'matches' (chaîne de caractères)
probe.portLe port que la sonde doit utiliser pour tester les serveurs attachés à votre ferme. Ignoré pour les sondes 'oco'. Si non-défini, le port de la ferme est utilisé (nombre)
probe.typeLe type de la sonde ; son fonctionnement (valeur) [HTTP, interne, MySQL, OCO, PgSQL, SMTP, TCP]
probe.urlL'adresse à utiliser par la sonde pour les sondes de type HTTP. Le type est ignoré si ce paramètre est défini (chaîne de caractères)

Obtenir les détails d'une ferme HTTP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
farmIdYesL'identifiant de votre ferme HTTP (nombre)

Modifier les propriétés d'une ferme HTTP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
farmIdYesL'identifiant de votre ferme HTTP (nombre)
BackendHttp.displayNameLe nom de la ferme (chaîne de caractères)
BackendHttp.balanceLe type de répartition de charge (valeur)
BackendHttp.portLe port d'écoute de la ferme (nombre, 1..65000)
BackendHttp.probeLe type de sonde à utiliser (sonde HTTP)
BackendHttp.stickinessLe type de persistence de connexion (valeur)

Supprimer une ferme HTTP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
farmIdYesL'identifiant de votre ferme HTTP (nombre)

Serveurs HTTP

Lister les serveurs liés à la ferme HTTP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
farmIdYesL'identifiant de votre ferme HTTP (nombre)
cookieFiltrer les valeurs par cookie (chaîne de caractères)
addressFiltrer les valeurs par adresse IPv4 (IPv4)
statusFiltrer les valeurs par statut du serveur (valeur)

Ajouter un serveur à une ferme HTTP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
farmIdYesL'identifiant de votre ferme (nombre)
addressYesL'adresse IPv4 de votre serveur (IPv4)
backupSi votre serveur est configuré comme serveur de secours (booléen)
chainLa valeur du certificat SSL intermédiaire (chaîne de caractères)
cookieLa valeur de votre cookie (chaîne de caractères)
displayNameLe nom donné à votre serveur (chaîne de caractères)
portLe port d'écoute de votre serveur. Hérité de votre ferme si non-défini (nombre, 1..65535)
probeLe type de sonde à utiliser (valeur)
proxyProtocolVersionLa version de proxyProtocol à utiliser,
sslYesSi les requêtes envoyées à vos serveurs doivent être chiffrées avec SSL (booléen)
weightYesLe poids de votre serveur pour votre ferme. Un serveur à poids élevé reçoit plus de requêtes (nombre)
statusYesSi votre serveur est activé ou non (booléen)

Obtenir les détails d'un serveur lié à une ferme HTTP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
serverIdYesL'identifiant de votre serveur (nombre)
farmIdYesL'identifiant de votre ferme (nombre)

Modifier les propriétés d'un serveur HTTP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
serverIdYesL'identifiant de votre server-link (nombre)
farmIdYesL'identifiant de votre ferme (nombre)
BackendHttpServer.backupSi votre serveur est configuré comme serveur de secours (booléen)
BackendHttpServer.chainLa valeur du certificat SSL intermédiaire (chaîne de caractères)
BackendHttpServer.cookieLa valeur de votre cookie (chaîne de caractères)
BackendHttpServer.displayNameLe nom de votre serveur (chaîne de caractères)
BackendHttpServer.portLe port d'écoute de votre serveur (nombre, 1..65535)
BackendHttpServer.probeLe type de sonde à utiliser (valeur)
BackendHttpServer.proxyProtocolVersionLa version de proxyProtocol à utiliser,
BackendHttpServer.sslSi les requêtes envoyées à vos serveurs doivent être chiffrées avec SSL (booléen)
BackendHttpServer.statusSi votre serveur est activé ou non (booléen)
BackendHttpServer.weightLe poids de votre serveur pour votre ferme (nombre)

Supprimer un serveur d'une ferme HTTP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
serverIdYesL'identifiant de votre serveur (nombre)
farmIdYesL'identifiant de votre ferme (nombre)

Frontends HTTP

Lister les frontends HTTP attachés à un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
defaultFarmIdL'identifiant de la ferme HTTP à laquelle le frontend HTTP est lié (nombre)
portLe port d'écoute de votre frontend (nombre, 1..65535)
zoneLe nom de votre zone, par exemple: all (chaîne de caractères)

Ajouter un frontend HTTP à un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
allowedSourceLa liste des adresses IPs clientes qui ont accès au Load Balancer (IPv4)
dedicatedIpfoLa liste des adresses IPs des serveurs distants auxquels votre Load Balancer est connecté (IPv4[])
defaultFarmIdL'identifiant de la ferme HTTP par défaut pour votre frontend (nombre)
defaultSslIdL'identifiant du certificat SSL par défaut (nombre)
disabledSi votre frontend HTTP est désactivé ou activé (booléen)
displayNameLe nom de votre frontend HTTP (chaîne de caractères)
hstsSi le support du https strict, HTTP Strict Transport Security est activé ou désactivé (booléen)
httpHeaderL'entête http personnalisé à ajouter (chaîne de caractères)
portYesLe port d'écoute de votre frontend (nombre, 1..65535)
redirectLocationL'URL de redirection http (chaîne de caractères)
sslSi les requêtes envoyées à la ferme HTTP doivent être chiffrées avec SSL ou non (booléen)
zoneYesLe nom de votre zone, ex: all (chaîne de caractères)

Obtenir les détails d'un frontend HTTP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
frontendIdYesL'identifiant de votre frontend HTTP (nombre)

Modifier les propriétés d'un frontend HTTP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
frontendIdYesL'identifiant de votre frontend HTTP (nombre)
FrontendHttp.allowedSourceLa liste des adresses IPs clientes qui ont accès au Load Balancer (IPv4[])
FrontendHttp.dedicatedIpfoLa liste des adresses IPs des serveurs distants auxquels votre Load Balancer est connecté (IPv4[])
FrontendHttp.defaultSslIdL'identifiant du certificat SSL par défaut (nombre)
FrontendHttp.disabledSi votre frontend HTTP est désactivé ou activé (booléen)
FrontendHttp.displayNameLe nom de votre frontend HTTP (chaîne de caractères)
FrontendHttp.hstsSi le support du https strict, HTTP Strict Transport Security est activé ou désactivé (booléen)
FrontendHttp.httpHeaderL'en-tête http personnalisé à ajouter (chaîne de caractères)
FrontendHttp.sslSi les requêtes envoyées à la ferme HTTP doivent être chiffrées avec SSL ou non (booléen)

Supprimer un frontend HTTP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
frontendIdYesL'identifiant de votre frontend (nombre)

Routes HTTP

Les routes sont évaluées une par une, en testant leurs règles de routage. La première route validant toutes ses règles voit son action exécutée, et arrête l'évaluation des routes restantes. L'ordre d'exécution est défini par le type et le poids de la route.

Lister les routes HTTP attachées à un service Load Balancer

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
frontendIdL'identifiant d'un frontend HTTP (nombre)

Ajouter une nouvelle route HTTP à un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
actionYesL'action déclenchée quand toutes les règles de votre route sont validées (RouteHttpAction)
action.statusLe code de retour HTTP attendu (nombre)
action.targetL'identifiant de la ferme, ou le modèle pour l'URL (chaîne de caractères)
action.typeL'action de votre route (chaîne de caractères)
displayNameLe nom de votre route (chaîne de caractères)
frontendIdL'identifiant du frontend HTTP pour lequel votre route est appliquée (nombre)
weightLa priorité de votre route. (nombre) [0 - 255]

Obtenir les détails d'une route HTTP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
routeIdYesL'identifiant de votre route (nombre)

Modifier les propriétés d'une route HTTP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
routeIdYesL'identifiant de votre route (nombre)
routeHttp.actionYesL'action déclenchée quand toutes les règles de votre route sont validées (RouteHttpAction)
routeHttp.statusLe code de retour HTTP attendu (nombre)
routeHttp.targetL'identifiant de la ferme, ou le modèle pour l'URL (chaîne de caractères)
routeHttp.typeL'action de votre route (chaîne de caractères)
routeHttp.displayNameLe nom de votre route (chaîne de caractères)
routeHttp.frontendIdL'identifiant du frontend HTTP pour lequel votre route est appliquée (nombre)
routeHttp.weightLa priorité de votre route. (nombre) [0 - 255]

Supprimer une route HTTP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
routeIdYesL'identifiant de votre route (nombre)

Règles de routage

Lister les règles de routages attachées à une route HTTP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
routeIdYesL'identifiant de votre route HTTP (nombre)

Ajouter les règles de routages attachées à une route HTTP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
routeIdYesL'identifiant de votre route HTTP (nombre)
fieldYesLe nom du champ à tester avec l'opérateur "match" (chaîne de caractères)
matchYesL'opérateur de comparaison (valeur) (contains, endsWith, exists, in, internal, is, matches, startsWith)
negateLe comportement de l'opérateur :code:match est inversé (booléen)
patternLe schéma ou l'expression régulière utilisée par l'opérateur "match" (Regex / Chaîne de caractères)
subFieldLe nom du sous-champ, si applicable. Peut être un cookie ou un nom d'en-tête, par exemple (chaîne de caractères)

Obtenir les détails d'une règle de routage

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
routeIdYesL'identifiant de votre route HTTP (nombre)
ruleIdYesL'identifiant de votre règle de routage HTTP (nombre)

Modifier les propriétés d'une règle de routage

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
routeIdYesL'identifiant de votre route HTTP (nombre)
ruleIdYesL'identifiant de votre règle de routage HTTP (nombre)
RouteRule.fieldLe nom du champ à tester via l'opérateur "match" (chaîne de caractères)
RouteRule.matchL'opérateur de comparaison à utiliser (contains, endsWith, exists, in, internal, is, matches, startsWith)
RouteRule.negateSi l'opérateur "match" est inversé ou non (booléen)
RouteRule.patternLa valeur ou l'expression régulière à utiliser avec l'opérateur "match" (Regex / Chaîne de caractères)
RouteRule.subFieldLe nom du sous-champ si applicable (chaîne de caractères)

Supprimer une règle de routage

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
routeIdYesL'identifiant de votre route HTTP (nombre)
ruleIdYesL'identifiant de votre règle de routage HTTP (nombre)

Protocole TCP

Accéder aux éléments relatifs au protocole TCP (frontend, ferme, etc.).

Fermes TCP

Lister les fermes TCP attachées à un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
zoneLe nom de votre zone, ex: all (chaîne de caractères)

Ajouter une nouvelle ferme TCP à un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
balanceLa méthode de répartition de charge de votre ferme (valeur)
displayNameLe nom que vous souhaitez donner à votre ferme (chaîne de caractères)
portLe port d'écoute de votre ferme. Hérité du frontend si non-défini (nombre, 1..65535)
probeLe type de sonde à utiliser sur votre ferme (sonde HTTP)
probe.forceSslL'activation du SSL est forcée pour la sonde (booléen)
probe.intervalL'intervalle (en secondes) entre chaque test de la sonde. Doit être supérieur à 30. 30 par défaut (nombre)
probe.matchLa méthode de correspondance utilisée. 'default' utilise le comportement standard de HAProxy. 'status' n'est supporté que pour les sondes HTTP (valeur) (contains, default, internal, matches, status)
probe.negateLe comportement de l'opérateur :code:match est inversé (booléen)
probe.methodLa méthode HTTP utilisée en :code:type 'http'. 'HEAD' peut économiser de la bande passante. 'GET' par défaut (valeur) (HEAD, GET, OPTIONS, internal)
probe.patternréponse du serveur quand "UP". Vide pour 'default', liste de statuts séparés par des virgules pour 'status', texte pour 'contains', expression régulière pour 'matches' (chaîne de caractères)
probe.portLe port que la sonde doit utiliser pour tester les serveurs attachés à votre ferme. Ignoré pour les sondes 'oco'. Si non-défini, le port de la ferme est utilisé (nombre)
probe.typeLe type de la sonde ; son fonctionnement (valeur) (HTTP, interne, MySQL, OCO, PgSQL, SMTP ou TCP)
probe.urlL'adresse à utiliser par la sonde pour les sondes de type HTTP. Le :code:type est ignoré si ce paramètre est défini (chaîne de caractères)
stickinessLe type de persistence de connexion à utiliser pour votre ferme (valeur)
zoneYesLe nom de votre zone, ex: all (chaîne de caractères)

Obtenir les détails d'une ferme TCP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
farmIdYesL'identifiant de votre ferme (nombre)

Modifier les propriétés d'une ferme TCP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
farmIdYesL'identifiant de votre ferme (nombre)
BackendTcp.balanceLe type de répartition de charge (valeur)
BackendTcp.displayNameLe nom de la ferme (chaîne de caractères)
BackendTcp.portLe port d'écoute de la ferme (nombre, 1..65000)
BackendTcp.probeLe type de sonde à utiliser (sonde TCP)
BackendTcp.stickinessLe type de persistence de connexion (valeur)

Supprimer une ferme TCP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
farmIdYesL'identifiant de votre ferme (nombre)

Serveurs TCP

Lister les serveurs liés à la ferme TCP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
farmIdYesL'identifiant de votre ferme (nombre)
cookieFiltrer les valeurs par cookie (chaîne de caractères)
addressFiltrer les valeurs par adresse IPv4 (IPv4)
statusFiltrer les valeurs par statut du serveur (valeur)

Ajouter un serveur à une ferme TCP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
farmIdYesL'identifiant de votre ferme (nombre)
addressYesL'adresse IPv4 de votre serveur (IPv4)
backupSi votre serveur est configuré comme serveur de secours (booléen)
chainLa valeur du certificat SSL intermédiaire (chaîne de caractères)
displayNameLe nom donné à votre serveur (chaîne de caractères)
portLe port d'écoute de votre serveur. Hérité de votre ferme si non-défini (nombre, 1..65535)
probeLe type de sonde à utiliser (valeur)
proxyProtocolVersionLa version de proxyProtocol à utiliser,
sslYesSi les requêtes envoyées à vos serveurs doivent être chiffrées avec SSL (booléen)
weightYesLe poids de votre serveur pour votre ferme. Un serveur à poids élevé reçoit plus de requêtes (nombre)
statusYesSi votre serveur est activé ou non (booléen)

Obtenir les détails d'un serveur lié à une ferme TCP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
serverIdYesL'identifiant de votre serveur (nombre)
farmIdYesL'identifiant de votre ferme (nombre)

Modifier les propriétés d'un serveur TCP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
serverIdYesL'identifiant de votre server-link (nombre)
farmIdYesL'identifiant de votre ferme (nombre)
BackendTcpServer.backupSi votre serveur est configuré comme serveur de secours (booléen)
BackendTcpServer.chainLa valeur du certificat SSL intermédiaire (chaîne de caractères)
BackendTcpServer.displayNameLe nom de votre serveur (chaîne de caractères)
BackendTcpServer.portLe port d'écoute de votre serveur (nombre, 1..65535)
BackendTcpServer.probeLe type de sonde à utiliser (valeur)
BackendTcpServer.proxyProtocolVersionLa version de proxyProtocol à utiliser,
BackendTcpServer.sslSi les requêtes envoyées à vos serveurs doivent être chiffrées avec SSL (booléen)
BackendTcpServer.statusSi votre serveur est activé ou non (booléen)
BackendTcpServer.weightLe poids de votre serveur pour votre ferme (nombre)

Supprimer un serveur d'une ferme TCP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
serverIdYesL'identifiant de votre serveur (nombre)
farmIdYesL'identifiant de votre ferme (nombre)

Frontends TCP

Lister les frontends TCP attachés à un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
defaultFarmIdL'identifiant de la ferme TCP à laquelle le frontend TCP est lié (nombre)
portLe port d'écoute de votre frontend (nombre, 1..65535)
zoneLe nom de votre zone, ex: all (chaîne de caractères)

Ajouter un frontend TCP à un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
allowedSourceLa liste des adresses IPs clientes qui ont accès au Load Balancer (IPv4)
dedicatedIpfoLa liste des adresses IPs des serveurs distants auxquels votre Load Balancer est connecté (IPv4[])
defaultFarmIdL'identifiant de la ferme TCP par défaut pour votre frontend (nombre)
defaultSslIdL'identifiant du certificat SSL par défaut (nombre)
disabledSi votre frontend TCP est désactivé ou activé (booléen)
displayNameLe nom de votre frontend TCP (chaîne de caractères)
portYesLe port d'écoute de votre frontend (nombre, 1..65535)
sslSi les requêtes envoyées à la ferme TCP doivent être chiffrées avec SSL ou non (booléen)
zoneYesLe nom de votre zone, ex: all (chaîne de caractères)

Obtenir les détails d'un frontend TCP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
frontendIdYesL'identifiant de votre frontend TCP (nombre)

Modifier les propriétés d'un frontend TCP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
frontendIdYesL'identifiant de votre frontend TCP (nombre)
FrontendTcp.allowedSourceLa liste des adresses IP clientes qui ont accès au Load Balancer (IPv4[])
FrontendTcp.dedicatedIpfoLa liste des adresses IP des serveurs distants auxquels votre Load Balancer est connecté (IPv4[])
FrontendTcp.defaultSslIdL'identifiant du certificat SSL par défaut (nombre)
FrontendTcp.disabledSi votre frontend HTTP est désactivé ou activé (booléen)
FrontendTcp.displayNameLe nom de votre frontend HTTP (chaîne de caractères)
FrontendTcp.sslSi les requêtes envoyées à la ferme HTTP doivent être chiffrées avec SSL ou non (booléen)

Supprimer un frontend TCP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
frontendIdYesL'identifiant de votre frontend (nombre)

Routes TCP

Les routes sont évaluées une par une, en testant leurs règles de routage. La première route validant toutes ses règles voit son action exécutée, et arrête l'évaluation des routes restantes. L'ordre d'exécution est défini par le type et le poids de la route.

Lister les routes TCP attachées à un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
frontendIdL'identifiant d'un frontend TCP (nombre)

Ajouter une nouvelle route TCP à un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
actionYesL'action déclenchée quand toutes les règles de votre route sont validées (RouteHttpAction)
action.targetL'identifiant de la ferme, ou le modèle pour l'URL (chaîne de caractères)
action.typeL'action de votre route (chaîne de caractères)
displayNameLe nom de votre route (chaîne de caractères)
frontendIdL'identifiant du frontend TCP pour lequel votre route est appliquée (nombre)
weightLa priorité de votre route. (nombre) [0 - 255]

Obtenir les détails d'une route TCP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
routeIdYesL'identifiant de votre route (nombre)

Modifier les propriétés d'une route TCP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
routeIdYesL'identifiant de votre route (nombre)
routeTcp.actionL'action à réaliser (routeTcpAction)
routeTcp.targetL'identifiant de la ferme, ou le modèle pour l'URL (chaîne de caractères)
routeTcp.typeL'action de votre route (chaîne de caractères)
routeTcp.displayNameLe nom de votre route (chaîne de caractères)
routeTcp.frontendIdLe frontend TCP pour lequel votre route est appliquée (nombre)
routeTcp.weightLa priorité de votre route (nombre) [0 - 255]

Supprimer une route TCP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
routeIdYesL'identifiant de votre route (nombre)

Règles de routage

Lister les règles de routages attachées à une route TCP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
routeIdYesL'identifiant de votre route TCP (nombre)

Ajouter les règles de routages attachées à une route TCP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
routeIdYesL'identifiant de votre route TCP (nombre)
fieldYesLe nom du champ à tester avec l'opérateur "match" (chaîne de caractères)
matchYesL'opérateur de comparaison (valeur) (contains, endsWith, exists, in, internal, is, matches, startsWith)
negateLe comportement de l'opérateur :code:match est inversé (booléen)
patternLe schéma ou l'expression régulière utilisée par l'opérateur "match" (Regex / Chaîne de caractères)
subFieldLe nom du sous-champ, si applicable. Peut être un cookie ou un nom d'en-tête, par exemple (chaîne de caractères)

Obtenir les détails d'une règle de routage

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
routeIdYesL'identifiant de votre route TCP (nombre)
ruleIdYesL'identifiant de votre règle de routage HTTP (nombre)

Modifier les propriétés d'une règle de routage

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
routeIdYesL'identifiant de votre route TCP (nombre)
ruleIdYesL'identifiant de votre règle de routage HTTP (nombre)
RouteRule.fieldLe nom du champ à tester via l'opérateur "match" (chaîne de caractères)
RouteRule.matchL'opérateur de comparaison à utiliser (contains, endsWith, exists, in, internal, is, matches, startsWith)
RouteRule.negateSi l'opérateur "match" est inversé ou non (booléen)
RouteRule.patternLa valeur ou l'expression régulière à utiliser avec l'opérateur "match" (Regex / Chaîne de caractères)
RouteRule.subFieldLe nom du sous-champ si applicable (chaîne de caractères)

Supprimer une règle de routage

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
routeIdYesL'identifiant de votre route TCP (nombre)
ruleIdYesL'identifiant de votre règle de routage HTTP (nombre)

Protocole UDP

Accéder aux éléments relatifs au protocole UDP (frontend, ferme, etc.).

Fermes UDP

Lister les fermes UDP attachées à un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
zoneLe nom de votre zone, ex: all (chaîne de caractères)

Ajouter une nouvelle ferme UDP à un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
displayNameLe nom que vous souhaitez donner à votre ferme (chaîne de caractères)
portLe port d'écoute de votre ferme. Hérité du frontend si non-défini (nombre, 1..65535)
zoneYesLe nom de votre zone, par exemple : all (chaîne de caractères)

Obtenir les détails d'une ferme UDP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
farmIdYesL'identifiant de votre ferme (nombre)

Modifier les propriétés d'une ferme UDP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
farmIdYesL'identifiant de votre ferme (nombre)
BackendUdp.displayNameLe nom de la ferme (chaîne de caractères)
BackendUdp.portLe port d'écoute de la ferme (nombre, 1..65000)

Supprimer une ferme UDP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
farmIdYesL'identifiant de votre ferme (nombre)

Serveurs UDP

Lister les serveurs liés à la ferme UDP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
farmIdYesL'identifiant de votre ferme (nombre)
addressFiltrer les valeurs par adresse IPv4 (IPv4)
statusFiltrer les valeurs par statut du serveur (valeur)

Ajouter un serveur à une ferme UDP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
farmIdYesL'identifiant de votre ferme (nombre)
addressYesL'adresse IPv4 de votre serveur (IPv4)
displayNameLe nom donné à votre serveur (chaîne de caractères)
portLe port d'écoute de votre serveur. Hérité de votre ferme si non-défini (nombre, 1..65535)
statusYesSi votre serveur est activé ou non (booléen)

Obtenir les détails d'un serveur lié à une ferme UDP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
serverIdYesL'identifiant de votre serveur (nombre)
farmIdYesL'identifiant de votre ferme (nombre)

Modifier les propriétés d'un serveur UDP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
serverIdYesL'identifiant de votre serveur (nombre)
farmIdYesL'identifiant de votre ferme (nombre)
BackendUdpServer.displayNameLe nom de votre serveur (chaîne de caractères)
BackendUdpServer.portLe port d'écoute de votre serveur (nombre, 1..65535)
BackendUdpServer.statusSi votre serveur est activé ou non (booléen)

Supprimer un serveur d'une ferme UDP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
serverIdYesL'identifiant de votre serveur UDP (nombre)
farmIdYesL'identifiant de votre ferme UDP (nombre)

Frontends UDP

Lister les frontends UDP attachés à un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
defaultFarmIdL'identifiant de la ferme UDP à laquelle le frontend UDP est lié (nombre)
portLe port d'écoute de votre frontend (nombre, 1..65535)
zoneLe nom de votre zone, par exemple : all (chaîne de caractères)

Ajouter un frontend UDP à un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
dedicatedIpfoLa liste des adresses IPs des serveurs distants auxquels votre Load Balancer est connecté (IPv4[])
defaultFarmIdYesL'identifiant de la ferme UDP par défaut pour votre frontend (nombre)
disabledSi votre frontend UDP est désactivé ou activé (booléen)
displayNameLe nom de votre frontend UDP (chaîne de caractères)
portYesLe port d'écoute de votre frontend (nombre, 1..65535)
zoneYesLe nom de votre zone, ex: all (chaîne de caractères)

Obtenir les détails d'un frontend UDP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
frontendIdYesL'identifiant de votre frontend UDP (nombre)

Modifier les propriétés d'un frontend UDP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
frontendIdYesL'identifiant de votre frontend UDP (nombre)
FrontendUdp.dedicatedIpfoLa liste des adresses IPs des serveurs distants auxquels votre Load Balancer est connecté (IPv4[])
FrontendUdp.disabledSi votre frontend UDP est désactivé ou activé (booléen)
FrontendUdp.displayNameLe nom de votre frontend UDP (chaîne de caractères)

Supprimer un frontend UDP

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
frontendIdYesL'identifiant de votre frontend UDP (nombre)

Autres fonctionnalités

Additional IP

Lister les Additional IPs routées sur un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)

État du service

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

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)

Lister les IPs de sortie utilisées par OVHcloud pour le NAT

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)

Appliquer les modifications d'un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)

Certificats SSL

Lister les certificats SSL d'un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
fingerprintListe l'empreinte du certificat SSL (chaîne de caractères)
serialListe le numéro d'identification du certificat SSL (chaîne de caractères)
typeType de certificat SSL (valeur)

Ajouter un nouvel objet SSL

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
certificateYesAjout du certificat SSL (chaîne de caractères)
chainAjout du certificat SSL intermédiaire (chaîne de caractères)
keyYesAjout de la clé privée (chaîne de caractères)

Obtenir les détails d'un objet SSL

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
idYesL'identifiant de votre certificat SSL (nombre)

Supprimer un objet SSL

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
idYesL'identifiant de votre certificat SSL (nombre)

Tâches

Lister les tâches en cours pour un service Load Balancer OVHcloud

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
actionYesConsultation des tâches disponibles (valeurs)

Obtenir les détails d'une tâche

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
idYesL'identifiant de votre tâche (nombre)

Contact

Initier un changement de contact

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
contactAdminL'identifiant client OVHcloud à configurer pour le contact administrateur de ce service (chaîne de caractères)
contactBillingL'identifiant client OVHcloud à configurer pour le contact facturation de ce service (chaîne de caractères)
contactTechL'identifiant client OVHcloud à configurer pour le contact technique de ce service (chaîne de caractères)

Pour plus d'informations sur la gestion des contacts OVHcloud, consultez le guide « Gérer les contacts de ses services ».

vRack

Description des réseaux privés attachés au load balancer

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
subnetPermet de filtrer selon le réseau utilisé
vlanPermet de filtrer selon le vlan utilisé

Ajouter un réseau privé dans le vRack

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
displayNameLe nom que vous souhaitez attribuer au réseau (chaîne de caractères)
farmIdTableau d'identifiant de fermes que vous souhaitez attacher à ce réseau privé
natIpUn bloc d'IP réservé au load balancer pour joindre les serveurs
subnetLe bloc d'IP du réseau privé
vlanVlan du réseau privé dans le vRack. 0 si le réseau privé n'est pas dans un vlan

Récupérer, modifier ou supprimer un réseau privé

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
vrackNetworkIdYesL'identifiant du réseau privé

Modifier la liste des fermes attachées à un réseau privé

ParameterRequiredDescription
serviceNameYesL'identifiant de votre Load Balancer, par exemple : "loadbalancer-abcdef0123456789" (chaîne de caractères)
vrackNetworkIdYesL'identifiant du réseau privé
farmIdYesTableau d'identifiant de fermes que vous souhaitez attacher à ce réseau privé. La valeur "null" supprime le vrack network id de toutes les fermes où il était configuré.

Aller plus loin

Échangez avec notre communauté d'utilisateurs.

Articles associés