Crear y usar rangos internos

En este documento, se describe cómo crear, usar y borrar rangos internos.

Los rangos internos te ayudan a administrar un espacio de direcciones IP unificado en las redes de nube privada virtual (VPC), ya que te permiten asignar bloques de direcciones IP internas y especificar cómo se pueden usar.

Antes de comenzar

Roles obligatorios

Para obtener los permisos que necesitas para trabajar con rangos internos, pídele a tu administrador que te otorgue el rol de IAM Administrador de red de Compute (roles/compute.networkAdmin) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Reserva rangos internos

Cuando creas un rango interno, debes especificar al menos dos elementos: las direcciones IP que se asignarán y la red en la que se asignarán las direcciones. Puedes crear un rango interno de IPv4 o IPv6 con un bloque CIDR específico, o puedes hacer que Google Cloud asigne un bloque IPv4 automáticamente. No puedes crear un rango interno de IPv6 con un bloque de direcciones asignado automáticamente.

Cuando solicitas un bloque CIDR IPv4 asignado automáticamente, proporcionas una longitud de prefijo y uno o más bloques CIDR IPv4 de destino opcionales. Si no especificas un bloque CIDR de destino, Google Cloud usa los siguientes rangos de destino predeterminados:

  • Para las redes de VPC en modo personalizado, los rangos predeterminados son 10.0.0.0/8, 172.16.0.0/12 y 192.168.0.0/16.
  • Para las redes de VPC en modo automático, los rangos predeterminados son 10.0.0.0/9, 172.16.0.0/12 y 192.168.0.0/16.

Google Cloud tiene en cuenta las asignaciones de direcciones IP existentes y asigna al rango interno un bloque CIDR libre del tamaño elegido dentro de los bloques CIDR de destino. Puedes definir mejor esta asignación proporcionando una lista opcional de bloques CIDR para excluir. Google Cloud asigna un bloque de direcciones IP al rango interno que no se superpone con ningún bloque excluido. La lista de bloques excluidos no se puede actualizar después de crear un rango interno.

Para controlar el método que usa Google Cloud para seleccionar de forma automática un bloque libre, puedes especificar una estrategia de asignación. Si no especificas una estrategia de asignación, Google Cloud asigna de forma aleatoria un rango de direcciones IP libre dentro de los bloques CIDR de destino (o el rango predeterminado, si no se especifican bloques CIDR de destino).

Los rangos internos de IPv6 te permiten evitar la asignación automática de direcciones IP a las subredes nuevas solo IPv6 o de pila doble. Los rangos internos de IPv6 deben tener el tipo de uso EXTERNAL_TO_VPC y el tipo de intercambio de tráfico FOR_SELF. Debes incluir un bloque CIDR IPv6 específico, y el campo overlaps debe estar vacío o no especificado.

Para evitar que los usuarios actualicen el bloque CIDR o la configuración de superposición de un rango interno, puedes crear un rango interno inmutable. Los rangos internos inmutables impiden que se realicen cambios en estas propiedades, pero puedes actualizar la descripción. La inmutabilidad no se puede modificar después de crear el rango interno.

De forma predeterminada, Google Cloud bloquea la creación de rangos o recursos internos si comparten direcciones IP superpuestas en la misma red de VPC. Puedes configurar un rango interno de IPv4 para permitir la superposición con los rangos de direcciones de subredes existentes, rutas nuevas y existentes, o ambas. No puedes crear recursos Google Cloud que usen direcciones IP de un rango interno existente, a menos que asocies de forma explícita el recurso con el rango interno (para subredes) o configures la superposición (para rutas).

Para ver ejemplos de casos de uso de rangos internos con diferentes combinaciones de propósito, intercambio de tráfico y uso, consulta Ejemplos de casos de uso.

Console

  1. En la consola de Google Cloud , ve a la página Intervalos internos.

    Ir a Rangos internos

  2. Haz clic en Reservar rango interno.

  3. Ingresa un nombre.

  4. Opcional: Ingresa una descripción.

  5. En Propósito, selecciona Subred de VPC o Direcciones internas.

  6. Selecciona una versión de IP:

    • Para un rango interno IPv4, haz lo siguiente:

      1. Especifica si el rango interno es inmutable.
      2. Selecciona un método de reserva.

        • Si seleccionas Automática, haz lo siguiente:

          1. Selecciona un algoritmo de asignación.
          2. Selecciona una longitud de prefijo.
          3. Ingresa un rango de direcciones IP de destino. Puedes agregar varios rangos de destino.
          4. Opcional: Haz clic en Agregar un rango para excluir y, luego, ingresa un rango de direcciones IP que quieras excluir. Puedes agregar varios rangos excluidos.

            Google Cloud asigna un bloque de direcciones IP al rango interno que no se superpone con ningún rango excluido. Esta lista no se puede actualizar después de crear el rango interno.

        • Si seleccionas Permitirme especificar, ingresa un rango de IP en notación CIDR.

      3. Selecciona una red.

      4. Selecciona un tipo de intercambio de tráfico.

        Si el rango interno tiene el propósito Direcciones internas, selecciona Para uso propio.

      5. Selecciona un tipo de uso.

      6. En la sección Superposiciones permitidas, especifica si el rango interno puede superponerse con subredes existentes, rutas nuevas y existentes, o ambas.

        Esta opción no está disponible si el rango interno tiene el propósito Direcciones internas.

    • Para un rango interno de IPv6, haz lo siguiente:

      1. Especifica si el rango interno es inmutable.
      2. Selecciona Permitirme especificar y, luego, ingresa un bloque CIDR IPv6 o IPv6 asignado a IPv4.
      3. Selecciona una red.
      4. En el campo Intercambio de tráfico, selecciona Para mí.
      5. En el campo Uso, selecciona Externo a la VPC.
  7. Haz clic en Reservar.

