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
- Para usar los ejemplos de la línea de comandos de esta guía, instala o actualiza a la versión más reciente de Google Cloud CLI.
- Debes habilitar la API de Network Connectivity en tu proyecto.
- Identifica o crea una red de VPC.
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/12y192.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/12y192.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
En la consola de Google Cloud , ve a la página Intervalos internos.
Haz clic en Reservar rango interno.
Ingresa un nombre.
Opcional: Ingresa una descripción.
En Propósito, selecciona Subred de VPC o Direcciones internas.
Selecciona una versión de IP:
Para un rango interno IPv4, haz lo siguiente:
- Especifica si el rango interno es inmutable.
Selecciona un método de reserva.
Si seleccionas Automática, haz lo siguiente:
- Selecciona un algoritmo de asignación.
- Selecciona una longitud de prefijo.
- Ingresa un rango de direcciones IP de destino. Puedes agregar varios rangos de destino.
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.
Selecciona una red.
Selecciona un tipo de intercambio de tráfico.
Si el rango interno tiene el propósito Direcciones internas, selecciona Para uso propio.
Selecciona un tipo de uso.
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:
- Especifica si el rango interno es inmutable.
- Selecciona Permitirme especificar y, luego, ingresa un bloque CIDR IPv6 o IPv6 asignado a IPv4.
- Selecciona una red.
- En el campo Intercambio de tráfico, selecciona Para mí.
- En el campo Uso, selecciona Externo a la VPC.
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_TYPEReemplaza lo siguiente:
RANGE_NAME: el nombre del rango interno nuevoCIDR_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
peeringenFOR_SELF. - Establece el tipo de
usageenEXTERNAL_TO_VPC.
- Establece el tipo de
- Si especificas un bloque IPv6, debes hacer lo siguiente:
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 internoLas opciones son
FOR_SELF,FOR_PEERyNOT_SHARED.FOR_SELFes la configuración predeterminada.USAGE_TYPE: el tipo de uso del rango internoLas opciones son
FOR_VPC,EXTERNAL_TO_VPCyFOR_MIGRATION. El valor predeterminado esFOR_VPC.- Si usas la opción
FOR_MIGRATION, también debes especificar las subredes de origen y de destino. Para ver un ejemplo, consulta Reserva rangos internos de IPv4 para la migración de subredes.
- Si usas la opción
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/12y192.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/12y192.168.0.0/16.
Puedes ingresar varios bloques CIDR en una lista separada por comas.
- Para las redes de VPC en modo personalizado, los bloques CIDR
predeterminados son
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_AVAILABLEyFIRST_SMALLEST_FITTING. La configuración predeterminada esRANDOM.FIRST_N_LOOKUP_SIZE: Para la estrategia de asignaciónRANDOM_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_RANGESReemplaza
EXCLUDED_RANGESpor 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=OVERLAPSReemplaza
OVERLAPSpor el tipo de superposición que se permitirá. Las opciones sonOVERLAP_EXISTING_SUBNET_RANGEyOVERLAP_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 \ --immutableSi 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
--overlapscon el propósitoINTERNAL_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
POSTal métodoprojects.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 internoRANGE_NAME: el nombre del rango internoCIDR_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
peeringenFOR_SELF. - Establece el tipo de
usageenEXTERNAL_TO_VPC.
- Establece el tipo de
- Si especificas un bloque IPv6, debes hacer lo siguiente:
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 internoLas opciones son
FOR_SELF,FOR_PEERyNOT_SHARED.FOR_SELFes la configuración predeterminada.USAGE_TYPE: el tipo de uso del rango internoLas opciones son
FOR_VPC,EXTERNAL_TO_VPCyFOR_MIGRATION. El valor predeterminado esFOR_VPC.- Si usas la opción
FOR_MIGRATION, también debes especificar las subredes de origen y de destino. Para ver un ejemplo, consulta Reserva rangos internos de IPv4 para la migración de subredes.
- Si usas la opción
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 rangoTARGET_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/12y192.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/12y192.168.0.0/16.
Puedes especificar varios bloques CIDR en un array de JSON.
- Para las redes de VPC en modo personalizado, los bloques CIDR
predeterminados son
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_AVAILABLEyFIRST_SMALLEST_FITTING. La configuración predeterminada esRANDOM.FIRST_N_LOOKUP_SIZE: Para la estrategia de asignaciónRANDOM_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_1yEXCLUDED_RANGE_2por 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
OVERLAPSpor el tipo de superposición que se permitirá. Las opciones sonOVERLAP_EXISTING_SUBNET_RANGEyOVERLAP_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
overlapscon el propósitoINTERNAL_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 origenTARGET_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 internoRANGE_NAME: el nombre del rango interno nuevoCIDR_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 origenTARGET_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
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.
En la consola de Google Cloud , ve a la página Redes de VPC.
Haz clic en el nombre de una red de VPC para ver la página Detalles de la red de VPC.
Haz clic en Agregar subred. En el diálogo que aparece, haz lo siguiente:
- Proporciona un nombre.
- Selecciona una región.
- Selecciona la casilla de verificación Asociar con un rango interno.
- En Rango interno reservado, selecciona una opción.
- Opcional: Para asociar la subred con parte del rango interno, ingresa un rango IPv4.
- Haz clic en Agregar.
gcloud
- 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 enFOR_SELFy el tipo de uso enFOR_VPC. 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=REGIONReemplaza lo siguiente:
SUBNET_NAME: El nombre de la subredPROJECT_ID: el ID del proyecto en el que se creará la subredRANGE_NAME: el nombre del rango interno que se asociará a la subredNETWORK_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=REGIONReemplaza
IP_RANGEpor 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
- 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 enFOR_SELFy el tipo de uso enFOR_VPC. Realiza una de las siguientes acciones:
Para crear una subred asociada con un rango interno completo, realiza una solicitud
POSTal métodosubnetworks.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 nuevaREGION: la región en la que se creará la subredSUBNET_NAME: Es el nombre de la subred nueva.PROJECT_ID: el ID del proyecto en el que se creará la subredRANGE_NAME: el nombre del rango interno que se usará para la subred nuevaNETWORK: 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_RANGEpor 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
- 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.
- 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
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 enFOR_SELFy el tipo de uso enFOR_VPC.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
--addressespara 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_NAMEReemplaza 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
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 enFOR_SELFy el tipo de uso enFOR_VPC.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
addresspara 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 proyectoADDRESS_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
Crea los siguientes rangos internos de IPv4 con el comando
gcloud network-connectivity internal-ranges create.- Para nodos de GKE:
gcloud network-connectivity internal-ranges create gke-nodes-1 \ --prefix-length=NODE_PREFIX_LENGTH \ --network=NETWORK- Para Pods de GKE:
gcloud network-connectivity internal-ranges create gke-pods-1 \ --prefix-length=POD_PREFIX_LENGTH \ --network=NETWORK- Para Services de GKE:
gcloud network-connectivity internal-ranges create gke-services-1 \ --prefix-length=SERVICE_PREFIX_LENGTH \ --network=NETWORKReemplaza 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
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
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-aliasReemplaza
ZONEpor la zona del clúster.
API
Para crear los siguientes rangos internos, realiza solicitudes
POSTal métodoprojects.locations.internalRanges.create.- Para nodos de GKE:
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" }- Para Pods de GKE:
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" }- Para Services de GKE:
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 proyectoNETWORK: El nombre de la redNODE_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.
Crea una subred con los rangos internos que creaste en el paso anterior mediante una solicitud
POSTal métodosubnetworks.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 proyectoREGION: Es la región de la subred.NETWORK: Es la red de la subred.
Para crear el clúster nativo de la VPC, realiza una solicitud
POSTal métodoclusters.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 proyectoZONE: 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
En la consola de Google Cloud , ve a la página Intervalos internos.
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 listy, luego, incluye un filtro.gcloud network-connectivity internal-ranges list \ --filter=network:NETWORK_NAME \ --project=PROJECT_IDReemplaza 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
GETal métodoprojects.locations.internalRanges.list.GET https://networkconnectivity./v1/projects/PROJECT_ID/locations/global/internalRanges
Reemplaza
PROJECT_IDpor 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
GETal métodoprojects.locations.internalRanges.listy, 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_NAMEpor 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
En la consola de Google Cloud , ve a la página Intervalos internos.
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 internoRANGE_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
En la consola de Google Cloud , ve a la página Intervalos internos.
Haz clic en el nombre del rango interno que deseas actualizar.
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:
- En el campo Longitud de prefijo, selecciona una longitud de prefijo que sea menor que la del prefijo anterior.
- Haz clic en Expandir.
- Para los rangos internos IPv4 o IPv6, haz clic en Rango de IP y, luego,
haz lo siguiente:
- Ingresa un bloque CIDR IPv4, IPv6 o IPv6 asignado a IPv4. El bloque nuevo debe contener el anterior.
- Haz clic en Expandir.
- Para los rangos internos de IPv4, haz clic en Longitud del prefijo y, luego, haz lo siguiente:
Para actualizar la descripción del rango, haz lo siguiente:
- Haz clic en Editar descripción.
- Ingresa una descripción nueva.
- 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=DESCRIPTIONReemplaza lo siguiente:
RANGE_NAME: el nombre del rango internoCIDR_RANGE: el bloque CIDR IPv4, IPv6 o IPv6 asignado a IPv4 expandido, que debe contener el bloque anteriorOVERLAPS: Es el tipo de superposición que se permitirá (solo rangos IPv4).Las opciones son
OVERLAP_EXISTING_SUBNET_RANGEyOVERLAP_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_LENGTHReemplaza
PREFIX_LENGTHpor 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
PATCHal métodoprojects.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 internoRANGE_NAME: el nombre del rango internoCIDR_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_LENGTHpor 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
OVERLAPSpor el tipo de superposición que se permitirá. Las opciones sonOVERLAP_EXISTING_SUBNET_RANGEyOVERLAP_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
DESCRIPTIONpor 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
En la consola de Google Cloud , ve a la página Intervalos internos.
Haz clic en el nombre del rango interno que deseas borrar.
Haz clic en Borrar.
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 internoRANGE_NAME: el nombre del rango interno