Prenota un indirizzo IP esterno statico
Puoi prenotare indirizzi IP esterni statici. Puoi anche elencare e rilasciare gli indirizzi IP esterni statici prenotati. Per assegnare un indirizzo IP esterno statico a un'istanza di macchina virtuale (VM), consulta Configura indirizzi IP esterni statici.
Gli indirizzi IP esterni possono essere statici o temporanei. Se una VM richiede un indirizzo IP esterno fisso che non cambia, puoi ottenere un indirizzo IP esterno statico. Puoi prenotare nuovi indirizzi IP esterni o promuovere indirizzi IP esterni temporanei esistenti.
Se hai bisogno di un indirizzo IP interno statico, consulta Prenota un indirizzo IP interno statico.
Prima di iniziare
- Scopri di più sugli indirizzi IP.
- Scopri di più su quote e limiti per gli indirizzi IP esterni statici.
- Scopri di più sui prezzi degli indirizzi IP esterni.
- Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione è il processo mediante il quale la tua identità
viene verificata per l'accesso ai Google Cloud servizi e alle API. Per eseguire codice o
esempi da un ambiente di sviluppo locale, puoi autenticarti nel seguente modo.
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
compute.addresses.create
-
compute.addresses.createInternal
-
compute.networks.list
-
compute.subnetworks.use
-
compute.subnetworks.list
Solo una risorsa alla volta può utilizzare un indirizzo IP esterno statico.
Non è possibile verificare se un indirizzo IP è statico o temporaneo dopo che è stato assegnato a una risorsa. Puoi confrontare l'indirizzo IP con l'elenco di indirizzi IP esterni statici prenotati per il progetto. Utilizza il sottocomando
gcloud compute addresses list
per visualizzare un elenco di indirizzi IP esterni statici disponibili per il progetto.Ogni VM può avere più interfacce di rete e a ogni interfaccia possono essere assegnati i seguenti indirizzi IP in base al tipo di stack:
- Interfacce solo IPv4:
- Un indirizzo IPv4 interno (obbligatorio)
- Un indirizzo IPv4 esterno (facoltativo)
- Interfacce a doppio stack (IPv4 e IPv6):
- Un indirizzo IPv4 interno (obbligatorio)
- Un indirizzo IPv4 esterno (facoltativo)
- Un intervallo di indirizzi IPv6
/96
, interno o esterno, ma non entrambi (obbligatorio)
- Interfacce solo IPv6 (Anteprima):
- Un intervallo di indirizzi IPv6
/96
, interno o esterno, ma non entrambi (obbligatorio)
- Un intervallo di indirizzi IPv6
- Interfacce solo IPv4:
Non puoi annullare l'assegnazione o modificare l'indirizzo IPv6 esterno di una VM con un'interfaccia di rete solo IPv6. Tuttavia, puoi promuovere un indirizzo IP esterno temporaneo di una risorsa a indirizzo IP esterno statico in modo che rimanga prenotato anche dopo l'eliminazione della risorsa.
Non puoi modificare il nome di un indirizzo IP statico.
- Nella console Google Cloud , vai alla pagina Indirizzi IP.
- Fai clic su Prenota indirizzo IP statico esterno.
- Nel campo Nome, inserisci un nome per l'indirizzo IP.
- Specifica se il livello di servizio di rete è Premium o Standard. La prenotazione di indirizzi statici IPv6 è supportata solo nel livello Premium.
- Specifica se si tratta di un indirizzo IPv4 o IPv6.
- Specifica se questo indirizzo IP è regionale o globale.
- Se stai prenotando un indirizzo IP statico per un bilanciatore del carico globale, scegli Globale e poi fai clic su Prenota.
- Se stai prenotando un indirizzo IP statico per una VM o per un bilanciatore del carico regionale, scegli Regionale, quindi seleziona la regione in cui creare l'indirizzo.
Se prenoti un indirizzo IPv6 esterno regionale, scegli anche quanto segue:
- Rete: la rete VPC
- Subnet: la subnet da cui assegnare l'indirizzo IPv6 regionale statico
- Tipo di endpoint: scegli Istanza VM o Bilanciatore del carico di rete.
(Facoltativo) Se stai prenotando l'indirizzo IP esterno statico per una VM, seleziona una VM nell'elenco Collegato a a cui collegare l'indirizzo IP.
Fai clic su Prenota per prenotare l'indirizzo IP.
ADDRESS_NAME
: il nome che vuoi associare a questo indirizzo.REGION
: per gli indirizzi IP esterni regionali, specifica una regione per l'indirizzo IP.SUBNET_NAME
: per gli indirizzi IPv6 esterni regionali, specifica la subnet da cui assegnare l'indirizzo IPv6 regionale statico. La subnet deve avere un intervallo di indirizzi IPv6 esterni assegnato.IP_VERSION
: per gli indirizzi IP globali, specifica la versione IP,IPv4
oIPv6
.ENDPOINT_TYPE
: per gli indirizzi IPv6 esterni regionali, specifica il tipo di endpoint,VM
oNETLB
.Per creare un indirizzo IPv4 regionale, chiama il metodo
addresses.insert
regionale:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses
Il corpo della richiesta deve contenere quanto segue:
{ "name": "ADDRESS_NAME" }
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto per questa richiestaREGION
: il nome della regione per questa richiestaADDRESS_NAME
: il nome che vuoi associare all'indirizzo
Per gli indirizzi IPv4 statici globali, chiama il metodo
globalAddresses.insert
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses
Il corpo della richiesta deve contenere quanto segue:
{ "name": "ADDRESS_NAME" }
Per gli indirizzi IPv6 statici globali, chiama il metodo
globalAddresses.insert
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses
Il corpo della richiesta deve contenere quanto segue:
{ "name": "ADDRESS_NAME", "ipVersion": "IPV6" }
Per visualizzare il risultato, utilizza il metodo
addresses.get
.Per gli indirizzi IPv6 statici regionali, chiama il metodo
addresses.insert
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses
Il corpo della richiesta deve contenere quanto segue:
{ "name": "ADDRESS_NAME", "ipVersion": "IPV6", "ipv6EndpointType": "VM|LB", "networkTier": "PREMIUM", "subnetwork": "SUBNET" }
Sostituisci
SUBNET
con la subnet per questo progetto.Per visualizzare il risultato, utilizza il metodo
addresses.get
.- Vai alla pagina Indirizzi IP.
- Fai clic su Indirizzi IP esterni.
- (Facoltativo) Nel campo Filtro, cerca l'indirizzo IP temporaneo che vuoi promuovere.
- Nel menu Altre azioni ( ) dell'indirizzo IP che vuoi promuovere, seleziona Promuovi a indirizzo IP statico.
- Inserisci un nome per il nuovo indirizzo IP statico, quindi fai clic su Prenota.
Per promuovere un indirizzo IPv4 esterno temporaneo a un indirizzo IPv4 esterno statico, fornisci l'indirizzo IP esterno temporaneo utilizzando il flag
--addresses
con il comandocompute addresses create
. Utilizza il flagregion
per promuovere un indirizzo IP regionale temporaneo o il flagglobal
per promuovere un indirizzo IP globale temporaneo.gcloud compute addresses create ADDRESS_NAME --addresses=IP_ADDRESS \ [--region=REGION | --global]
Sostituisci quanto segue:
ADDRESS_NAME
: il nome che vuoi associare a questo indirizzo.IP_ADDRESS
: l'indirizzo IP che vuoi promuovere.REGION
: la regione a cui appartiene l'indirizzo IP regionale.
Per promuovere un indirizzo IPv6 esterno regionale temporaneo a un indirizzo IPv6 esterno regionale statico, fornisci l'indirizzo IP esterno temporaneo utilizzando il flag
--addresses
con il comandogcloud compute addresses create
.gcloud compute addresses create ADDRESS_NAME \ --region=REGION \ --addresses=IPV6_ADDRESS \ --prefix-length=96
Sostituisci quanto segue:
ADDRESS_NAME
: un nome per la risorsa dell'indirizzo IP.REGION
: la regione della risorsa dell'indirizzo IPv6.IPV6_ADDRESS
: l'indirizzo IPv6 che stai promuovendo.
Per gli indirizzi IPv4, il corpo della richiesta deve contenere i seguenti campi:
{ "name": "ADDRESS_NAME", "address": "IPV4_ADDRESS" "addressType": "EXTERNAL" }
Per gli indirizzi IPv6, il corpo della richiesta deve contenere i seguenti campi:
{ "name": "ADDRESS_NAME", "address": "IPV6_ADDRESS" "prefixLength": 96 "addressType": "EXTERNAL" }
Sostituisci quanto segue:
ADDRESS_NAME
: il nome che vuoi associare a questo indirizzoIPV4_ADDRESS|IPV6_ADDRESS
: l'indirizzo IPv4 o IPv6 che vuoi promuovereREGION
: la regione a cui appartiene l'indirizzo IPv4 o IPv6PROJECT_ID
: l'ID progetto per questa richiesta
Nella console Google Cloud , vai alla pagina Indirizzi IP.
Fai clic su Indirizzi IP esterni.
Per elencare tutti gli indirizzi IP, utilizza il seguente comando:
gcloud compute addresses list
Per elencare tutti gli indirizzi IP globali, utilizza il seguente comando:
gcloud compute addresses list --global
Per elencare tutti gli indirizzi IP regionali in una determinata regione, utilizza il seguente comando:
gcloud compute addresses list \ --regions=REGION
Sostituisci
REGION
con la regione per cui vuoi elencare gli indirizzi. Puoi elencare gli indirizzi di più regioni specificando i nomi delle regioni separati da virgole:gcloud compute addresses list \ --regions=REGION1,REGION2,..REGION_n_
Per elencare gli indirizzi IPv4 o IPv6 regionali, chiama il metodo
addresses.list
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto per questa richiestaREGION
: il nome della regione per questa richiesta
Per elencare tutti gli indirizzi in tutte le regioni, chiama il metodo
addresses.aggregatedList
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/addresses
Per elencare gli indirizzi IPv4 o IPv6 globali, chiama il metodo
globalAddresses.list
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto per questa richiestaNella console Google Cloud , vai alla pagina Indirizzi IP.
Fai clic su Indirizzi IP esterni.
Fai clic sull'indirizzo IP di cui vuoi visualizzare maggiori informazioni.
Per un indirizzo IPv4 o IPv6 globale, utilizza il seguente comando:
gcloud compute addresses describe ADDRESS_NAME --global
Per un indirizzo IPv4 o IPv6 regionale, utilizza il seguente comando:
gcloud compute addresses describe ADDRESS_NAME --region=REGION
Per descrivere un indirizzo IPv4 o IPv6 regionale, chiama il metodo
addresses.get
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto per la richiestaREGION
: il nome della regione per la richiestaADDRESS_NAME
: il nome dell'indirizzo IP
Per descrivere un indirizzo IPv4 o IPv6 globale, chiama il metodo
globalAddresses.get
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses/ADDRESS_NAME
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto per la richiestaADDRESS_NAME
: il nome dell'indirizzo IP
Se l'indirizzo IP non viene utilizzato da una risorsa, viene restituito al pool di indirizzi IP esterni disponibili.
Se l'indirizzo IP viene utilizzato da una risorsa, rimane collegato alla risorsa finché non viene eliminata.
Nella console Google Cloud , vai alla pagina Indirizzi IP.
Fai clic su Indirizzi IP esterni.
(Facoltativo) Nel campo Filtro, inserisci
static
e poi seleziona Statico: Tipo dall'elenco a discesa.Seleziona l'indirizzo IP esterno statico che vuoi rilasciare.
Fai clic su Rilascia indirizzo statico.
Se non vedi questa opzione, fai clic sul menu Altre azioni (
) nella barra dei menu in alto, quindi seleziona Rilascia indirizzo statico dall'elenco.Per rilasciare un indirizzo IPv4 o IPv6 regionale, chiama il metodo
addresses.delete
:DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto per questa richiestaREGION
: il nome della regione per questa richiestaADDRESS_NAME
: il nome dell'indirizzo IP
Per rilasciare un indirizzo IPv4 o IPv6 globale, chiama il metodo
globalAddresses.delete
:DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses/ADDRESS_NAME
Sostituisci quanto segue:
ADDRESS_NAME
: il nome dell'indirizzo IPPROJECT_ID
: l'ID progetto per questa richiesta
- Scopri come configurare indirizzi IP esterni statici per una VM nuova o esistente.
- Scopri di più sulle specifiche dell'indirizzo IP per le regole di forwarding e su come utilizzare le regole di forwarding nella Panoramica delle regole di forwarding.
- Scopri di più sugli indirizzi IP.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Terraform
Per utilizzare gli esempi di Terraform in questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.
Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione Google Cloud .
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Per saperne di più, consulta la sezione Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per prenotare e gestire gli indirizzi IP statici, chiedi all'amministratore di concederti il ruolo IAM Compute Network Admin (
roles/compute.networkAdmin
) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.Questo ruolo predefinito contiene le autorizzazioni necessarie per riservare e gestire gli indirizzi IP statici. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per prenotare e gestire gli indirizzi IP statici sono necessarie le seguenti autorizzazioni:
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Informazioni sugli indirizzi IP esterni statici
Un indirizzo IP esterno statico è l'indirizzo IP riservato alla tua risorsa finché non decidi di rilasciarlo. Se hai un indirizzo IP su cui i tuoi clienti o utenti fanno affidamento per accedere al tuo servizio, puoi prenotarlo in modo che solo la tua risorsa possa utilizzarlo. Puoi anche promuovere un indirizzo IP esterno temporaneo a indirizzo IP esterno statico.
Per saperne di più, vedi Indirizzi IP.
La seguente tabella elenca gli indirizzi IP esterni statici supportati da Google Cloud.
Tipo di indirizzo IP Risorsa Intervallo IP Origine Associate a Indirizzi IPv4 esterni a livello di regione VM e bilanciatori del carico regionali /32
Pool di indirizzi IP esterni di Google Progetto Indirizzi IPv6 esterni regionali VM e bilanciatori del carico regionali supportati /96
Intervallo di indirizzi IPv6 esterni della subnet Subnet Indirizzi IPv4 esterni globali Bilanciatori del carico globali /32
Pool di indirizzi IP esterni di Google Progetto Indirizzi IPv6 esterni globali Bilanciatori del carico globali /64
Pool di indirizzi IP esterni di Google Progetto Per un elenco dei bilanciatori del carico regionali e globali, consulta il Riepilogo dei tipi di bilanciatori del carico.
Gli indirizzi IP esterni assegnati si trovano sullo stesso host fisico della VM e nella stessa regione della VM per tutti gli scopi, inclusi routing, latenza e prezzi. Ciò vale indipendentemente dalle informazioni di ricerca della geolocalizzazione internet.
Limitazioni
Nota: le interfacce di rete possono ricevere traffico da più regole di forwarding, che potrebbero gestire altri indirizzi IP esterni. Non c'è un limite al numero di indirizzi IP esterni che possono fare riferimento a un'interfaccia di rete tramite queste regole di forwarding, ma a ogni interfaccia di rete può essere assegnato un solo indirizzo IPv4 esterno e un solo intervallo di indirizzi IPv6
/96
esterno.Per saperne di più sul bilanciamento del carico e sulle regole di forwarding, consulta la documentazione sul bilanciamento del carico.
Prenota un nuovo indirizzo IP esterno statico
Dopo aver prenotato l'indirizzo, assegnalo a una nuova VM durante la creazione o a una VM esistente.
Console
gcloud
Per prenotare un indirizzo IP esterno statico, utilizza il comando
gcloud compute addresses create
.Segui queste istruzioni per prenotare un indirizzo IPv4 o IPv6 esterno statico:
Indirizzo IP globale
Per prenotare un indirizzo IP globale:gcloud compute addresses create ADDRESS_NAME \ --global \ --ip-version=IP_VERSION
Indirizzo IPv4 esterno regionale
Per prenotare un indirizzo IPv4 esterno regionale:gcloud compute addresses create ADDRESS_NAME \ --region=REGION
Indirizzo IPv6 esterno regionale
Per prenotare un indirizzo IPv6 esterno regionale:gcloud compute addresses create ADDRESS_NAME \ --region=REGION \ --subnet=SUBNET_NAME \ --ip-version=IPV6 \ --endpoint-type=ENDPOINT_TYPE
Sostituisci quanto segue:
Per visualizzare il risultato, utilizza il comando
gcloud compute addresses describe
:gcloud compute addresses describe ADDRESS_NAME
Terraform
Puoi utilizzare la risorsa
google_compute_address
per creare un indirizzo IP esterno regionale.Il seguente esempio mostra come utilizzare la risorsa
google_compute_global_address
per creare un indirizzo IPv6 esterno globale:API
Vai
Java
Python
Promuovere un indirizzo IP esterno temporaneo
Se la tua VM ha un indirizzo IP esterno temporaneo e vuoi assegnare in modo permanente l'indirizzo IP al tuo progetto, promuovi l'indirizzo IP esterno temporaneo a un indirizzo IP esterno statico. La promozione di un indirizzo IP esterno temporaneo a riservato non causa l'eliminazione dei pacchetti inviati alla VM. Google Cloud Sono inclusi i pacchetti inviati alla VM direttamente o tramite un bilanciatore del carico.
Console
gcloud
Utilizza le seguenti istruzioni per promuovere un indirizzo IPv4 o IPv6 esterno statico:
API
Per promuovere un indirizzo IP regionale temporaneo, chiama il metodo
addresses.insert
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses
Per promuovere un indirizzo IP globale temporaneo, invia una richiesta
POST
al seguente URI:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses
Specifica i valori per i campi obbligatori del corpo della richiesta:
Go
Java
Python
L'indirizzo IP esterno rimane collegato alla VM anche dopo la promozione a indirizzo IP esterno statico. Se devi assegnare l'indirizzo IP esterno statico appena promosso a un'altra risorsa, annulla l'assegnazione dell'indirizzo IP esterno statico dalla VM esistente.
Elenca indirizzi IP esterni statici
Per elencare gli indirizzi IP esterni statici che hai prenotato per il tuo progetto:
Console
gcloud
Utilizza il comando
gcloud compute addresses list
:API
Go
Java
Python
Descrivere un indirizzo IP esterno statico
Per ottenere informazioni su un indirizzo IP esterno statico, segui questi passaggi.
Console
gcloud
Utilizza il comando
gcloud compute addresses describe
. SostituisciADDRESS_NAME
con il nome dell'indirizzo IP esterno che vuoi descrivere.API
Vai
Java
Python
Rilascia un indirizzo IP esterno statico
Se non hai più bisogno di un indirizzo IP IPv4 o IPv6 esterno statico, puoi rilasciarlo eliminando la risorsa indirizzo IP.
Se utilizzi la console Google Cloud , puoi rilasciare un indirizzo IP statico solo se non è utilizzato da un'altra risorsa.
Se utilizzi gcloud CLI o l'API, puoi rilasciare un indirizzo IP indipendentemente dal fatto che venga utilizzato da un'altra risorsa.
Console
gcloud
Utilizza il comando
compute addresses delete
:gcloud compute addresses delete ADDRESS_NAME
Sostituisci
ADDRESS_NAME
con il nome dell'indirizzo IPv4 o IPv6 da rilasciare.API
Go
Java
Python
Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-14 UTC.
-