gcloud

Crea rangos internos con el comando gcloud network-connectivity internal-ranges create.

  • Para reservar un rango interno para un bloque CIDR IPv4 o IPv6 específico, usa el siguiente comando:

    gcloud network-connectivity internal-ranges create RANGE_NAME \
        --ip-cidr-range=CIDR_RANGE \
        --network=NETWORK_NAME \
        --description="DESCRIPTION" \
        --peering=PEERING_TYPE \
        --usage=USAGE_TYPE
    

    Reemplaza lo siguiente:

    • RANGE_NAME: el nombre del rango interno nuevo
    • CIDR_RANGE: Es el bloque CIDR IPv4, IPv6 o IPv6 asignado a IPv4 que se asignará al nuevo rango interno.
      • Si especificas un bloque IPv6, debes hacer lo siguiente:
        • Establece el tipo de peering en FOR_SELF.
        • Establece el tipo de usage en EXTERNAL_TO_VPC.
    • NETWORK_NAME: Es el nombre de la red en la que se creará el rango interno.
    • DESCRIPTION: Es una descripción opcional del rango interno.
    • PEERING_TYPE: el tipo de intercambio de tráfico del rango interno

      Las opciones son FOR_SELF, FOR_PEER y NOT_SHARED. FOR_SELF es la configuración predeterminada.

    • USAGE_TYPE: el tipo de uso del rango interno

      Las opciones son FOR_VPC, EXTERNAL_TO_VPC y FOR_MIGRATION. El valor predeterminado es FOR_VPC.

  • Para reservar un rango interno de IPv4 con un bloque CIDR asignado de forma automática, usa el siguiente comando:

    gcloud network-connectivity internal-ranges create RANGE_NAME \
        --network=NETWORK_NAME \
        --prefix-length=PREFIX_LENGTH \
        --target-cidr-range=TARGET_CIDR_RANGE \
        --peering=PEERING_TYPE \
        --usage=USAGE_TYPE \
        --description="DESCRIPTION" \
        --allocation-strategy=ALLOCATION_STRATEGY
        [--first-available-ranges-lookup-size=FIRST_N_LOOKUP_SIZE]
    

    Reemplaza lo siguiente:

    • PREFIX_LENGTH: Es la longitud del prefijo de las direcciones IP asignadas.
    • TARGET_CIDR_RANGE: el bloque CIDR de destino desde el que se asigna un bloque de direcciones IPv4

      • Para las redes de VPC en modo personalizado, los bloques CIDR predeterminados son 10.0.0.0/8, 172.16.0.0/12 y 192.168.0.0/16.
      • Para las redes de VPC en modo automático, los bloques CIDR predeterminados son 10.0.0.0/9, 172.16.0.0/12 y 192.168.0.0/16.

      Puedes ingresar varios bloques CIDR en una lista separada por comas.

    • ALLOCATION_STRATEGY: Es la estrategia de asignación que deseas usar para el bloque CIDR de este rango interno.

      Las opciones son RANDOM, FIRST_AVAILABLE, RANDOM_FIRST_N_AVAILABLE y FIRST_SMALLEST_FITTING. La configuración predeterminada es RANDOM.

    • FIRST_N_LOOKUP_SIZE: Para la estrategia de asignación RANDOM_FIRST_N_AVAILABLE, es la cantidad de bloques CIDR libres que se deben encontrar antes de determinar uno de forma aleatoria.

      Solo incluye esta marca si eliges la estrategia de asignación RANDOM_FIRST_N_AVAILABLE.

  • Si deseas excluir rangos de direcciones IP cuando reservas un rango interno de IPv4 con un bloque CIDR asignado automáticamente, usa el siguiente comando:

    gcloud alpha network-connectivity internal-ranges create RANGE_NAME \
        --network=NETWORK_NAME \
        --prefix-length=PREFIX_LENGTH \
        --target-cidr-range=TARGET_CIDR_RANGE \
        --peering=PEERING_TYPE \
        --usage=USAGE_TYPE \
        --description="DESCRIPTION" \
        --exclude-cidr-ranges=EXCLUDED_RANGES
    

    Reemplaza EXCLUDED_RANGES por una lista separada por comas de uno o más bloques CIDR de IPv4 que se excluirán. Google Cloud asigna un bloque de direcciones IP al rango interno que no se superpone con ningún bloque excluido. La lista no se puede actualizar después de crear el rango interno.

  • Para reservar un rango interno IPv4 con superposición, usa el siguiente comando:

    gcloud network-connectivity internal-ranges create RANGE_NAME \
        --ip-cidr-range=CIDR_RANGE \
        --network=NETWORK_NAME \
        --description="DESCRIPTION" \
        --peering=PEERING_TYPE \
        --usage=USAGE_TYPE \
        --overlaps=OVERLAPS
    

    Reemplaza OVERLAPS por el tipo de superposición que se permitirá. Las opciones son OVERLAP_EXISTING_SUBNET_RANGE y OVERLAP_ROUTE_RANGE. Puedes incluir ambos valores en una lista separada por comas.

  • Para reservar un rango interno inmutable, usa el siguiente comando:

    gcloud network-connectivity internal-ranges create RANGE_NAME \
        --ip-cidr-range=CIDR_RANGE \
        --network=NETWORK_NAME \
        --description="DESCRIPTION" \
        --peering=PEERING_TYPE \
        --usage=USAGE_TYPE \
        --immutable
    
  • Si deseas reservar un rango interno para usarlo con los extremos de Private Service Connect para las APIs de Google, usa el siguiente comando. No puedes usar la marca --overlaps con el propósito INTERNAL_ADDRESS.

    Cuando elijas el rango, ten en cuenta los requisitos de dirección IP para los extremos de Private Service Connect que se orientan a las APIs de Google.

    gcloud network-connectivity internal-ranges create RANGE_NAME \
        --ip-cidr-range=CIDR_RANGE \
        --network=NETWORK_NAME \
        --description="DESCRIPTION" \
        --peering=FOR_SELF \
        --usage=FOR_VPC \
        --purpose=INTERNAL_ADDRESS
    

