Prenota un indirizzo IP interno statico

Console

1. Nella console Google Cloud , vai alla pagina Indirizzi IP.

   Vai a indirizzi IP

2. Fai clic su Prenota indirizzo IP statico interno. Potresti dover fare clic sul menu more_vert Altre azioni per visualizzare questo pulsante.
3. Nel campo Nome, inserisci un nome per l'indirizzo IP.
4. Nell'elenco Versione IP, seleziona la versione IP richiesta:
   • Per prenotare un indirizzo IPv4 interno statico, seleziona IPv4.
   • Per prenotare un indirizzo IPv6 interno statico, seleziona IPv6.
5. Negli elenchi Rete e Subnet, seleziona una rete VPC e una subnet, rispettivamente.
6. Specifica come vuoi prenotare l'indirizzo IP:
   • Per gli indirizzi IPv4, per specificare un indirizzo IPv4 interno statico da prenotare, seleziona Fammi scegliere per Indirizzo IP statico, quindi inserisci un indirizzo IP personalizzato. In caso contrario, il sistema assegna automaticamente un indirizzo IPv4 interno statico nella subnet.
   • Per gli indirizzi IPv6, il sistema assegna automaticamente un indirizzo IPv6 interno statico dall'intervallo di indirizzi IPv6 interni della subnet.

7. (Facoltativo) Se vuoi condividere l'indirizzo IPv4 interno statico in diversi frontend, scegli Condiviso nell'elenco Scopo. La selezione predefinita è Non condiviso.

8. Fai clic su Prenota.

gcloud

• Per prenotare un indirizzo IPv4 interno, utilizza il comando compute addresses create:

  gcloud compute addresses create ADDRESS_NAMES \
      --region REGION --subnet SUBNETWORK \
      --addresses IP_ADDRESS
  

  Sostituisci quanto segue:

  • ADDRESS_NAMES: i nomi di uno o più indirizzi [--purpose=SHARED_LOADBALANCER_VIP] che vuoi creare. In caso di più indirizzi, specifica tutti gli indirizzi come elenco, separati da spazi, ad esempio example-address-1 example-address-2 example-address-3
  • REGION: la regione per questa richiesta.
  • SUBNETWORK: la subnet per questo indirizzo IP interno.
  • IP_ADDRESS: l'indirizzo IP da prenotare, che deve rientrare nell'intervallo IP principale della subnet. Se non specificato, un indirizzo IP viene allocato automaticamente dalla subnet.

• Per prenotare un indirizzo IPv6 interno, utilizza il comando compute addresses create. Specifica IPV6 come valore per --ip-version:

  gcloud compute addresses create ADDRESS_NAMES \
      --region REGION --subnet SUBNETWORK \
      --ip-version IPV6
  

  Sostituisci quanto segue:

  • ADDRESS_NAMES: i nomi di uno o più indirizzi che vuoi prenotare. In caso di più indirizzi, specifica tutti gli indirizzi come elenco, separati da spazi, ad esempio, example-address-1 example-address-2 example-address-3
  • REGION: la regione per questa richiesta.
  • SUBNETWORK: la subnet per questo indirizzo IPv6 interno.

  A differenza della prenotazione IPv4 interna, la prenotazione IPv6 interna non supporta la prenotazione di un indirizzo IP specifico dalla subnet. Viene invece allocato automaticamente un indirizzo IPv6 interno /96 dall'intervallo di indirizzi IPv6 interno /64 della subnet.

Esempi

• Prenota un indirizzo IPv4 interno allocato automaticamente da una subnet:

  gcloud compute addresses create example-address-1 \
      --region us-central1 \
      --subnet subnet-1
  

• Per prenotare un indirizzo IPv4 interno specifico da una subnet:

  gcloud compute addresses create example-address-1 \
      --region us-central1 \
      --subnet subnet-1 \
      --addresses 10.128.0.12
  

