Reservar una nueva dirección IP interna estática

Console

1. En la consola de Google Cloud, ve a la página Direcciones IP.

   Ir a Direcciones IP

2. Haz clic en Reservar dirección IP estática interna. Es posible que debas hacer clic en el menú more_vert Más acciones para ver este botón.
3. En el campo Nombre, ingresa un nombre de dirección IP.
4. En la lista Versión de IP, elige la versión de IP requerida:
   • Para reservar una dirección IPv4 interna estática, elige IPv4.
   • Para reservar una dirección IPv6 interna estática, elige IPv6.
5. En las listas Red y Subred, elige una red de VPC y una subred respectivamente.
6. Especifica cómo deseas reservar la dirección IP:
   • En direcciones IPv4, para especificar una dirección IPv4 interna estática que se reservará, en Dirección IP estática, elige Permitirme elegir y, luego, ingresa una dirección IP personalizada. De lo contrario, el sistema asignará de forma automática una dirección IPv4 interna estática en la subred.
   • Para las direcciones IPv6, el sistema asigna de forma automática una dirección IPv6 interna estática del rango de direcciones IPv6 interno de la subred.

7. Opcional: Si deseas compartir la dirección IPv4 interna estática en diferentes frontends, en la lista Propósito, elige Compartida. La selección predeterminada es No compartida.

8. Haz clic en Reservar.

gcloud

• Para reservar una dirección IPv4 interna, usa el comando compute addresses create:

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

  Reemplaza lo siguiente:

  • ADDRESS_NAMES: son los nombres de una o más direcciones [--purpose=SHARED_LOADBALANCER_VIP] que deseas crear. En el caso de varias direcciones, especifica todas las direcciones como una lista, separadas por espacios, por ejemplo, example-address-1 example-address-2 example-address-3.
  • REGION: Es la región para esta solicitud.
  • SUBNETWORK: Es la subred para esta dirección IP interna.
  • IP_ADDRESS: Es la dirección IP que se reservará, que debe estar dentro del rango de IP principal de la subred. Si no se especifica, se asigna una dirección IP de forma automática desde la subred.

• Para reservar una dirección IPv6 interna, usa el comando compute addresses create. Especifica IPV6 como el valor de --ip-version:

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

  Reemplaza lo siguiente:

  • ADDRESS_NAMES: Son los nombres de una o más direcciones que deseas reservar. En el caso de varias direcciones, especifica todas las direcciones como una lista, separadas por espacios, por ejemplo, example-address-1 example-address-2 example-address-3.
  • REGION: Es la región para esta solicitud.
  • SUBNETWORK: Es la subred para esta dirección IPv6 interna.

  A diferencia de la reserva IPv4 interna, la reserva IPv6 interna no admite la reserva de una dirección IP específica de la subred. En su lugar, una dirección IPv6 interna /96 se asigna de forma automática a partir del rango de direcciones IPv6 interna de la subred /64.

Ejemplos

• Reserva una dirección IPv4 interna asignada de forma automática desde una subred:

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

• Reserva una dirección IPv4 interna específica desde una subred:

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

• Reserva una dirección IPv6 interna estática desde una subred:

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

• Para crear varias direcciones IPv4, pasa más de un nombre de dirección IPv4; todas las direcciones están reservadas en la misma subred:

  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

Puedes usar un módulo de Terraform para crear una dirección IP interna.

En el siguiente ejemplo, los argumentos de Terraform tienen valores de ejemplo que puedes cambiar. En el ejemplo, se crean dos direcciones IP internas específicas:

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"]
}

En el siguiente ejemplo, se crean dos direcciones IP internas asignadas de forma dinámica:

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

Usa el método addresses.insert:

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

Para las direcciones IPv4 e IPv6, el cuerpo de la solicitud debe incluir el campo addressType, que debe ser INTERNAL, el name de la dirección y la subnetwork a la que pertenece la dirección IP. El cuerpo de la solicitud puede incluir de manera opcional el purpose de la dirección IP interna.

Además, para las direcciones IPv4 internas, puedes permitir que el sistema asigne de forma automática una dirección IP o usar address a fin de especificar una dirección IPv4 interna. La dirección IPv4 debe pertenecer al rango de direcciones IP principal de la subred.

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

Por ejemplo:

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"
}

Para las direcciones IPv6 internas, también debes especificar ipVersion como IPV6. El sistema asigna de forma automática una dirección IPv6 interna estática del rango de direcciones IPv6 interno de la subred.

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

Por ejemplo:

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. En la consola de Google Cloud, ve a la página Direcciones IP.

   Ir a Direcciones IP

2. Haz clic en Direcciones IP internas.
3. Opcional: En el campo Filtro, para buscar direcciones IP efímeras, ingresa ephemeral y, luego, selecciona Efímero: Tipo de la lista desplegable.
4. Selecciona la dirección IP interna que deseas promocionar.
5. En el menú Más acciones (more_vert) al final de la fila de visualización de la dirección IP seleccionada, elige Ascender a dirección IP estática.
6. Proporciona un nombre para la dirección IP estática nueva y haz clic en Reservar.

gcloud

