--- title: "Premiers pas avec OVHcloud Public Cloud Gateway" description: "Créez et gérez vos Gateways Public Cloud depuis l'espace client OVHcloud, l'API, ovhcloud-cli ou Terraform." url: https://docs.ovhcloud.com/fr/guides/public-cloud/network-services/getting-started-gateway lang: fr lastUpdated: 2026-06-11 --- # Premiers pas avec OVHcloud Public Cloud Gateway ## Objectif Une [Gateway](https://www.ovhcloud.com/fr/public-cloud/gateway/) OVHcloud fournit une connectivité sortante sécurisée (SNAT) pour les instances d'un sous-réseau privé et est requise sur ce sous-réseau pour utiliser les [Floating IPs](https://www.ovhcloud.com/fr/public-cloud/floating-ip/) pour l'exposition publique de ces ressources privées. **Ce guide vous explique comment créer, lister, modifier et supprimer une Gateway Public Cloud depuis l'espace client OVHcloud, l'API OVHcloud, ovhcloud-cli ou Terraform.** ## Prérequis - Posséder un [projet Public Cloud](https://www.ovhcloud.com/fr/public-cloud/) dans votre compte OVHcloud - Disposer d'un réseau privé avec au moins un sous-réseau dans la région cible (voir [Configurer vRack pour le Public Cloud](/fr/guides/public-cloud/network-services/vrack.md)) - **Pour l'API OVHcloud :** des identifiants API OVHcloud ([Premiers pas avec les API OVHcloud](/fr/guides/manage-and-operate/api/first-steps.md)) - **Pour ovhcloud-cli :** [ovhcloud-cli](https://github.com/ovh/ovhcloud-cli) installé et configuré avec vos identifiants - **Pour Terraform :** Terraform installé et le provider OVH configuré ([Comment utiliser Terraform avec OVHcloud](/fr/guides/public-cloud/cross-functional/how-to-use-terraform.md)) *** ### Accès à l'espace client OVHcloud - **Lien direct :** Projets Public Cloud - **Pour accéder à vos services :** Public Cloud > Sélectionnez votre projet *** ## En pratique ### Modèles de Gateway Avant de créer une Gateway, choisissez le modèle qui correspond à vos besoins en bande passante : | Modèle | Bande passante | | ------ | ---------------- | | S | jusqu'à 200 Mbps | | M | jusqu'à 500 Mbps | | L | jusqu'à 2 Gbps | | XL | jusqu'à 4 Gbps | | 2XL | jusqu'à 8 Gbps | | 3XL | jusqu'à 16 Gbps | ### Créer une Gateway **Espace client OVHcloud** Depuis votre projet Public Cloud, cliquez sur Gateway dans le menu de gauche sous **Network**, puis cliquez sur Créer une Gateway. 1. **Sélectionnez une région.** Choisissez la région dans laquelle vos instances privées sont déployées. 2. **Sélectionnez une taille.** Choisissez le modèle de Gateway en fonction de vos besoins en bande passante (voir le tableau ci-dessus). 3. **Nommez et associez un réseau.** Saisissez un nom pour votre Gateway et sélectionnez un réseau privé existant dans la liste déroulante, ou cliquez sur Ajouter un réseau privé pour en créer un directement. 4. Cliquez sur Créer une Gateway pour confirmer. Le provisionnement de la Gateway prend quelques minutes. Une fois créée, la Gateway apparaît dans la section Gateway, et le réseau privé associé est visible sous Réseaux privés. :::info Seuls les réseaux privés mono-région sont pris en charge par la Gateway. ::: **API OVHcloud** Connectez-vous à l'[API OVHcloud](https://api.ovh.com/console/) et utilisez l'appel suivant pour créer une Gateway ainsi qu'un nouveau réseau privé et un sous-réseau en une seule opération : 🇪🇺EU▾ [POST/cloud/project/{serviceName}/region/{regionName}/gateway](https://eu.api.ovh.com/console/?section=/cloud&branch=v1#post-/cloud/project/-serviceName-/region/-regionName-/gateway) | Champ | Description | | -------------------- | ------------------------------------------------------------------- | | `serviceName` | L'identifiant de votre projet Public Cloud | | `regionName` | La région cible (ex. : `GRA9`) | | `model` | Taille de la Gateway : `s`, `m`, `l`, `xl`, `2xl`, `3xl` | | `name` | Nom de votre Gateway | | `network.name` | Nom du nouveau réseau privé | | `network.cidr` | CIDR du sous-réseau (ex. : `192.168.1.0/24`) | | `network.enableDhcp` | `true` pour activer le DHCP sur le sous-réseau | | `network.ipVersion` | `4` (IPv6 non encore disponible) | | `network.vlanId` | Identifiant VLAN (2–4000), ou vide pour une attribution automatique | L'appel retourne un objet `cloud.Operation`. Pour associer une Gateway à un sous-réseau **existant**, utilisez : 🇪🇺EU▾ [POST/cloud/project/{serviceName}/region/{regionName}/network/{networkId}/subnet/{subnetId}/gateway](https://eu.api.ovh.com/console/?section=/cloud&branch=v1#post-/cloud/project/-serviceName-/region/-regionName-/network/-networkId-/subnet/-subnetId-/gateway) Pour récupérer l'identifiant de votre projet : 🇪🇺EU▾ [GET/cloud/project](https://eu.api.ovh.com/console/?section=/cloud&branch=v1#get-/cloud/project) **ovhcloud-cli** Utilisez `ovhcloud cloud network gateway create` avec la région cible et l'option `--wait` pour attendre la fin du provisionnement. **Créer une Gateway dans un réseau privé existant :** ```bash ovhcloud cloud network gateway create \ --cloud-project \ --name my-gateway \ --model s \ --network-id \ --subnet-id \ --wait ``` **Créer une Gateway avec un nouveau réseau privé :** ```bash ovhcloud cloud network gateway create \ --cloud-project \ --name my-gateway \ --model s \ --network-name my-network \ --subnet-cidr 192.168.1.0/24 \ --subnet-enable-dhcp \ --wait ``` Modèles disponibles : `s`, `m`, `l`, `xl`, `2xl`, `3xl`. **Terraform** Créez un fichier de configuration Terraform (ex. : `gateway.tf`) avec les ressources suivantes : ```hcl resource "ovh_cloud_project_network_private" "mypriv" { service_name = "" vlan_id = "0" name = "my-network" regions = ["GRA9"] } resource "ovh_cloud_project_network_private_subnet" "myprivsub" { service_name = ovh_cloud_project_network_private.mypriv.service_name network_id = ovh_cloud_project_network_private.mypriv.id region = "GRA9" start = "10.0.0.2" end = "10.0.255.254" network = "10.0.0.0/16" dhcp = true } resource "ovh_cloud_project_gateway" "gateway" { service_name = ovh_cloud_project_network_private.mypriv.service_name name = "my-gateway" model = "s" region = ovh_cloud_project_network_private_subnet.myprivsub.region network_id = tolist(ovh_cloud_project_network_private.mypriv.regions_attributes[*].openstackid)[0] subnet_id = ovh_cloud_project_network_private_subnet.myprivsub.id } ``` Appliquez la configuration : ```bash terraform init terraform apply ``` :::info Remplacez `GRA9` par votre région cible et `` par l'identifiant de votre projet Public Cloud. ::: ### Lister vos Gateways **Espace client OVHcloud** Depuis votre projet Public Cloud, cliquez sur Gateway dans le menu de gauche sous **Network**. La page liste toutes les Gateways de votre projet avec leur région, modèle, statut et réseau associé. **API OVHcloud** 🇪🇺EU▾ [GET/cloud/project/{serviceName}/region/{regionName}/gateway](https://eu.api.ovh.com/console/?section=/cloud&branch=v1#get-/cloud/project/-serviceName-/region/-regionName-/gateway) | Champ | Description | | ------------- | ---------------------------------------------------------------- | | `serviceName` | L'identifiant de votre projet Public Cloud | | `regionName` | La région cible | | `subnetId` | (Optionnel) Filtrer par identifiant de sous-réseau associé | | `withSubnets` | (Optionnel) Inclure les détails des sous-réseaux dans la réponse | **ovhcloud-cli** ```bash ovhcloud cloud network gateway list --cloud-project ``` Filtrer par motif de nom : ```bash ovhcloud cloud network gateway list \ --cloud-project \ --filter 'name=~"^my-.*"' ``` ### Modifier une Gateway Vous pouvez modifier le nom ou le modèle (taille) d'une Gateway existante. **Espace client OVHcloud** Depuis la liste Gateway, cliquez sur le menu ... à côté de votre Gateway, puis sélectionnez Modifier. Modifiez le nom ou sélectionnez un nouveau modèle, puis confirmez. **API OVHcloud** 🇪🇺EU▾ [PUT/cloud/project/{serviceName}/region/{regionName}/gateway/{id}](https://eu.api.ovh.com/console/?section=/cloud&branch=v1#put-/cloud/project/-serviceName-/region/-regionName-/gateway/-id-) Transmettez les champs à modifier dans le corps de la requête (`name`, `model`, ou les deux). **ovhcloud-cli** ```bash ovhcloud cloud network gateway edit \ --cloud-project \ --name new-name \ --model m ``` Vous pouvez utiliser `--name`, `--model`, ou les deux. **Terraform** Modifiez le champ `name` ou `model` dans votre bloc de ressource `ovh_cloud_project_gateway`, puis appliquez : ```bash terraform apply ``` ### Supprimer une Gateway :::warning La suppression d'une Gateway est irréversible. Les instances qui l'utilisent pour leur connectivité sortante perdront leur accès à internet. ::: **Espace client OVHcloud** Depuis la liste Gateway, cliquez sur le menu ... à côté de votre Gateway, puis sélectionnez Supprimer et confirmez. **API OVHcloud** 🇪🇺EU▾ [DELETE/cloud/project/{serviceName}/region/{regionName}/gateway/{id}](https://eu.api.ovh.com/console/?section=/cloud&branch=v1#delete-/cloud/project/-serviceName-/region/-regionName-/gateway/-id-) L'appel retourne un `cloud.Operation`. La suppression est asynchrone — vérifiez le statut de l'opération si nécessaire : 🇪🇺EU▾ [GET/cloud/project/{serviceName}/operation/{operationId}](https://eu.api.ovh.com/console/?section=/cloud&branch=v1#get-/cloud/project/-serviceName-/operation/-operationId-) **ovhcloud-cli** ```bash ovhcloud cloud network gateway delete \ --cloud-project ``` **Terraform** Supprimez le bloc de ressource `ovh_cloud_project_gateway` de votre fichier de configuration, puis appliquez : ```bash terraform apply ``` Pour supprimer toutes les ressources de la configuration : ```bash terraform destroy ``` ## Aller plus loin - [Créer un réseau privé avec une Gateway](/fr/guides/public-cloud/network-services/create-private-network-gateway.md) - [Attacher une Floating IP à une instance Public Cloud](/fr/guides/public-cloud/network-services/attach-floating-ip-to-instance.md) - [Concepts réseau Public Cloud](/fr/guides/public-cloud/network-services/concepts.md) - [Comment utiliser Terraform avec OVHcloud](/fr/guides/public-cloud/cross-functional/how-to-use-terraform.md) Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en œuvre de nos solutions, contactez votre commercial ou rendez-vous sur la page [Professional Services](https://www.ovhcloud.com/fr/professional-services/) pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l'équipe Professional Services. Échangez avec notre [communauté d'utilisateurs](https://community.ovhcloud.com/).