• Prenota un indirizzo IPv6 interno statico da una subnet:

  gcloud compute addresses create example-address-1 \
      --region us-central1 \
      --subnet subnet-1 \
      --ip-version IPV6
  

• Crea più indirizzi IPv4 passando più di un nome di indirizzo IPv4. Tutti gli indirizzi sono riservati nella stessa subnet:

  gcloud compute addresses create example-address-1 example-address-2 \
      --region us-central1 \
      --subnet subnet-1 \
      --addresses 10.128.0.12,10.128.0.13
  

Terraform

Puoi utilizzare un modulo Terraform per creare un indirizzo IP interno.

Nell'esempio seguente, gli argomenti Terraform hanno valori di esempio che puoi modificare. L'esempio crea due indirizzi IP interni specifici:

module "address" {
  source     = "terraform-google-modules/address/google"
  version    = "~> 4.0"
  project_id = var.project_id # Replace this with your project ID in quotes
  region     = "asia-east1"
  subnetwork = "my-subnet"
  names      = ["internal-address1", "internal-address2"]
  addresses  = ["10.0.0.3", "10.0.0.4"]
}

L'esempio seguente crea due indirizzi IP interni allocati dinamicamente:

module "address" {
  source     = "terraform-google-modules/address/google"
  version    = "~> 4.0"
  project_id = var.project_id # Replace this with your project ID in quotes
  region     = "asia-east1"
  subnetwork = "my-subnet"
  names      = ["internal-address1", "internal-address2"]
}

API

Utilizza il metodo addresses.insert:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses

Per gli indirizzi IPv4 e IPv6, il corpo della richiesta deve includere il campo addressType, che deve essere INTERNAL, il name dell'indirizzo e il subnetwork a cui appartiene l'indirizzo IP. Il corpo della richiesta può includere facoltativamente il purpose dell'indirizzo IP interno.

Inoltre, per gli indirizzi IPv4 interni, puoi lasciare che il sistema allochi automaticamente un indirizzo IP o utilizzare address per specificare un indirizzo IPv4 interno. L'indirizzo IPv4 deve appartenere all'intervallo di indirizzi IP principale della subnet.

{
  "addressType": "INTERNAL",
  "name": "IPV4_ADDRESS_NAME",
  "subnetwork": "regions/REGION/subnetworks/SUBNETWORK",
  "address": "IPV4_ADDRESS"
  "purpose": "GCE_ENDPOINT"
}

Ad esempio:

POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses
{
  "addressType": "INTERNAL",
  "name": "example-ipv4-address-1",
  "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet",
  "address": "10.128.0.12"
  "purpose": "GCE_ENDPOINT"
}

Per gli indirizzi IPv6 interni, devi specificare anche ipVersion come IPV6. Il sistema assegna automaticamente un indirizzo IPv6 interno statico dall'intervallo di indirizzi IPv6 interno della subnet.

{
  "addressType": "INTERNAL",
  "name": "IPV6_ADDRESS_NAME",
  "ipVersion": "IPV6",
  "subnetwork": "regions/REGION/subnetworks/SUBNETWORK",
  "purpose": "GCE_ENDPOINT"
}

Ad esempio:

POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses
{
  "addressType": "INTERNAL",
  "name": "example-ipv6-address-1",
  "ipVersion": "IPV6"
  "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet",
  "purpose": "GCE_ENDPOINT"
}

Console

1. Nella console Google Cloud , vai alla pagina Indirizzi IP.

   Vai a indirizzi IP

2. Fai clic su Indirizzi IP interni.
3. (Facoltativo) Nel campo Filtro, per cercare indirizzi IP effimeri, inserisci ephemeral, quindi seleziona Effimero: tipo dall'elenco a discesa.
4. Seleziona l'indirizzo IP interno che vuoi promuovere.
5. Nel menu Altre azioni (more_vert) alla fine della riga di visualizzazione per l'indirizzo IP selezionato, seleziona Promuovi a indirizzo IP statico.
6. Inserisci un nome per il nuovo indirizzo IP statico, quindi fai clic su Prenota.