API

  • Para reservar un rango interno para un bloque CIDR IPv4 o IPv6 específico, realiza una solicitud POST al método projects.locations.internalRanges.create.

    POST https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges?internalRangeId=RANGE_NAME
    {
      "ipCidrRange": "CIDR_RANGE",
      "network": "NETWORK_NAME",
      "description": "DESCRIPTION",
      "peering": "PEERING_TYPE",
      "usage": "USAGE_TYPE"
    }
    

    Reemplaza lo siguiente:

    • PROJECT_ID: el ID del proyecto superior para el rango interno
    • RANGE_NAME: el nombre del rango interno
    • CIDR_RANGE: Es el bloque CIDR IPv4, IPv6 o IPv6 asignado a IPv4 que se asignará al rango interno.
      • Si especificas un bloque IPv6, debes hacer lo siguiente:
        • Establece el tipo de peering en FOR_SELF.
        • Establece el tipo de usage en EXTERNAL_TO_VPC.
    • NETWORK_NAME: Es el nombre de la red en la que se creará el rango interno.
    • DESCRIPTION: Es una descripción opcional del rango interno nuevo.
    • PEERING_TYPE: el tipo de intercambio de tráfico del rango interno

      Las opciones son FOR_SELF, FOR_PEER y NOT_SHARED. FOR_SELF es la configuración predeterminada.

    • USAGE_TYPE: el tipo de uso del rango interno

      Las opciones son FOR_VPC, EXTERNAL_TO_VPC y FOR_MIGRATION. El valor predeterminado es FOR_VPC.

  • Para reservar un rango interno de IPv4 con un bloque CIDR asignado automáticamente, realiza la siguiente solicitud:

    POST https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges?internalRangeId=RANGE_NAME
    {
      "prefixLength": PREFIX_LENGTH,
      "targetCidrRange": "TARGET_CIDR_RANGE",
      "network": "NETWORK_NAME",
      "description": "DESCRIPTION",
      "peering": "PEERING_TYPE",
      "usage": "USAGE_TYPE",
      "allocationOptions": {
        "allocationStrategy": "ALLOCATION_STRATEGY",
        ["firstAvailableRangesLookupSize": FIRST_N_LOOKUP_SIZE]
      }
    }
    

    Reemplaza lo siguiente:

    • PREFIX_LENGTH: la longitud del prefijo CIDR para el bloque de direcciones IP del rango
    • TARGET_CIDR_RANGE: el bloque CIDR de destino desde el que se asigna un bloque de direcciones IPv4

      • Para las redes de VPC en modo personalizado, los bloques CIDR predeterminados son 10.0.0.0/8, 172.16.0.0/12 y 192.168.0.0/16.
      • Para las redes de VPC en modo automático, los bloques CIDR predeterminados son 10.0.0.0/9, 172.16.0.0/12 y 192.168.0.0/16.

      Puedes especificar varios bloques CIDR en un array de JSON.

    • ALLOCATION_STRATEGY: Es la estrategia de asignación que deseas usar para el bloque CIDR de este rango interno.

      Las opciones son RANDOM, FIRST_AVAILABLE, RANDOM_FIRST_N_AVAILABLE y FIRST_SMALLEST_FITTING. La configuración predeterminada es RANDOM.

    • FIRST_N_LOOKUP_SIZE: Para la estrategia de asignación RANDOM_FIRST_N_AVAILABLE, es la cantidad de bloques CIDR libres que se deben encontrar antes de determinar uno de forma aleatoria.

      Incluye este campo solo si eliges la estrategia de asignación RANDOM_FIRST_N_AVAILABLE.

  • Si deseas excluir rangos de direcciones IP cuando reservas un rango interno de IPv4 con un bloque CIDR asignado automáticamente, realiza la siguiente solicitud:

    POST https://networkconnectivity./v1alpha1/projects/PROJECT_ID/locations/global/internalRanges?internalRangeId=RANGE_NAME
    {
      "prefixLength": PREFIX_LENGTH,
      "targetCidrRange": "TARGET_CIDR_RANGE",
      "network": "NETWORK_NAME",
      "description": "DESCRIPTION",
      "peering": "PEERING_TYPE",
      "usage": "USAGE_TYPE",
      "excludeCidrRanges": ["EXCLUDED_RANGE_1","EXCLUDED_RANGE_2"]
    }
    

    Reemplaza EXCLUDED_RANGE_1 y EXCLUDED_RANGE_2 por uno o más bloques CIDR de IPv4 para excluir. Google Cloud asigna un bloque de direcciones IP al rango interno que no se superpone con ningún bloque excluido. La lista no se puede actualizar después de crear el rango interno.

  • Para reservar un rango interno de IPv4 con superposición, realiza la siguiente solicitud:

    POST https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges?internalRangeId=RANGE_NAME
    {
      "ipCidrRange": "CIDR_RANGE",
      "network": "NETWORK_NAME",
      "description": "DESCRIPTION",
      "peering": "PEERING_TYPE",
      "usage": "USAGE_TYPE",
      "overlaps": ["OVERLAPS"]
    }
    

    Reemplaza OVERLAPS por el tipo de superposición que se permitirá. Las opciones son OVERLAP_EXISTING_SUBNET_RANGE y OVERLAP_ROUTE_RANGE. Puedes incluir ambos valores en un array JSON.

  • Para reservar un rango interno inmutable, realiza la siguiente solicitud:

    POST https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges?internalRangeId=RANGE_NAME
    {
      "ipCidrRange": "CIDR_RANGE",
      "network": "NETWORK_NAME",
      "description": "DESCRIPTION",
      "peering": "PEERING_TYPE",
      "usage": "USAGE_TYPE",
      "immutable": true
    }
    
  • Para reservar un rango interno que se usará con los extremos de Private Service Connect para las APIs de Google, realiza la siguiente solicitud. No puedes usar el campo overlaps con el propósito INTERNAL_ADDRESS.

    Cuando elijas el rango, ten en cuenta los requisitos de dirección IP para los extremos de Private Service Connect que se orientan a las APIs de Google.

    POST https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges?internalRangeId=RANGE_NAME
    {
      "ipCidrRange": "CIDR_RANGE",
      "network": "NETWORK_NAME",
      "description": "DESCRIPTION",
      "peering": "FOR_SELF",
      "usage": "FOR_VPC",
      "purpose": "INTERNAL_ADDRESS"
    }
    

