--- title: "Primeros pasos con OVHcloud Public Cloud Gateway" description: "Cree y gestione sus Gateways Public Cloud desde el área de cliente de OVHcloud, la API, ovhcloud-cli o Terraform." url: https://docs.ovhcloud.com/es/guides/public-cloud/network-services/getting-started-gateway lang: es lastUpdated: 2026-06-11 --- # Primeros pasos con OVHcloud Public Cloud Gateway ## Objetivo Una [Gateway](https://www.ovhcloud.com/es-es/public-cloud/gateway/) de OVHcloud proporciona una conectividad saliente segura (SNAT) para las instancias de una subred privada y es necesaria en dicha subred para utilizar las [Floating IPs](https://www.ovhcloud.com/es-es/public-cloud/floating-ip/) para la exposición pública de estos recursos privados. **Esta guía le explica cómo crear, mostrar, modificar y eliminar una Gateway Public Cloud desde el área de cliente de OVHcloud, la API de OVHcloud, ovhcloud-cli o Terraform.** ## Requisitos - Tener un [proyecto Public Cloud](https://www.ovhcloud.com/es-es/public-cloud/) en su cuenta de OVHcloud - Disponer de una red privada con al menos una subred en la región de destino (consulte [Configurar vRack para Public Cloud](/es/guides/public-cloud/network-services/vrack.md)) - **Para la API de OVHcloud:** credenciales de la API de OVHcloud ([Primeros pasos con las API de OVHcloud](/es/guides/manage-and-operate/api/first-steps.md)) - **Para ovhcloud-cli:** [ovhcloud-cli](https://github.com/ovh/ovhcloud-cli) instalado y configurado con sus credenciales - **Para Terraform:** Terraform instalado y el proveedor OVH configurado ([Cómo utilizar Terraform con OVHcloud](/es/guides/public-cloud/cross-functional/how-to-use-terraform.md)) *** ### Acceso al área de cliente de OVHcloud - **Enlace directo:** Proyectos Public Cloud - **Para acceder a sus servicios:** Public Cloud > Seleccione su proyecto *** ## Procedimiento ### Modelos de Gateway Antes de crear una Gateway, elija el modelo que se corresponda con sus necesidades de ancho de banda: | Modelo | Ancho de banda | | ------ | -------------- | | S | hasta 200 Mbps | | M | hasta 500 Mbps | | L | hasta 2 Gbps | | XL | hasta 4 Gbps | | 2XL | hasta 8 Gbps | | 3XL | hasta 16 Gbps | ### Crear una Gateway **Área de cliente de OVHcloud** Desde su proyecto Public Cloud, haga clic en Gateway en el menú de la izquierda, en **Network**, y luego haga clic en Crear una Gateway. 1. **Seleccione una región.** Elija la región en la que están desplegadas sus instancias privadas. 2. **Seleccione un tamaño.** Elija el modelo de Gateway en función de sus necesidades de ancho de banda (consulte la tabla anterior). 3. **Asigne un nombre y asocie una red.** Introduzca un nombre para su Gateway y seleccione una red privada existente en la lista desplegable, o haga clic en Añadir una red privada para crear una directamente. 4. Haga clic en Crear una Gateway para confirmar. El aprovisionamiento de la Gateway tarda unos minutos. Una vez creada, la Gateway aparece en la sección Gateway y la red privada asociada es visible en Redes privadas. :::info La Gateway solo admite redes privadas de una única región. ::: **API de OVHcloud** Conéctese a la [API de OVHcloud](https://api.ovh.com/console/) y utilice la siguiente llamada para crear una Gateway junto con una nueva red privada y una subred en una sola operación: 🇪🇺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) | Campo | Descripción | | -------------------- | ------------------------------------------------------------------- | | `serviceName` | El identificador de su proyecto Public Cloud | | `regionName` | La región de destino (p. ej.: `GRA9`) | | `model` | Tamaño de la Gateway: `s`, `m`, `l`, `xl`, `2xl`, `3xl` | | `name` | Nombre de su Gateway | | `network.name` | Nombre de la nueva red privada | | `network.cidr` | CIDR de la subred (p. ej.: `192.168.1.0/24`) | | `network.enableDhcp` | `true` para activar el DHCP en la subred | | `network.ipVersion` | `4` (IPv6 aún no disponible) | | `network.vlanId` | Identificador VLAN (2–4000), o vacío para una asignación automática | La llamada devuelve un objeto `cloud.Operation`. Para asociar una Gateway a una subred **existente**, utilice: 🇪🇺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) Para obtener el identificador de su proyecto: 🇪🇺EU▾ [GET/cloud/project](https://eu.api.ovh.com/console/?section=/cloud&branch=v1#get-/cloud/project) **ovhcloud-cli** Utilice `ovhcloud cloud network gateway create` con la región de destino y la opción `--wait` para esperar a que finalice el aprovisionamiento. **Crear una Gateway en una red privada existente:** ```bash ovhcloud cloud network gateway create \ --cloud-project \ --name my-gateway \ --model s \ --network-id \ --subnet-id \ --wait ``` **Crear una Gateway con una nueva red privada:** ```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 ``` Modelos disponibles: `s`, `m`, `l`, `xl`, `2xl`, `3xl`. **Terraform** Cree un archivo de configuración de Terraform (p. ej.: `gateway.tf`) con los siguientes recursos: ```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 } ``` Aplique la configuración: ```bash terraform init terraform apply ``` :::info Sustituya `GRA9` por su región de destino y `` por el identificador de su proyecto Public Cloud. ::: ### Mostrar sus Gateways **Área de cliente de OVHcloud** Desde su proyecto Public Cloud, haga clic en Gateway en el menú de la izquierda, en **Network**. La página muestra todas las Gateways de su proyecto con su región, modelo, estado y red asociada. **API de 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) | Campo | Descripción | | ------------- | --------------------------------------------------------------- | | `serviceName` | El identificador de su proyecto Public Cloud | | `regionName` | La región de destino | | `subnetId` | (Opcional) Filtrar por identificador de subred asociada | | `withSubnets` | (Opcional) Incluir los detalles de las subredes en la respuesta | **ovhcloud-cli** ```bash ovhcloud cloud network gateway list --cloud-project ``` Filtrar por patrón de nombre: ```bash ovhcloud cloud network gateway list \ --cloud-project \ --filter 'name=~"^my-.*"' ``` ### Modificar una Gateway Puede modificar el nombre o el modelo (tamaño) de una Gateway existente. **Área de cliente de OVHcloud** Desde la lista Gateway, haga clic en el menú ... situado junto a su Gateway y, a continuación, seleccione Editar. Modifique el nombre o seleccione un nuevo modelo y, a continuación, confirme. **API de 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-) Transmita los campos que desea modificar en el cuerpo de la solicitud (`name`, `model` o ambos). **ovhcloud-cli** ```bash ovhcloud cloud network gateway edit \ --cloud-project \ --name new-name \ --model m ``` Puede utilizar `--name`, `--model` o ambos. **Terraform** Modifique el campo `name` o `model` en su bloque de recurso `ovh_cloud_project_gateway` y, a continuación, aplique: ```bash terraform apply ``` ### Eliminar una Gateway :::warning La eliminación de una Gateway es irreversible. Las instancias que la utilizan para su conectividad saliente perderán su acceso a internet. ::: **Área de cliente de OVHcloud** Desde la lista Gateway, haga clic en el menú ... situado junto a su Gateway, seleccione Eliminar y confirme. **API de 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-) La llamada devuelve un `cloud.Operation`. La eliminación es asíncrona — compruebe el estado de la operación si es necesario: 🇪🇺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** Elimine el bloque de recurso `ovh_cloud_project_gateway` de su archivo de configuración y, a continuación, aplique: ```bash terraform apply ``` Para eliminar todos los recursos de la configuración: ```bash terraform destroy ``` ## Más información - [Crear una red privada con una Gateway](/es/guides/public-cloud/network-services/create-private-network-gateway.md) - [Asociar una Floating IP a una instancia Public Cloud](/es/guides/public-cloud/network-services/attach-floating-ip-to-instance.md) - [Conceptos de red de Public Cloud](/es/guides/public-cloud/network-services/concepts.md) - [Cómo utilizar Terraform con OVHcloud](/es/guides/public-cloud/cross-functional/how-to-use-terraform.md) Si necesita formación o asistencia técnica para implementar nuestras soluciones, póngase en contacto con su comercial o acceda a la página [Professional Services](https://www.ovhcloud.com/es-es/professional-services/) para solicitar un presupuesto y un análisis personalizado de su proyecto a nuestros expertos del equipo Professional Services. Interactúe con nuestra [comunidad de usuarios](https://community.ovhcloud.com/).