---
title: "Gérer les associations Serveur-IP dans vRack Services"
description: "Découvrez comment lier l'interface privée d'un Serveur dédié à une IP persistante avec le DHCP et le netboot de vRack Services, depuis la console ou l'API"
url: https://docs.ovhcloud.com/fr/guides/network/vrack-services/server-ip-associations
lang: fr
lastUpdated: 2026-11-20
---
> For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/fr/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/fr/llms-full.txt.

# Gérer les associations Serveur-IP dans vRack Services

## Objectif

Une association Serveur-IP lie l'interface privée d'un Serveur dédié à une adresse IP d'un sous-réseau [vRack Services](https://docs.ovhcloud.com/fr/guides/network/vrack-services/global.md). Le service DHCP et netboot de vRack Services attribue alors au serveur la même adresse à chaque démarrage et lui permet de démarrer depuis le réseau privé. Le [démarrage privé](https://docs.ovhcloud.com/fr/guides/bare-metal-cloud/dedicated-servers/private-boot.md) repose sur ces associations : créer une association active le démarrage privé sur le serveur, la supprimer le désactive.

**Ce guide vous explique comment créer, modifier et supprimer des associations Serveur-IP, depuis la console OVHcloud ou avec l'API OVHcloud.**

**Attention :** Modifier ou supprimer l'association d'un serveur qui démarre depuis le réseau privé change l'adresse avec laquelle il démarre, ou le fait démarrer depuis le réseau public à son prochain redémarrage.

## Prérequis

