--- title: "Primeiros passos com OVHcloud Public Cloud Gateway" description: "Crie e faça a gestão das suas Gateways Public Cloud a partir da área de cliente OVHcloud, da API, da ovhcloud-cli ou do Terraform." url: https://docs.ovhcloud.com/pt/guides/public-cloud/network-services/getting-started-gateway lang: pt lastUpdated: 2026-06-11 --- # Primeiros passos com OVHcloud Public Cloud Gateway ## Objetivo Uma [Gateway](https://www.ovhcloud.com/pt/public-cloud/gateway/) OVHcloud fornece uma conectividade de saída segura (SNAT) para as instâncias de uma sub-rede privada e é necessária nessa sub-rede para utilizar os [Floating IPs](https://www.ovhcloud.com/pt/public-cloud/floating-ip/) para a exposição pública desses recursos privados. **Este guia explica-lhe como criar, listar, modificar e eliminar uma Gateway Public Cloud a partir da área de cliente OVHcloud, da API OVHcloud, da ovhcloud-cli ou do Terraform.** ## Requisitos - Ter um [projeto Public Cloud](https://www.ovhcloud.com/pt/public-cloud/) na sua conta OVHcloud - Dispor de uma rede privada com, pelo menos, uma sub-rede na região de destino (consulte [Configurar a vRack para o Public Cloud](/pt/guides/public-cloud/network-services/vrack.md)) - **Para a API OVHcloud:** credenciais da API OVHcloud ([Primeiros passos com as API OVHcloud](/pt/guides/manage-and-operate/api/first-steps.md)) - **Para a ovhcloud-cli:** [ovhcloud-cli](https://github.com/ovh/ovhcloud-cli) instalada e configurada com as suas credenciais - **Para o Terraform:** Terraform instalado e o provider OVH configurado ([Como utilizar o Terraform com a OVHcloud](/pt/guides/public-cloud/cross-functional/how-to-use-terraform.md)) *** ### Acesso à área de cliente OVHcloud - **Link direto:** Projetos Public Cloud - **Para aceder aos seus serviços:** Public Cloud > Selecione o seu projeto *** ## Instruções ### Modelos de Gateway Antes de criar uma Gateway, escolha o modelo que corresponde às suas necessidades de largura de banda: | Modelo | Largura de banda | | ------ | ---------------- | | S | até 200 Mbps | | M | até 500 Mbps | | L | até 2 Gbps | | XL | até 4 Gbps | | 2XL | até 8 Gbps | | 3XL | até 16 Gbps | ### Criar uma Gateway **Área de cliente OVHcloud** A partir do seu projeto Public Cloud, clique em Gateway no menu à esquerda, em **Network**, e em seguida clique em Criar uma Gateway. 1. **Selecione uma região.** Escolha a região onde estão implementadas as suas instâncias privadas. 2. **Selecione um tamanho.** Escolha o modelo de Gateway em função das suas necessidades de largura de banda (consulte a tabela acima). 3. **Atribua um nome e associe uma rede.** Introduza um nome para a sua Gateway e selecione uma rede privada existente na lista pendente, ou clique em Adicionar uma rede privada para criar uma diretamente. 4. Clique em Criar uma Gateway para confirmar. O aprovisionamento da Gateway demora alguns minutos. Após a criação, a Gateway aparece na secção Gateway e a rede privada associada fica visível em Redes privadas. :::info Apenas as redes privadas de região única são suportadas pela Gateway. ::: **API OVHcloud** Ligue-se à [API OVHcloud](https://api.ovh.com/console/) e utilize a seguinte chamada para criar uma Gateway juntamente com uma nova rede privada e uma sub-rede numa única operação: 🇪🇺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 | Descrição | | -------------------- | -------------------------------------------------------------------- | | `serviceName` | O identificador do seu projeto Public Cloud | | `regionName` | A região de destino (ex.: `GRA9`) | | `model` | Tamanho da Gateway: `s`, `m`, `l`, `xl`, `2xl`, `3xl` | | `name` | Nome da sua Gateway | | `network.name` | Nome da nova rede privada | | `network.cidr` | CIDR da sub-rede (ex.: `192.168.1.0/24`) | | `network.enableDhcp` | `true` para ativar o DHCP na sub-rede | | `network.ipVersion` | `4` (IPv6 ainda não disponível) | | `network.vlanId` | Identificador VLAN (2–4000), ou vazio para uma atribuição automática | A chamada devolve um objeto `cloud.Operation`. Para associar uma Gateway a uma sub-rede **existente**, utilize: 🇪🇺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 obter o identificador do seu projeto: 🇪🇺EU▾ [GET/cloud/project](https://eu.api.ovh.com/console/?section=/cloud&branch=v1#get-/cloud/project) **ovhcloud-cli** Utilize `ovhcloud cloud network gateway create` com a região de destino e a opção `--wait` para aguardar o fim do aprovisionamento. **Criar uma Gateway numa rede privada existente:** ```bash ovhcloud cloud network gateway create \ --cloud-project \ --name my-gateway \ --model s \ --network-id \ --subnet-id \ --wait ``` **Criar uma Gateway com uma nova rede 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 disponíveis: `s`, `m`, `l`, `xl`, `2xl`, `3xl`. **Terraform** Crie um ficheiro de configuração Terraform (ex.: `gateway.tf`) com os seguintes 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 a configuração: ```bash terraform init terraform apply ``` :::info Substitua `GRA9` pela sua região de destino e `` pelo identificador do seu projeto Public Cloud. ::: ### Listar as suas Gateways **Área de cliente OVHcloud** A partir do seu projeto Public Cloud, clique em Gateway no menu à esquerda, em **Network**. A página lista todas as Gateways do seu projeto com a respetiva região, modelo, estado e rede associada. **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) | Campo | Descrição | | ------------- | ---------------------------------------------------------- | | `serviceName` | O identificador do seu projeto Public Cloud | | `regionName` | A região de destino | | `subnetId` | (Opcional) Filtrar por identificador de sub-rede associada | | `withSubnets` | (Opcional) Incluir os detalhes das sub-redes na resposta | **ovhcloud-cli** ```bash ovhcloud cloud network gateway list --cloud-project ``` Filtrar por padrão de nome: ```bash ovhcloud cloud network gateway list \ --cloud-project \ --filter 'name=~"^my-.*"' ``` ### Modificar uma Gateway Pode modificar o nome ou o modelo (tamanho) de uma Gateway existente. **Área de cliente OVHcloud** A partir da lista Gateway, clique no menu ... junto à sua Gateway e, em seguida, selecione Editar. Modifique o nome ou selecione um novo modelo e, em seguida, confirme. **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-) Transmita os campos que pretende modificar no corpo do pedido (`name`, `model`, ou ambos). **ovhcloud-cli** ```bash ovhcloud cloud network gateway edit \ --cloud-project \ --name new-name \ --model m ``` Pode utilizar `--name`, `--model`, ou ambos. **Terraform** Modifique o campo `name` ou `model` no seu bloco de recurso `ovh_cloud_project_gateway` e, em seguida, aplique: ```bash terraform apply ``` ### Eliminar uma Gateway :::warning A eliminação de uma Gateway é irreversível. As instâncias que a utilizam para a sua conectividade de saída perderão o seu acesso à internet. ::: **Área de cliente OVHcloud** A partir da lista Gateway, clique no menu ... junto à sua Gateway, em seguida selecione Eliminar e confirme. **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-) A chamada devolve um `cloud.Operation`. A eliminação é assíncrona — verifique o estado da operação se necessário: 🇪🇺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** Remova o bloco de recurso `ovh_cloud_project_gateway` do seu ficheiro de configuração e, em seguida, aplique: ```bash terraform apply ``` Para eliminar todos os recursos da configuração: ```bash terraform destroy ``` ## Quer saber mais? - [Criar uma rede privada com uma Gateway](/pt/guides/public-cloud/network-services/create-private-network-gateway.md) - [Associar uma Floating IP a uma instância Public Cloud](/pt/guides/public-cloud/network-services/attach-floating-ip-to-instance.md) - [Conceitos de rede Public Cloud](/pt/guides/public-cloud/network-services/concepts.md) - [Como utilizar o Terraform com a OVHcloud](/pt/guides/public-cloud/cross-functional/how-to-use-terraform.md) Se necessitar de formação ou de assistência técnica para implementar as nossas soluções, contacte o seu comercial ou aceda à página [Professional Services](https://www.ovhcloud.com/pt/professional-services/) para obter um orçamento e solicitar uma análise personalizada do seu projeto aos nossos especialistas da equipa Professional Services. Fale com a nossa [comunidade de utilizadores](https://community.ovhcloud.com/).