gcloud

1. Prima di promuovere un indirizzo IPv6 interno temporaneo esistente, devi conoscere il valore di questo indirizzo IP. Utilizza Google Cloud CLI per effettuare una richiesta describe alla risorsa per ottenere il valore dell'indirizzo IP.

   • Per un'istanza con un indirizzo IPv4, utilizza il seguente comando:

     gcloud compute instances describe INSTANCE_NAME --zone ZONE | grep "networkIP"
     

   • Per un'istanza con un indirizzo IPv6, utilizza il seguente comando:

     gcloud compute instances describe INSTANCE_NAME --zone ZONE | grep "ipv6Address"
     

   • Per una regola di forwarding regionale, utilizza il seguente comando:

     gcloud compute forwarding-rules describe FORWARDING_RULE_NAME --region REGION | grep "IPAddress"
     

     Per una regola di forwarding globale, utilizza il flag --global anziché il flag --region.

2. Promuovi l'indirizzo:

   • Per promuovere uno o più indirizzi IPv4 interni esistenti, utilizza il comando compute addresses create e fornisci il flag --addresses con gli indirizzi IP interni espliciti da promuovere:

     gcloud compute addresses create IPV4_ADDRESS_NAMES \
       --addresses IPV4_ADDRESSES \
       --region REGION \
       --prefix-length PREFIX_LENGTH \
       --subnet SUBNETWORK
     

     Sostituisci quanto segue:

     • IPV4_ADDRESS_NAMES: i nomi degli indirizzi IPv4. In caso di più indirizzi, specifica tutti i nomi degli indirizzi come elenco, separati da spazi, ad esempio, example-address-name-1 example-address-name-2 example-address-name-3. Dichiara i nomi nello stesso ordine in cui dichiari gli indirizzi IP. Ad esempio, supponiamo che tu specifichi i nomi degli indirizzi come example-address-name-1 example-address-name-2 example-address-name-3 e gli indirizzi IPv4 come 192.0.2.0 192.0.2.1 192.0.2.2. In questo scenario, Compute Engine mappa i nomi e gli indirizzi nel seguente modo:

       • example-address-name-1: 192.0.2.0
       • example-address-name-2: 192.0.2.1
       • example-address-name-3: 192.0.2.2

     • IPV4_ADDRESSES: gli indirizzi IPv4 da promuovere. In caso di più indirizzi, specifica tutti gli indirizzi come elenco, separati da spazi, ad esempio 192.0.2.0 192.0.2.1 192.0.2.2.

     • REGION: la regione in cui prenotare questo indirizzo.

     • PREFIX_LENGTH: (Facoltativo). La lunghezza del prefisso dell'intervallo di indirizzi IPv4. Il valore deve essere un numero intero compreso tra 7 e 31. Includi questo campo solo se specifichi un intervallo di indirizzi. Escludi il campo se l'indirizzo IPv4 specificato è un singolo indirizzo IP.

     • SUBNETWORK: la subnet per questa richiesta.

   • Per promuovere uno o più indirizzi IPv6 interni esistenti, utilizza il comando compute addresses create e fornisci il flag --addresses con gli indirizzi IPv6 interni espliciti:

     gcloud compute addresses create IPV6_ADDRESS_NAMES \
      --addresses IPV6_ADDRESSES \
      --region REGION \
      --prefix-length PREFIX_LENGTH \
      --subnet SUBNETWORK
     

     Sostituisci quanto segue:

     • IPV6_ADDRESS_NAMES: i nomi dell'indirizzo. Dichiara i nomi nello stesso ordine in cui dichiari gli indirizzi IPv6. In questo caso, IPV6_ADDRESS_NAME_1 corrisponde a IPV6_ADDRESS_1 e IPV6_ADDRESS_NAME_2 corrisponde a IPV6_ADDRESS_2.
     • IPV6_ADDRESS_1,[IPV6_ADDRESS_2,...]: gli indirizzi IPv6 da promuovere in formato CIDR.
     • PREFIX_LENGTH_1,[PREFIX_LENGTH_2,...]: la lunghezza del prefisso degli indirizzi IPv6.
     • REGION: la regione in cui prenotare questo indirizzo.
     • SUBNETWORK: la subnet per questa richiesta.

     L'indirizzo IPv6 interno rimane collegato all'istanza esistente anche dopo essere stato promosso a indirizzo IPv6 interno statico. Se devi assegnare l'indirizzo IPv6 interno statico appena promosso a un'altra risorsa, prima annulla l'assegnazione dell'indirizzo IPv6 interno statico dall'istanza esistente.