Reserva rangos internos IPv4 para la migración de subredes

Puedes usar un rango interno para migrar un rango CIDR de una subred a otra. Para obtener más información, consulta Migra rangos de subredes IPv4.

gcloud

Usa el comando gcloud network-connectivity internal-ranges create.

gcloud network-connectivity internal-ranges create RANGE_NAME \
    --ip-cidr-range=CIDR_RANGE \
    --network=NETWORK_NAME \
    --peering=FOR_SELF \
    --usage=FOR_MIGRATION \
    --migration-source=SOURCE_SUBNET \
    --migration-target=TARGET_SUBNET

Reemplaza lo siguiente:

  • RANGE_NAME: el nombre del rango interno que se creará
  • CIDR_RANGE: Es el bloque CIDR IPv4 de la subred que deseas migrar.
  • NETWORK_NAME: Es el nombre de la red en la que se creará el rango interno.
  • SOURCE_SUBNET: el URI de la subred de origen
  • TARGET_SUBNET: Es el URI de la subred de destino.

API

Realiza una solicitud POST al método projects.locations.internalRanges.create.

POST https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges?internalRangeId=RANGE_NAME
{
  "ipCidrRange": "CIDR_RANGE",
  "network": "NETWORK_NAME",
  "peering": "FOR_SELF",
  "usage": "FOR_MIGRATION",
  "migration": {
    "source": "SOURCE_SUBNET",
    "target": "TARGET_SUBNET"
  }
}

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto superior para el rango interno
  • RANGE_NAME: el nombre del rango interno nuevo
  • CIDR_RANGE: Es el bloque CIDR IPv4 de la subred que deseas migrar.
  • NETWORK_NAME: Es el nombre de la red en la que se creará el rango interno.
  • SOURCE_SUBNET: el URI de la subred de origen
  • TARGET_SUBNET: Es el URI de la subred de destino.

Crea subredes con rangos internos de IPv4

Puedes crear una subred solo IPv4 o de pila doble y usar un rango interno para especificar el rango de direcciones IPv4 internas principal de la subred. La subred se puede asociar con un rango interno completo o solo con una parte del rango. Los rangos secundarios de las subredes también se pueden asociar con rangos internos.

Console

  1. Reserva un rango interno de IPv4 en la red en la que quieres crear una subred nueva. Establece el tipo de propósito en este rango interno en Subred de VPC, el tipo de intercambio de tráfico en Para uno mismo y el tipo de uso en Para VPC.

  2. En la consola de Google Cloud , ve a la página Redes de VPC.

    Ir a las redes de VPC

  3. Haz clic en el nombre de una red de VPC para ver la página Detalles de la red de VPC.

  4. Haz clic en Agregar subred. En el diálogo que aparece, haz lo siguiente:

    1. Proporciona un nombre.
    2. Selecciona una región.
    3. Selecciona la casilla de verificación Asociar con un rango interno.
    4. En Rango interno reservado, selecciona una opción.
    5. Opcional: Para asociar la subred con parte del rango interno, ingresa un rango IPv4.
    6. Haz clic en Agregar.