- Disposer d'un [vRack Services](https://docs.ovhcloud.com/fr/guides/network/vrack-services/global.md) rattaché à un [vRack](https://www.ovhcloud.com/fr/network/vrack/), avec un sous-réseau IPv4 sans VLAN et une plage de service.
- Disposer d'un [Serveur dédié](https://www.ovhcloud.com/fr/bare-metal/) compatible avec le [démarrage privé](https://docs.ovhcloud.com/fr/guides/bare-metal-cloud/dedicated-servers/private-boot.md), dans la même région que le vRack Services, rattaché à son vRack, avec l'OVHcloud Link Aggregation (OLA) activée en mode **Full private**.
- Disposer d'un accès à la « console OVHcloud » ou d'identifiants API OVHcloud (consultez le guide « [Premiers pas avec les API OVHcloud](https://docs.ovhcloud.com/fr/guides/manage-and-operate/api/first-steps.md) »).

**Astuce :** Pour activer le démarrage privé sur un seul serveur, vous pouvez aussi partir de son onglet `Connectivité
` : le formulaire du démarrage privé crée l'association, ainsi que le vRack, le vRack Services ou le sous-réseau nécessaires. Consultez le guide « [Activer le démarrage privé sur un serveur dédié OVHcloud](https://docs.ovhcloud.com/fr/guides/bare-metal-cloud/dedicated-servers/private-boot.md)
 ».

***

### Accès à la console OVHcloud

- **Lien direct :** « vRack Services »
- **Pour accéder à vos services :** « Bare Metal Cloud » > « vRack Services »

***

## En pratique

Cette section présente les règles que doit respecter l'adresse d'une association, puis explique comment gérer les associations depuis la console ou l'API.

### Règles d'adressage

L'adresse IP d'une association doit :

- être une adresse IPv4 du sous-réseau ;
- se trouver hors de la plage de service, réservée aux services gérés par OVHcloud ;
- se trouver hors de la plage BGP du sous-réseau, s'il en a une ;
- ne pas être la première ni la dernière adresse du sous-réseau, qui sont réservées ;
- ne pas être déjà utilisée par une autre association.

Chaque serveur ne peut avoir qu'une seule association. OVHcloud ne peut vérifier que les adresses qu'elle gère : assurez-vous qu'aucune autre machine de votre vRack n'utilise déjà l'adresse, par exemple une machine configurée avec une adresse IP statique.

### Gérer les associations

#### Console OVHcloud

Sélectionnez votre vRack Services.
Ouvrez l'onglet « Subnets » et cliquez sur le sous-réseau. Sa page affiche la carte **DHCP & Netboot (association Serveur-IP)**, qui liste chaque association avec son **Nom du serveur** et son **Adresse IP**.
Vous ne pouvez pas ajouter d'association tant que le sous-réseau n'a pas de plage de service, qu'il est tagué avec un VLAN, ou que son vRack Services n'est rattaché à aucun vRack : la carte indique la condition manquante. Les actions sont aussi indisponibles pendant une mise à jour du vRack Services.
**Créer une association**
1. Cliquez sur « Ajouter une association Serveur-IP ». Le panneau **Créer une association Serveur-IP** s'ouvre et affiche le **Subnet**.
2. Dans le champ **Serveur associé**, sélectionnez le serveur. La liste ne montre que les serveurs situés dans la même région que le vRack Services, rattachés à son vRack, en mode OLA **Full private** et sans association.
3. Dans le champ **Adresse IP associée**, saisissez l'adresse IP du serveur.
4. Cliquez sur « Ajouter une association Serveur-IP ».

Le serveur démarre depuis le réseau privé, avec cette adresse, à son prochain redémarrage.
**Modifier une association**
1. Dans la liste, ouvrez le menu d'actions de l'association, puis cliquez sur « Modifier ».
2. Dans le panneau **Modifier l'association Serveur-IP**, saisissez la nouvelle adresse IP. Le serveur ne peut pas être changé.
3. Cliquez sur « Modifier ».

Le serveur utilise la nouvelle adresse à son prochain redémarrage.
**Supprimer une association**
1. Dans la liste, ouvrez le menu d'actions de l'association, puis cliquez sur « Supprimer ».
2. Dans la fenêtre **Supprimer l'association Serveur-IP**, cliquez sur « Supprimer ».

L'adresse IP est libérée et le démarrage privé est désactivé sur le serveur : il démarre depuis le réseau public à son prochain redémarrage.

#### API OVHcloud

Les associations font partie de la configuration du vRack Services : chacune est une entrée de `dedicatedServerInterfaceAssociations`, dans la configuration DHCP de la plage de service du sous-réseau.

**Attention :** Le bloc `dhcp` d'une plage de service et le champ `az` d'un sous-réseau n'existent qu'à partir de la révision 2026-06 de l'API v2 OVHcloud. Si votre compte utilise encore la révision 2025-01, envoyez l'en-tête `X-Schemas-Version: 2026-06` avec les appels `GET` et `PUT` ci-dessous : un `PUT` en révision 2025-01 ne peut pas contenir le bloc `dhcp`, et son absence supprime la configuration DHCP de la plage de service, ce qui arrête le démarrage privé de tous les serveurs qui y sont associés.

1. Listez les interfaces de serveur qui peuvent être associées au vRack Services. Notez l'`uuid` de l'interface du serveur :

   `GET /vrackServices/resource/{vrackServicesId}/eligibleDedicatedServerInterfaces`

2. Récupérez le `checksum` et le `targetSpec` du vRack Services :

   `GET /vrackServices/resource/{vrackServicesId}`

3. Renvoyez le `targetSpec` avec votre modification de `services.serviceRange[].dhcp.dedicatedServerInterfaceAssociations`, accompagné du `checksum` récupéré :

   `PUT /vrackServices/resource/{vrackServicesId}`

   | Action                    | Modification dans `dedicatedServerInterfaceAssociations`                      |
   | ------------------------- | ----------------------------------------------------------------------------- |
   | Créer une association     | Ajoutez une entrée `{"uuid": "<uuid de l'interface>", "ip": "<adresse IP>"}`. |
   | Modifier une association  | Changez l'`ip` de l'entrée.                                                   |
   | Supprimer une association | Retirez l'entrée.                                                             |

   Conservez toutes les autres valeurs du `targetSpec` telles que renvoyées par le `GET`. Un corps de requête complet est présenté dans la section « [Activer le démarrage privé avec l'API OVHcloud](https://docs.ovhcloud.com/fr/guides/bare-metal-cloud/dedicated-servers/private-boot.md#api) » du guide « Activer le démarrage privé sur un serveur dédié OVHcloud », et le fonctionnement du `checksum` et du `targetSpec` dans le guide « [vRack Services - Exposer un service managé sur votre vRack](https://docs.ovhcloud.com/fr/guides/network/vrack-services/global.md) ».

4. Suivez la mise à jour jusqu'à ce que le vRack Services soit `READY` :

   `GET /vrackServices/resource/{vrackServicesId}`
Dans le `currentState` du vRack Services, chaque association indique si le netboot est actif (`netboot`). Le `dhcpConfigurationStatus` de la plage de service vaut `READY`, ou `DRAFT` avec la raison `MISSING_DEDICATED_SERVER_INTERFACE_ASSOCIATIONS` lorsque sa configuration DHCP ne contient aucune association.

## Aller plus loin

[Activer le démarrage privé sur un serveur dédié OVHcloud](https://docs.ovhcloud.com/fr/guides/bare-metal-cloud/dedicated-servers/private-boot.md)

[vRack Services - Exposer un service managé sur votre vRack](https://docs.ovhcloud.com/fr/guides/network/vrack-services/global.md)

Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page [Professional Services](https://www.ovhcloud.com/fr/professional-services/) pour obtenir un devis et faire analyser votre projet par nos experts.

Échangez avec notre [communauté d'utilisateurs](https://community.ovhcloud.com/).
