--- title: "Primi passi con OVHcloud Public Cloud Gateway" description: "Create e gestite le vostre Gateway Public Cloud dallo Spazio Cliente OVHcloud, dall'API, da ovhcloud-cli o da Terraform." url: https://docs.ovhcloud.com/it/guides/public-cloud/network-services/getting-started-gateway lang: it lastUpdated: 2026-06-11 --- # Primi passi con OVHcloud Public Cloud Gateway ## Obiettivo Una [Gateway](https://www.ovhcloud.com/it/public-cloud/gateway/) OVHcloud fornisce una connettività in uscita sicura (SNAT) per le istanze di una sottorete privata ed è necessaria su tale sottorete per utilizzare gli [Floating IP](https://www.ovhcloud.com/it/public-cloud/floating-ip/) per l'esposizione pubblica di queste risorse private. **Questa guida vi spiega come creare, elencare, modificare ed eliminare una Gateway Public Cloud dallo Spazio Cliente OVHcloud, dall'API OVHcloud, da ovhcloud-cli o da Terraform.** ## Prerequisiti - Possedere un [progetto Public Cloud](https://www.ovhcloud.com/it/public-cloud/) sul vostro account OVHcloud - Disporre di una rete privata con almeno una sottorete nella regione di destinazione (consultate [Configurare il vRack per il Public Cloud](/it/guides/public-cloud/network-services/vrack.md)) - **Per l'API OVHcloud:** delle credenziali API OVHcloud ([Primi passi con le API OVHcloud](/it/guides/manage-and-operate/api/first-steps.md)) - **Per ovhcloud-cli:** [ovhcloud-cli](https://github.com/ovh/ovhcloud-cli) installato e configurato con le vostre credenziali - **Per Terraform:** Terraform installato e il provider OVH configurato ([Come utilizzare Terraform con OVHcloud](/it/guides/public-cloud/cross-functional/how-to-use-terraform.md)) *** ### Accesso allo Spazio Cliente OVHcloud - **Link diretto:** Progetti Public Cloud - **Per accedere ai vostri servizi:** Public Cloud > Selezionate il vostro progetto *** ## Procedura ### Modelli di Gateway Prima di creare una Gateway, scegliete il modello corrispondente alle vostre esigenze di banda passante: | Modello | Banda passante | | ------- | --------------- | | S | fino a 200 Mbps | | M | fino a 500 Mbps | | L | fino a 2 Gbps | | XL | fino a 4 Gbps | | 2XL | fino a 8 Gbps | | 3XL | fino a 16 Gbps | ### Creare una Gateway **Spazio Cliente OVHcloud** Dal vostro progetto Public Cloud, cliccate su Gateway nel menu a sinistra sotto **Network**, poi cliccate su Crea una Gateway. 1. **Selezionate una regione.** Scegliete la regione in cui sono distribuite le vostre istanze private. 2. **Selezionate una taglia.** Scegliete il modello di Gateway in base alle vostre esigenze di banda passante (consultate la tabella precedente). 3. **Nominate e associate una rete.** Inserite un nome per la vostra Gateway e selezionate una rete privata esistente dall'elenco a discesa, oppure cliccate su Aggiungi una rete privata per crearne una direttamente. 4. Cliccate su Crea una Gateway per confermare. Il provisioning della Gateway richiede qualche minuto. Una volta creata, la Gateway compare nella sezione Gateway e la rete privata associata è visibile sotto Reti private. :::info Solo le reti private mono-regione sono supportate dalla Gateway. ::: **API OVHcloud** Connettetevi all'[API OVHcloud](https://api.ovh.com/console/) e utilizzate la seguente chiamata per creare una Gateway insieme a una nuova rete privata e una sottorete in una sola operazione: 🇪🇺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 | Descrizione | | -------------------- | -------------------------------------------------------------------- | | `serviceName` | L'identificativo del vostro progetto Public Cloud | | `regionName` | La regione di destinazione (es. : `GRA9`) | | `model` | Taglia della Gateway: `s`, `m`, `l`, `xl`, `2xl`, `3xl` | | `name` | Nome della vostra Gateway | | `network.name` | Nome della nuova rete privata | | `network.cidr` | CIDR della sottorete (es. : `192.168.1.0/24`) | | `network.enableDhcp` | `true` per attivare il DHCP sulla sottorete | | `network.ipVersion` | `4` (IPv6 non ancora disponibile) | | `network.vlanId` | Identificativo VLAN (2–4000), o vuoto per un'assegnazione automatica | La chiamata restituisce un oggetto `cloud.Operation`. Per associare una Gateway a una sottorete **esistente**, utilizzate: 🇪🇺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) Per recuperare l'identificativo del vostro progetto: 🇪🇺EU▾ [GET/cloud/project](https://eu.api.ovh.com/console/?section=/cloud&branch=v1#get-/cloud/project) **ovhcloud-cli** Utilizzate `ovhcloud cloud network gateway create` con la regione di destinazione e l'opzione `--wait` per attendere il completamento del provisioning. **Creare una Gateway in una rete privata esistente:** ```bash ovhcloud cloud network gateway create \ --cloud-project \ --name my-gateway \ --model s \ --network-id \ --subnet-id \ --wait ``` **Creare una Gateway con una nuova rete privata:** ```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 ``` Modelli disponibili: `s`, `m`, `l`, `xl`, `2xl`, `3xl`. **Terraform** Create un file di configurazione Terraform (es. : `gateway.tf`) con le seguenti risorse: ```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 } ``` Applicate la configurazione: ```bash terraform init terraform apply ``` :::info Sostituite `GRA9` con la vostra regione di destinazione e `` con l'identificativo del vostro progetto Public Cloud. ::: ### Elencare le vostre Gateway **Spazio Cliente OVHcloud** Dal vostro progetto Public Cloud, cliccate su Gateway nel menu a sinistra sotto **Network**. La pagina elenca tutte le Gateway del vostro progetto con la relativa regione, modello, stato e rete associata. **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 | Descrizione | | ------------- | --------------------------------------------------------------- | | `serviceName` | L'identificativo del vostro progetto Public Cloud | | `regionName` | La regione di destinazione | | `subnetId` | (Opzionale) Filtrare per identificativo di sottorete associata | | `withSubnets` | (Opzionale) Includere i dettagli delle sottoreti nella risposta | **ovhcloud-cli** ```bash ovhcloud cloud network gateway list --cloud-project ``` Filtrare per modello di nome: ```bash ovhcloud cloud network gateway list \ --cloud-project \ --filter 'name=~"^my-.*"' ``` ### Modificare una Gateway Potete modificare il nome o il modello (taglia) di una Gateway esistente. **Spazio Cliente OVHcloud** Dall'elenco Gateway, cliccate sul menu ... accanto alla vostra Gateway, poi selezionate Modifica. Modificate il nome o selezionate un nuovo modello, poi confermate. **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-) Trasmettete i campi da modificare nel corpo della richiesta (`name`, `model`, o entrambi). **ovhcloud-cli** ```bash ovhcloud cloud network gateway edit \ --cloud-project \ --name new-name \ --model m ``` Potete utilizzare `--name`, `--model`, o entrambi. **Terraform** Modificate il campo `name` o `model` nel vostro blocco di risorsa `ovh_cloud_project_gateway`, poi applicate: ```bash terraform apply ``` ### Eliminare una Gateway :::warning L'eliminazione di una Gateway è irreversibile. Le istanze che la utilizzano per la loro connettività in uscita perderanno il loro accesso a internet. ::: **Spazio Cliente OVHcloud** Dall'elenco Gateway, cliccate sul menu ... accanto alla vostra Gateway, poi selezionate Elimina e confermate. **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-) La chiamata restituisce un `cloud.Operation`. L'eliminazione è asincrona — verificate lo stato dell'operazione se necessario: 🇪🇺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** Eliminate il blocco di risorsa `ovh_cloud_project_gateway` dal vostro file di configurazione, poi applicate: ```bash terraform apply ``` Per eliminare tutte le risorse della configurazione: ```bash terraform destroy ``` ## Per saperne di più - [Creare una rete privata con una Gateway](/it/guides/public-cloud/network-services/create-private-network-gateway.md) - [Associare un Floating IP a un'istanza Public Cloud](/it/guides/public-cloud/network-services/attach-floating-ip-to-instance.md) - [Concetti di rete Public Cloud](/it/guides/public-cloud/network-services/concepts.md) - [Come utilizzare Terraform con OVHcloud](/it/guides/public-cloud/cross-functional/how-to-use-terraform.md) Se avete bisogno di una formazione o di un'assistenza tecnica per implementare le nostre soluzioni, contattate il vostro referente commerciale o recatevi sulla pagina [Professional Services](https://www.ovhcloud.com/it/professional-services/) per ottenere un preventivo e richiedere un'analisi personalizzata del vostro progetto ai nostri esperti del team Professional Services. Contatta la nostra [Community di utenti](https://community.ovhcloud.com/).