gcloud

  1. Reserva un rango interno de IPv4 en la red en la que quieres crear una subred nueva. Establece el tipo de propósito en VPC_SUBNET, el tipo de intercambio de tráfico en FOR_SELF y el tipo de uso en FOR_VPC.
  2. Realiza una de las siguientes acciones:

    • Para crear una subred asociada con un rango interno completo, usa el comando gcloud compute networks subnets create.

      gcloud compute networks subnets create SUBNET_NAME \
          --reserved-internal-range=networkconnectivity.googleapis.com/projects/PROJECT_ID/locations/global/internalRanges/RANGE_NAME \
          --network=NETWORK_NAME \
          --region=REGION
      

      Reemplaza lo siguiente:

      • SUBNET_NAME: El nombre de la subred
      • PROJECT_ID: el ID del proyecto en el que se creará la subred
      • RANGE_NAME: el nombre del rango interno que se asociará a la subred
      • NETWORK_NAME: Es el nombre de la red en la que se creará la subred.
      • REGION: la región en la que se creará la subred
    • Para crear una subred asociada con parte de un rango interno, usa el siguiente comando:

      gcloud compute networks subnets create SUBNET_NAME \
          --reserved-internal-range=networkconnectivity.googleapis.com/projects/PROJECT_ID/locations/global/internalRanges/RANGE_NAME \
          --range=IP_RANGE \
          --network=NETWORK_NAME \
          --region=REGION
      

      Reemplaza IP_RANGE por un rango CIDR IPv4 que sea un subconjunto del rango interno.

Por ejemplo, los siguientes comandos crean una subred asociada solo con la parte 10.9.1.0/24 de un rango interno que reserva el bloque CIDR 10.9.0.0/16.

gcloud network-connectivity internal-ranges create reserved-range-one \
    --ip-cidr-range=10.9.0.0/16 \
    --network=vpc-one
gcloud compute networks subnets create subnet-one \
    --reserved-internal-range=networkconnectivity.googleapis.com/projects/project-one/locations/global/internalRanges/reserved-range-one \
    --range=10.9.1.0/24 \
    --network=vpc-one \
    --region=us-central1

API

  1. Reserva un rango interno de IPv4 en la red en la que quieres crear una subred nueva. Establece el tipo de propósito en VPC_SUBNET, el tipo de intercambio de tráfico en FOR_SELF y el tipo de uso en FOR_VPC.
  2. Realiza una de las siguientes acciones:

    • Para crear una subred asociada con un rango interno completo, realiza una solicitud POST al método subnetworks.insert.

      POST https://compute./compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks
      {
        "name" : "SUBNET_NAME",
        "reservedInternalRange" : "networkconnectivity.googleapis.com/projects/PROJECT_ID/locations/global/internalRanges/RANGE_NAME",
        "network" : "NETWORK"
      }
      

      Reemplaza lo siguiente:

      • PROJECT_ID: el ID del proyecto superior de la subred nueva
      • REGION: la región en la que se creará la subred
      • SUBNET_NAME: Es el nombre de la subred nueva.
      • PROJECT_ID: el ID del proyecto en el que se creará la subred
      • RANGE_NAME: el nombre del rango interno que se usará para la subred nueva
      • NETWORK: Es el nombre de la red en la que se creará la subred.
    • Para crear una subred que esté asociada con parte de un rango interno, realiza la siguiente solicitud:

      POST https://compute./compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks
      {
        "name" : "SUBNET_NAME",
        "reservedInternalRange" : "networkconnectivity.googleapis.com/projects/PROJECT_ID/locations/global/internalRanges/RANGE_NAME",
        "range" : "IP_RANGE",
        "network" : "NETWORK"
      }
      

      Reemplaza IP_RANGE por un rango CIDR IPv4 que sea un subconjunto del rango interno.

Por ejemplo, las siguientes solicitudes crean una subred que está asociada solo con la parte 10.9.1.0/24 de un rango interno que contiene el bloque CIDR 10.9.0.0/16.

POST https://networkconnectivity./v1/projects/sample-project/locations/global/internalRanges?internalRangeId=reserved-for-subnet
{
  "targetCidrRange": "10.9.0.0/16",
  "network": "network-b"
}
POST https://compute./compute/v1/projects/11223344/regions/us-central1/subnetworks
{
  "name" : "subnet-with-partial-range",
  "reservedInternalRange" : "networkconnectivity.googleapis.com/projects/project-one/locations/global/internalRanges/reserved-for-subnet",
  "range" : "10.9.1.0/24",
  "network" : "network-b"
}

Reserva direcciones IP internas globales para los extremos de Private Service Connect

Puedes reservar direcciones IPv4 internas globales para los extremos de Private Service Connect para las APIs de Google globales desde un rango interno.

Console

  1. Reserva un rango interno de IPv4 en la red de VPC en la que deseas reservar la dirección IP interna global. Establece el tipo de propósito en Direcciones internas, el tipo de intercambio de tráfico en Para uno mismo y el tipo de uso en Para VPC.
  2. Crea un extremo de Private Service Connect para las APIs de Google globales, reserva una dirección IP interna global de una colección de IPs que represente el rango interno.

gcloud

  1. Reserva un rango interno de IPv4 en la red de VPC en la que deseas reservar la dirección IP interna global. Establece el tipo de propósito en INTERNAL_ADDRESS, el tipo de intercambio de tráfico en FOR_SELF y el tipo de uso en FOR_VPC.

  2. Reserva una dirección IPv4 del rango interno con el comando gcloud compute addresses create.

    El siguiente comando asigna automáticamente una dirección IP del rango interno. Para elegir una dirección IP específica, usa la marca --addresses para especificar una dirección IP dentro del rango interno.

    gcloud compute addresses create ADDRESS_NAME \
        --global \
        --network=NETWORK_NAME \
        --purpose=PRIVATE_SERVICE_CONNECT \
        --internal-range=https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges/RANGE_NAME
    

    Reemplaza lo siguiente:

    • ADDRESS_NAME: un nombre para la dirección IP.

    • NETWORK_NAME: Es el nombre de la red de VPC en la que se creará la dirección IP.

    • PROJECT_ID: el ID del proyecto que contiene el rango interno.

    • RANGE_NAME: el nombre del rango interno desde el que se asignará la dirección IP.