1. Antes de ascender una dirección IPv6 interna efímera existente, debes conocer el valor de esa dirección IP. Usa Google Cloud CLI para realizar una solicitud describe al recurso a fin de obtener el valor de la dirección IP.

   • Para una instancia con una dirección IPv4, usa el siguiente comando:

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

   • Para una instancia con una dirección IPv6, usa el siguiente comando:

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

   • Para una regla de reenvío regional, usa el siguiente comando:

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

     Para una regla de reenvío global, usa la marca --global en lugar de la marca --region.

2. Promueve la dirección:

   • Para ascender runa o más direcciones IPv4 internas existentes, usa el comando compute addresses create y proporciona la marca --addresses con las direcciones IP internas explícitas para ascender:

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

     Reemplaza lo siguiente:

     • IPV4_ADDRESS_NAMES: los nombres de las direcciones IPv4. En el caso de varias direcciones, especifica todos los nombres de direcciones como una lista, separados por espacios, por ejemplo, example-address-name-1 example-address-name-2 example-address-name-3. Declara los nombres en el mismo orden en el que declararás las direcciones IP. Por ejemplo, supongamos que especificas los nombres de las direcciones como example-address-name-1 example-address-name-2 example-address-name-3 y las direcciones IPv4 como 192.0.2.0 192.0.2.1 192.0.2.2. En esta situación, Compute Engine asigna los nombres y las direcciones de la siguiente manera:

       • 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: Son las direcciones IPv4 que se deben ascender. En el caso de varias direcciones, especifica todas las direcciones como una lista, separadas por espacios, por ejemplo, 192.0.2.0 192.0.2.1 192.0.2.2.

     • REGION: Es la región en la que se reservará esta dirección.

     • PREFIX_LENGTH: Opcional La longitud del prefijo del rango de direcciones IPv4. El valor debe ser un número entero entre 7 y 31. Incluye este campo solo si especificas un rango de direcciones. Excluye el campo si la dirección IPv4 especificada es una sola dirección IP.

     • SUBNETWORK: Es la subred de esta solicitud.

   • Para ascender una o más direcciones IPv6 internas existentes, usa el comando compute addresses create y proporciona la marca --addresses con las direcciones IPv6 internas explícitas:

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

     Reemplaza lo siguiente:

     • IPV6_ADDRESS_NAMES: los nombres de la dirección. Declara los nombres en el mismo orden en el que declararás las direcciones IPv6. En este caso, IPV6_ADDRESS_NAME_1 corresponde a IPV6_ADDRESS_1, y IPV6_ADDRESS_NAME_2 a IPV6_ADDRESS_2.
     • IPV6_ADDRESS_1,[IPV6_ADDRESS_2,...]: Son las direcciones IPv6 que se deben ascender en formato CIDR.
     • PREFIX_LENGTH_1,[PREFIX_LENGTH_2,...]: Es la longitud de prefijo de direcciones IPv6.
     • REGION: Es la región en la que se reservará esta dirección.
     • SUBNETWORK: Es la subred de esta solicitud.

     La dirección IPv6 interna permanece adjunta a la instancia existente incluso después de que se asigne a una dirección IPv6 interna estática. Si necesitas asignar la dirección IPv6 interna estática que se acaba de ascender a otro recurso, primero debes anular la asignación de la dirección IPv6 interna estática de la instancia existente.

API

Usa el método addresses.insert:

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

Para las direcciones IPv4 e IPv6, el cuerpo de la solicitud debe incluir el addressType, que debe ser INTERNAL, el name de la dirección, el address que se debe ascender y el subnetwork al que pertenece la dirección IP. Para las direcciones IPv6, además, el cuerpo de la solicitud debe incluir prefixLength con 96 como valor.

• Cuerpo de la solicitud para ascender direcciones IPv4 internas:

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

  Por ejemplo:

  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"
  }
  

• Cuerpo de la solicitud para ascender direcciones IPv6 internas:

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

  Por ejemplo:

  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. En la consola de Google Cloud, ve a la página Direcciones IP.

   Ir a Direcciones IP

2. Haz clic en Direcciones IP internas.

gcloud

Usa el comando gcloud compute addresses list:

gcloud compute addresses list

API

Usa el método addresses.list:

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

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID del proyecto de esta solicitud.
• REGION: El nombre de la región para esta solicitud.

Para enumerar todas las direcciones de todas las regiones, usa el método addresses.aggregatedList:

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

Console

1. En la consola de Google Cloud, ve a la página Direcciones IP.

   Ir a Direcciones IP

2. Selecciona la pestaña Direcciones IP internas.
3. Opcional: En el campo Filtro, ingresa static y, luego, selecciona Estático: Tipo en la lista desplegable.
4. Elige la dirección IP interna estática que deseas liberar.

5. Haz clic en Liberar dirección estática y, luego, haz clic en Liberar en el cuadro de diálogo para confirmar esta operación.

   Si no ves esta opción, haz clic en el menú Más acciones (more_vert) en la barra de menú superior y, luego, selecciona Liberar dirección estática en la lista.

gcloud

Usa el comando compute addresses delete:

gcloud compute addresses delete ADDRESS_NAME \
    --region REGION

Reemplaza lo siguiente:

• ADDRESS_NAME: Es el nombre de la dirección que se borrará.
• REGION: Es la región a la que pertenece la dirección.

Por ejemplo:

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

API

Usa el método addresses.delete:

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

En este ejemplo, se borra una dirección en la región us-west1:

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