API

Utilizza il metodo addresses.insert:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses

Per gli indirizzi IPv4 e IPv6, il corpo della richiesta deve includere addressType, che deve essere INTERNAL, name dell'indirizzo, address da promuovere e subnetwork a cui appartiene l'indirizzo IP. Per gli indirizzi IPv6, inoltre, il corpo della richiesta deve includere prefixLength con 96 come valore.

• Corpo della richiesta per la promozione degli indirizzi IPv4 interni:

  {
  "name": "ADDRESS_NAME",
  "addressType": "INTERNAL",
  "address": "IP_ADDRESS",
  "subnetwork": "regions/REGION/subnetworks/SUBNETWORK"
  }
  

  Ad esempio:

  POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses
  {
  "name": "example-IPv4-address-1",
  "addressType": "INTERNAL",
  "address": "10.128.0.2",
  "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet"
  }
  

• Corpo della richiesta per la promozione degli indirizzi IPv6 interni:

  {
  "name": "ADDRESS_NAME",
  "addressType": "INTERNAL",
  "address": "IP_ADDRESS",
  "subnetwork": "regions/REGION/subnetworks/SUBNETWORK"
  "prefixLength": 96
  }
  

  Ad esempio:

  POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses
  {
  "name": "example-IPv6-address-1",
  "addressType": "INTERNAL",
  "address": "fd20:0:0::",
  "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet"
  "prefixLength": 96
  }
  

Console

1. Nella console Google Cloud , vai alla pagina Indirizzi IP.

   Vai a Indirizzi IP

2. Fai clic su Indirizzi IP interni.

gcloud

Utilizza il comando gcloud compute addresses list:

gcloud compute addresses list

API

Utilizza 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 richiesta
• REGION: il nome della regione per questa richiesta

Per elencare tutti gli indirizzi in tutte le regioni, utilizza il metodo addresses.aggregatedList:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/addresses

Console

1. Nella console Google Cloud , vai alla pagina Indirizzi IP.

   Vai a indirizzi IP

2. Seleziona la scheda Indirizzi IP interni.
3. (Facoltativo) Nel campo Filtro, inserisci static e poi seleziona Statico: Tipo dall'elenco a discesa.
4. Seleziona l'indirizzo IP interno statico che vuoi rilasciare.

5. Fai clic su Rilascia indirizzo statico, quindi conferma l'operazione facendo clic su Rilascia nella finestra di dialogo.

   Se non vedi questa opzione, fai clic sul menu Altre azioni (more_vert) nella barra dei menu in alto, quindi seleziona Rilascia indirizzo statico dall'elenco.

gcloud

Utilizza il comando compute addresses delete:

gcloud compute addresses delete ADDRESS_NAME \
    --region REGION

Sostituisci quanto segue:

• ADDRESS_NAME: il nome dell'indirizzo da eliminare.
• REGION: la regione a cui appartiene l'indirizzo.

Ad esempio:

gcloud compute addresses delete example-address-to-delete \
    --region us-west1

API

Utilizza il metodo addresses.delete:

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME

Questo esempio elimina un indirizzo nella regione us-west1:

DELETE https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-west1/addresses/example-address-to-delete