API

  1. Reserva un rango interno de IPv4 en la red de VPC en la que deseas reservar la dirección IP interna global. Establece el tipo de propósito en INTERNAL_ADDRESS, el tipo de intercambio de tráfico en FOR_SELF y el tipo de uso en FOR_VPC.

  2. Reserva una dirección IPv4 del rango interno con el método globalAddresses.insert.

    En el siguiente ejemplo, se asigna automáticamente una dirección IP del rango interno. Para elegir una dirección IP específica, usa el campo address para especificar una dirección IP dentro del rango interno.

    POST https://compute./compute/v1/projects/PROJECT_ID/global/addresses
    {
      "name": "ADDRESS_NAME",
      "addressType": "INTERNAL",
      "purpose": "PRIVATE_SERVICE_CONNECT",
      "ipCollection": "https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges/RANGE_NAME",
      "network": "projects/PROJECT_ID/global/networks/NETWORK_NAME"
    }
    

    Reemplaza lo siguiente:

    • PROJECT_ID: el ID del proyecto

    • ADDRESS_NAME: un nombre para la dirección IP.

    • RANGE_NAME: el nombre del rango interno desde el que se asignará la dirección IP.

    • NETWORK_NAME: Es el nombre de la red de VPC en la que se creará la dirección IP.

Crea clústeres de GKE con rangos internos de IPv4

Puedes usar rangos internos de IPv4 para asignar direcciones IP para los clústeres nativos de la VPC de Google Kubernetes Engine (GKE).

gcloud

  1. Crea los siguientes rangos internos de IPv4 con el comando gcloud network-connectivity internal-ranges create.

    gcloud network-connectivity internal-ranges create gke-nodes-1 \
        --prefix-length=NODE_PREFIX_LENGTH \
        --network=NETWORK
    
    gcloud network-connectivity internal-ranges create gke-pods-1 \
        --prefix-length=POD_PREFIX_LENGTH \
        --network=NETWORK
    
    gcloud network-connectivity internal-ranges create gke-services-1 \
        --prefix-length=SERVICE_PREFIX_LENGTH \
        --network=NETWORK
    

    Reemplaza lo siguiente:

    • NODE_PREFIX_LENGTH: Es la longitud del prefijo del rango interno asociado con los nodos de GKE.
    • POD_PREFIX_LENGTH: Es la longitud del prefijo del rango interno asociado con los Pods de GKE.
    • SERVICE_PREFIX_LENGTH: Es la longitud del prefijo del rango interno asociado con los servicios de GKE.
    • NETWORK: El nombre de la red
  2. Crea una subred con los rangos internos que creaste en el paso anterior con el comando gcloud compute networks subnets create.

    gcloud compute networks subnets create gke-subnet-1 \
        --network=NETWORK \
        --region=REGION \
        --reserved-internal-range="//networkconnectivity.googleapis.com/projects/PROJECT_ID/locations/global/internalRanges/gke-nodes-1" \
        --secondary-range-with-reserved-internal-range="pods=//networkconnectivity.googleapis.com/projects/PROJECT_ID/locations/global/internalRanges/gke-pods-1,services=//networkconnectivity.googleapis.com/projects/PROJECT_ID/locations/global/internalRanges/gke-services-1"
    

    Reemplaza lo siguiente:

    • REGION: Es la región de la subred.
    • PROJECT_ID: el ID del proyecto
  3. Crea el clúster nativo de la VPC con el comando gcloud container clusters create.

    gcloud container clusters create CLUSTER_NAME \
        --network=NETWORK \
        --subnetwork=gke-subnet-1 \
        --zone=ZONE \
        --cluster-secondary-range-name=pods \
        --services-secondary-range-name=services \
        --enable-ip-alias
    

    Reemplaza ZONE por la zona del clúster.

API

  1. Para crear los siguientes rangos internos, realiza solicitudes POST al método projects.locations.internalRanges.create.

    POST https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges?internalRangeId=gke-nodes-1
    {
      "network": "NETWORK",
      "prefixLength": NODE_PREFIX_LENGTH,
      "peering": "FOR_SELF",
      "usage": "FOR_VPC"
    }
    
    POST https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges?internalRangeId=gke-pods-1
    {
      "network": "NETWORK",
      "prefixLength": POD_PREFIX_LENGTH,
      "peering": "FOR_SELF",
      "usage": "FOR_VPC"
    }
    
    POST https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges?internalRangeId=gke-services-1
    {
      "network": "NETWORK",
      "prefixLength": SERVICE_PREFIX_LENGTH,
      "peering": "FOR_SELF",
      "usage": "FOR_VPC"
    }
    

    Reemplaza lo siguiente:

    • PROJECT_ID: el ID del proyecto
    • NETWORK: El nombre de la red
    • NODE_PREFIX_LENGTH: Es la longitud del prefijo del rango interno asociado con los nodos de GKE.
    • POD_PREFIX_LENGTH: Es la longitud del prefijo del rango interno asociado con los Pods de GKE.
    • SERVICE_PREFIX_LENGTH: Es la longitud del prefijo del rango interno asociado con los servicios de GKE.
  2. Crea una subred con los rangos internos que creaste en el paso anterior mediante una solicitud POST al método subnetworks.insert.

    POST https://compute./compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks
    {
      "name": "gke-subnet-1",
      "network": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK",
      "privateIpGoogleAccess": false,
      "reservedInternalRange": "//networkconnectivity.googleapis.com/projects/PROJECT_ID/locations/global/internalRanges/gke-nodes-1",
      "secondaryIpRanges": [
        {
          "rangeName": "pods",
          "reservedInternalRange": "//networkconnectivity.googleapis.com/projects/PROJECT_ID/locations/global/internalRanges/gke-pods-1"
        },
        {
          "rangeName": "services",
          "reservedInternalRange": "//networkconnectivity.googleapis.com/projects/PROJECT_ID/locations/global/internalRanges/gke-services-1"
        }
      ]
    }
    

    Reemplaza lo siguiente:

    • PROJECT_ID: el ID del proyecto
    • REGION: Es la región de la subred.
    • NETWORK: Es la red de la subred.
  3. Para crear el clúster nativo de la VPC, realiza una solicitud POST al método clusters.create.

    POST https://container./v1/projects/PROJECT_ID/locations/ZONE/clusters
    {
      "cluster": {
        "ipAllocationPolicy": {
          "clusterSecondaryRangeName": "pods",
          "createSubnetwork": false,
          "servicesSecondaryRangeName": "services",
          "useIpAliases": true
        },
        "name": "CLUSTER_NAME",
        "network": "NETWORK",
        "nodePools": [
          {
            "config": {
              "oauthScopes": [
                "https://www.googleapis.com/auth/devstorage.read_only",
                "https://www.googleapis.com/auth/logging.write",
                "https://www.googleapis.com/auth/monitoring",
                "https://www.googleapis.com/auth/service.management.readonly",
                "https://www.googleapis.com/auth/servicecontrol",
                "https://www.googleapis.com/auth/trace.append"
              ]
            },
            "initialNodeCount": 3,
            "management": {
              "autoRepair": true,
              "autoUpgrade": true
            },
            "name": "default-pool",
            "upgradeSettings": {
              "maxSurge": 1
            }
          }
        ],
        "subnetwork": "gke-subnet-1"
      },
      "parent": "projects/PROJECT_ID/locations/ZONE"
    }
    

    Reemplaza lo siguiente:

    • PROJECT_ID: el ID del proyecto
    • ZONE: Es la zona del clúster.
    • CLUSTER_NAME: el nombre del clúster nuevo.
    • NETWORK: Es la red del clúster.

Cómo enumerar rangos internos

Puedes enumerar los rangos internos para ver todos los rangos internos de tu proyecto actual o una red de VPC específica. Para mostrar una lista de proyectos en una red de VPC, usa Google Cloud CLI o envía una solicitud a la API.

Console

gcloud

  • Para ver todos los rangos internos de tu proyecto actual, usa el comando gcloud network-connectivity internal-ranges list.

    gcloud network-connectivity internal-ranges list
    
  • Para ver todos los rangos internos de una red de VPC, usa el comando internal-ranges list y, luego, incluye un filtro.

    gcloud network-connectivity internal-ranges list \
        --filter=network:NETWORK_NAME \
        --project=PROJECT_ID
    

    Reemplaza lo siguiente:

    • NETWORK_NAME: Es el nombre de la red de VPC en la que se enumerarán los rangos internos.
    • PROJECT_ID: Es el ID del proyecto que contiene la red de VPC.

API

  • Para ver todos los rangos internos de un proyecto, realiza una solicitud GET al método projects.locations.internalRanges.list.

    GET https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges
    

    Reemplaza PROJECT_ID por el ID del proyecto en el que deseas ver los rangos internos.

  • Para ver todos los rangos internos en una red de VPC, realiza una solicitud GET al método projects.locations.internalRanges.list y, luego, incluye un filtro.

    GET https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges?filter=network=\"https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME\"
    

    Reemplaza NETWORK_NAME por el nombre de la red de VPC en la que se enumerarán los rangos internos.

Describe rangos internos

Puedes describir un rango interno para obtener detalles sobre el rango elegido, incluidas las subredes asociadas con el rango interno.

Console

  1. En la consola de Google Cloud , ve a la página Intervalos internos.

    Ir a Rangos internos

  2. Haz clic en el Nombre del rango interno que deseas describir.

gcloud

Usa el comando gcloud network-connectivity internal-ranges describe.

gcloud network-connectivity internal-ranges describe RANGE_NAME

Reemplaza RANGE_NAME por el nombre del rango interno que deseas describir.

API

Realiza una solicitud GET al método projects.locations.internalRanges.get.

GET https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges/RANGE_NAME

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto superior para el rango interno
  • RANGE_NAME: Es el nombre del rango interno que se describirá.

Actualiza rangos internos

Si un rango interno es inmutable, solo puedes actualizar la descripción. Si un rango interno es mutable, puedes expandir el bloque CIDR del rango y actualizar su propiedad de superposición y su descripción.

Para expandir un rango interno, puedes actualizar el bloque CIDR del rango o disminuir su longitud de prefijo, y el bloque CIDR actualizado debe contener el bloque anterior.

Si deseas reducir el rango asignado o modificar otro elemento, borra el rango interno y crea uno nuevo.

Para actualizar la propiedad de superposición de un rango interno de IPv4, envía una solicitud a la API o usa Google Cloud CLI.

Console

  1. En la consola de Google Cloud , ve a la página Intervalos internos.

    Ir a Rangos internos

  2. Haz clic en el nombre del rango interno que deseas actualizar.

  3. Para expandir el bloque CIDR del rango, haz clic en Expandir rango y, luego, realiza una de las siguientes acciones:

    • Para los rangos internos de IPv4, haz clic en Longitud del prefijo y, luego, haz lo siguiente:
      1. En el campo Longitud de prefijo, selecciona una longitud de prefijo que sea menor que la del prefijo anterior.
      2. Haz clic en Expandir.
    • Para los rangos internos IPv4 o IPv6, haz clic en Rango de IP y, luego, haz lo siguiente:
      1. Ingresa un bloque CIDR IPv4, IPv6 o IPv6 asignado a IPv4. El bloque nuevo debe contener el anterior.
      2. Haz clic en Expandir.
  4. Para actualizar la descripción del rango, haz lo siguiente:

    1. Haz clic en Editar descripción.
    2. Ingresa una descripción nueva.
    3. Haz clic en Guardar.

gcloud

  • Para actualizar un rango interno, usa el comando gcloud network-connectivity internal-ranges update. Omite las marcas de las propiedades que no quieras modificar.

    gcloud network-connectivity internal-ranges update RANGE_NAME \
        --ip-cidr-range=CIDR_RANGE \
        --overlaps=OVERLAPS \
        --description=DESCRIPTION
    

    Reemplaza lo siguiente:

    • RANGE_NAME: el nombre del rango interno
    • CIDR_RANGE: el bloque CIDR IPv4, IPv6 o IPv6 asignado a IPv4 expandido, que debe contener el bloque anterior
    • OVERLAPS: Es el tipo de superposición que se permitirá (solo rangos IPv4).

      Las opciones son OVERLAP_EXISTING_SUBNET_RANGE y OVERLAP_ROUTE_RANGE. Puedes incluir ambos valores en una lista separada por comas. Para inhabilitar la superposición, incluye la marca, pero no especifiques un valor (--overlaps=).

    • DESCRIPTION: la descripción actualizada

  • Para expandir un rango interno disminuyendo la longitud de prefijo, usa el siguiente comando:

    gcloud network-connectivity internal-ranges update RANGE_NAME \
        --prefix-length=PREFIX_LENGTH
    

    Reemplaza PREFIX_LENGTH por la longitud de prefijo actualizada, que debe ser menor que la longitud de prefijo anterior.

API

  • Para expandir un rango interno actualizando su rango CIDR, realiza una solicitud PATCH al método projects.locations.internalRanges.patch.

    PATCH https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges/RANGE_NAME?updateMask=ipCidrRange
    {
      "ipCidrRange": "CIDR_RANGE"
    }
    

    Reemplaza lo siguiente:

    • PROJECT_ID: el ID del proyecto superior para el rango interno
    • RANGE_NAME: el nombre del rango interno
    • CIDR_RANGE: el bloque CIDR IPv4, IPv6 o IPv6 asignado a IPv4 expandido, que debe contener el bloque anterior
  • Para expandir un rango interno disminuyendo la longitud de su prefijo, realiza la siguiente solicitud:

    PATCH https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges/RANGE_NAME?updateMask=prefixLength
    {
      "prefixLength": PREFIX_LENGTH
    }
    

    Reemplaza PREFIX_LENGTH por la longitud de prefijo actualizada, que debe ser menor que la longitud de prefijo anterior.

  • Para actualizar la propiedad de superposición de un rango interno de IPv4, realiza la siguiente solicitud:

    PATCH https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges/RANGE_NAME?updateMask=overlaps
    {
      "overlaps": ["OVERLAPS"]
    }
    

    Reemplaza OVERLAPS por el tipo de superposición que se permitirá. Las opciones son OVERLAP_EXISTING_SUBNET_RANGE y OVERLAP_ROUTE_RANGE. Puedes incluir ambos valores en un array JSON. Para inhabilitar la superposición, incluye el campo, pero no especifiques un valor ("overlaps": []).

  • Para actualizar la descripción de un rango interno, realiza la siguiente solicitud:

    PATCH https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges/RANGE_NAME?updateMask=description
    {
      "description": "DESCRIPTION"
    }
    

    Reemplaza DESCRIPTION por la descripción actualizada.

Borrar rangos internos

Puedes borrar un rango interno si no está asociado con un recurso de Google Cloud, como una subred. Para borrar un rango interno asociado con un recurso de Google Cloud , primero borra el recurso asociado.

Console

  1. En la consola de Google Cloud , ve a la página Intervalos internos.

    Ir a Rangos internos

  2. Haz clic en el nombre del rango interno que deseas borrar.

  3. Haz clic en Borrar.

  4. Para confirmar la acción, haz clic en Borrar.

gcloud

Usa el comando gcloud network-connectivity internal-ranges delete.

gcloud network-connectivity internal-ranges delete RANGE_TO_DELETE

Reemplaza RANGE_TO_DELETE por el nombre del rango interno que deseas borrar.

API

Realiza una solicitud DELETE al método projects.locations.internalRanges.delete.

DELETE https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges/RANGE_NAME

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto superior para el rango interno
  • RANGE_NAME: el nombre del rango interno