Crear y gestionar interfaces de Private Service Connect

En esta página se describe cómo pueden crear y gestionar interfaces de Private Service Connect los administradores de redes de productores. Las interfaces de Private Service Connect permiten que las redes de nube privada virtual (VPC) de los productores de servicios inicien conexiones con las redes de VPC de los consumidores.

Antes de empezar

Roles

Para obtener los permisos que necesitas para crear interfaces de Private Service Connect, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en tu proyecto:

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

El rol Administrador de instancias de Compute (v. 1) contiene el permiso compute.instances.pscInterfaceCreate, que es necesario para crear interfaces de Private Service Connect.

Crear VMs con interfaces de Private Service Connect

Para crear una conexión de interfaz de Private Service Connect, necesitas una instancia de máquina virtual (VM) que tenga al menos dos interfaces de red. La primera interfaz se conecta a una subred de productor. Las otras interfaces pueden ser interfaces de Private Service Connect que soliciten conexiones a vinculaciones de red en diferentes redes de VPC de consumidor.

Si se acepta una conexión, Google Cloud asigna a la interfaz de Private Service Connect una dirección IP interna de la subred especificada por el adjunto de red.

Cuando creas una VM con varias interfaces de Private Service Connect, cada interfaz de Private Service Connect debe conectarse a una vinculación de red diferente que esté en una red de VPC diferente.

Si creas una interfaz de Private Service Connect que hace referencia a un adjunto de red configurado para aceptar conexiones manualmente y el proyecto de la interfaz no está en la lista de aceptación del adjunto de red, se producirá un error al crear la VM de la interfaz de Private Service Connect. En este caso, colabora con la organización del consumidor para añadir tu proyecto a la lista de permitidos y, a continuación, crea una interfaz de Private Service Connect.

Cuando creas una interfaz de Private Service Connect, puedes asignarle de forma opcional uno o varios intervalos de IP de alias internos. Si tienes previsto asignar intervalos de IPs de alias, ponte en contacto con la organización de consumidor para determinar los intervalos de direcciones IP adecuados.

Para asignar un intervalo de IPs de alias, especifica la longitud del prefijo del intervalo en notación CIDR. Cuando asignas uno o varios intervalos de IPs de alias a una interfaz de Private Service Connect,Google Cloud asigna los intervalos de IPs de alias del intervalo de direcciones IP principal de la subred asociada al adjunto de red. La dirección IP principal de la interfaz de Private Service Connect se asigna desde fuera de cualquier intervalo de IPs de alias. Si no hay suficientes direcciones IP en la subred de la conexión de red para asignar la dirección IP principal y los intervalos de IP de alias, se producirá un error al crear la VM de la interfaz de Private Service Connect. Puedes encontrar las direcciones IP específicas que se asignan describiendo la máquina virtual de la interfaz.

Consola

Crea una instancia de VM

  1. En la Google Cloud consola, ve a la página Instancias de VM:

    Ir a instancias de VM

  2. Haz clic en Crear instancia.

  3. Escribe un nombre.

  4. Haz clic en Región y, a continuación, selecciona la región del archivo de red al que quieras conectarte.

  5. Selecciona una zona.

  6. Para configurar la interfaz de red predeterminada de la máquina virtual, sigue estos pasos:

    1. Haz clic en Redes.
    2. En la sección Interfaces de red, haz clic en la primera interfaz de red, que es la predeterminada.
    3. Selecciona una red.
    4. Selecciona una subred que esté en la misma región que la vinculación de red de la interfaz de Private Service Connect.
    5. Seleccione un tipo de pila de IP.

  7. Haz clic en Listo.

Añadir interfaces de Private Service Connect

Puedes repetir estos pasos con cada interfaz que quieras añadir.

Añadir una interfaz virtual de Private Service Connect

  1. Haz clic en Añadir una interfaz de red.
  2. En Tipo de interfaz, selecciona Private Service Connect.
  3. Introduce la URL del archivo de red de esta interfaz.
  4. Seleccione un tipo de pila de IP para la interfaz. La subred del adjunto de red determina los tipos de pila posibles.
  5. Opcional: Para añadir un intervalo de IP de alias, haz lo siguiente:
    1. En la sección Intervalos de IPs de alias, haz clic en Añadir intervalo de IPs.
    2. En el cuadro Longitud del prefijo, introduce la longitud del prefijo (por ejemplo, /30). Puedes añadir varios intervalos de IP de alias haciendo clic en Añadir intervalo de IP y, a continuación, introduciendo la longitud del prefijo de cada intervalo de IP de alias adicional que quieras añadir.
  6. Haz clic en Listo.

Añadir una interfaz dinámica de Private Service Connect

  1. Haz clic en Añadir una interfaz de red dinámica.
  2. En Tipo de interfaz, selecciona Private Service Connect.
  3. Selecciona una interfaz de red principal.
  4. Introduce un ID de VLAN.
  5. Seleccione un tipo de pila de IP para la interfaz. La subred del adjunto de red determina los tipos de pila posibles.
  6. Opcional: Para añadir un intervalo de IP de alias, haz lo siguiente:
    1. En la sección Intervalos de IPs de alias, haz clic en Añadir intervalo de IPs.
    2. En el cuadro Longitud del prefijo, introduce la longitud del prefijo (por ejemplo, /30). Puedes añadir varios intervalos de IP de alias haciendo clic en Añadir intervalo de IP y, a continuación, introduciendo la longitud del prefijo de cada intervalo de IP de alias adicional que quieras añadir.
  7. Haz clic en Listo.

Para crear la VM, haz clic en Crear.

gcloud

  • Para crear una VM con una interfaz virtual de Private Service Connect, usa el comando gcloud compute instances create.

    gcloud compute instances create INSTANCE_NAME \
    --zone=ZONE \
    --machine-type=MACHINE_TYPE \
    --image-project=IMAGE_PROJECT \
    --image-family=IMAGE_FAMILY \
    --network-interface='subnet=PRODUCER_SUBNET,no-address' \
    --network-interface='network-attachment=ATTACHMENT_URI,stack-type=STACK_TYPE

    Haz los cambios siguientes:

    • INSTANCE_NAME: el nombre de la nueva instancia
    • ZONE: la zona de la nueva instancia
    • MACHINE_TYPE: el tipo de máquina de la instancia, que puede ser predefinido o personalizado. Por ejemplo, n1-standard-1.

    • IMAGE_PROJECT: el proyecto de la familia de imágenes

      Por ejemplo, si especifica debian-12 como familia de imágenes, especifique debian-cloud como proyecto de imagen. Puedes ver una lista de las imágenes, los proyectos de imágenes y las familias de imágenes disponibles con el comando gcloud compute images list.

    • IMAGE_FAMILY: la familia de imágenes de la instancia

      De esta forma, se crea la VM con la imagen de SO más reciente y no obsoleta de la familia de imágenes. Por ejemplo, si especificas debian-12, Compute Engine usará la versión más reciente de la imagen del SO en la familia de imágenes Debian 12.

    • PRODUCER_SUBNET: la subred de la interfaz de red principal de la VM

      Esta subred debe estar en la misma región que la red de la interfaz de Private Service Connect.

    • ATTACHMENT_URI: el URI de la red adjunta. Por ejemplo: projects/CONSUMER_PROJECT_ID/regions/REGION/networkAttachments/ATTACHMENT_NAME

    • STACK_TYPE: el tipo de pila de la interfaz dinámica de Private Service Connect

      Para crear una interfaz con una dirección IPv4, especifique IPV4_ONLY (el valor predeterminado). Para crear una interfaz que utilice tanto una dirección IPv4 como una IPv6 (doble pila), especifica IPV4_IPV6. Si solo quieres usar IPv6, especifica IPV6_ONLY.

      El tipo de pila de la interfaz debe ser compatible con el tipo de pila de la subred del archivo adjunto de red.

  • Para crear una VM con una interfaz de Private Service Connect dinámica, usa el siguiente comando:

    gcloud compute instances create INSTANCE_NAME \
    --zone=ZONE \
    --machine-type=MACHINE_TYPE \
    --image-project=IMAGE_PROJECT \
    --image-family=IMAGE_FAMILY \
    --network-interface='subnet=PRODUCER_SUBNET,no-address' \
    --network-interface='network-attachment=ATTACHMENT_URI,vlan=VLAN_ID,stack-type=STACK_TYPE'

    Sustituye VLAN_ID por el ID de VLAN de la interfaz de Private Service Connect dinámica, que debe ser un número entero entre 2 y 255.

    Los IDs de VLAN deben ser únicos para cada interfaz dinámica que comparta una vNIC principal. Puedes reutilizar el mismo ID para otras interfaces dinámicas asociadas a diferentes vNICs.

  • Para asignar intervalos de IP de alias a una interfaz de Private Service Connect, usa el siguiente comando:

    gcloud compute instances create INSTANCE_NAME \
    --zone=ZONE \
    --machine-type=MACHINE_TYPE \
    --image-project=IMAGE_PROJECT \
    --image-family=IMAGE_FAMILY \
    --network-interface='subnet=PRODUCER_SUBNET,no-address' \
    --network-interface='network-attachment=ATTACHMENT_URI,vlan=VLAN_ID,stack-type=STACK_TYPE,aliases=ALIAS_IP_RANGES'

    Sustituye ALIAS_IP_RANGES por uno o varios intervalos de IPs de alias que quieras asignar a la interfaz. Puede introducir intervalos específicos (192.168.100.0/24), direcciones IP específicas (192.168.100.1) o longitudes de prefijo en formato CIDR (/24). Puede introducir varios valores en una lista separada por punto y coma. No puedes introducir varios valores de tipos diferentes. Por ejemplo, no se admite 192.168.100.0/24;/28.

  • Para crear una VM con varias interfaces de Private Service Connect, incluye marcas --network-interface independientes para cada interfaz, donde cada marca hace referencia a un archivo de red diferente.

    En el caso de las interfaces de Private Service Connect dinámicas, la vNIC principal se determina según el orden de las marcas en el comando. La NIC virtual principal es la primera NIC virtual que especifica antes de la interfaz dinámica.

    Puedes crear interfaces de Private Service Connect dinámicas y virtuales que coexistan en la misma VM. Por ejemplo, el siguiente comando crea una VM con interfaces de Private Service Connect virtuales y dinámicas.

    El elemento superior de las interfaces dinámicas de Private Service Connect que tienen los IDs de VLAN 2 y 3 es la primera interfaz de red virtual, que se conecta a producer-subnet. El elemento superior de la interfaz dinámica que tiene el ID de VLAN 4 es la NIC virtual que se conecta a producer-subnet-2. La última interfaz es una interfaz virtual de Private Service Connect.

    gcloud compute instances create producer-vm \
    --zone=us-west-1a \
    --network-interface='subnet=producer-subnet,no-address' \
    --network-interface='network-attachment=projects/consumer-project/regions/us-west-1/networkAttachments/consumer-1-network-attachment,vlan=2' \
    --network-interface='network-attachment=projects/consumer-project/regions/us-west-1/networkAttachments/consumer-2-network-attachment,vlan=3' \
    --network-interface='network=producer-vpc-2,subnet=producer-subnet-2' \
    --network-interface='network-attachment=projects/consumer-project/regions/us-west-1/networkAttachments/consumer-3-network-attachment,vlan=4' \
    --network-interface='network-attachment=projects/consumer-project/regions/us-west-1/networkAttachments/consumer-4-network-attachment'

API

  • Para crear una VM con una interfaz virtual de Private Service Connect, envía una solicitud al método instances.insert.

    Método HTTP y URL:

    POST https://compute.googleapis.com/compute/v1/projects/PRODUCER_PROJECT_ID/zones/INSTANCE_ZONE/instances

    Cuerpo JSON de la solicitud:

    {
  "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "disks": [
    {
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
      },
      "boot": true
    }
  ],
  "networkInterfaces": [
    {
      "network": "https://compute.googleapis.com/compute/v1/projects/PRODUCER_PROJECT_ID/global/networks/PRODUCER_NETWORK",
      "subnetwork": "https://compute.googleapis.com/compute/v1/projects/PRODUCER_PROJECT_ID/regions/SUBNET_REGION/subnetworks/PRODUCER_SUBNET"
    },
    {
      "networkAttachment": "ATTACHMENT_URI",
      "stackType": "STACK_TYPE"
    }
  ]
}

    Haz los cambios siguientes:

    • PRODUCER_PROJECT_ID: el ID del proyecto de la VM
    • INSTANCE_ZONE: la zona de la nueva instancia
    • MACHINE_TYPE_ZONE: la zona del tipo de máquina
    • MACHINE_TYPE: el tipo de máquina de la instancia, que puede ser predefinido o personalizado. Por ejemplo, n1-standard-1.
    • VM_NAME: el nombre de la instancia de VM

    • IMAGE_PROJECT: el proyecto de la familia de imágenes

      Por ejemplo, si especifica debian-12 como familia de imágenes, especifique debian-cloud como proyecto de imagen. Para ver una lista de las imágenes, los proyectos de imágenes y las familias de imágenes disponibles, usa el comando gcloud compute images list.

    • IMAGE_FAMILY: la familia de imágenes de la instancia.

      De esta forma, se crea la VM con la imagen de SO más reciente y no obsoleta de la familia de imágenes. Por ejemplo, si especificas debian-12, Compute Engine usará la versión más reciente de la imagen del SO en la familia de imágenes Debian 12.

    • PRODUCER_NETWORK: la red de la interfaz de red principal de la VM

    • SUBNET_REGION: la región de la subred de la interfaz de red principal de la máquina virtual

    • PRODUCER_SUBNET: la subred de la interfaz de red principal de la VM

      Esta subred debe estar en la misma región que la red de la interfaz de Private Service Connect.

    • ATTACHMENT_URI: el URI de la red attachment. Por ejemplo: projects/CONSUMER_PROJECT_ID/regions/REGION/networkAttachments/ATTACHMENT_NAME

    • STACK_TYPE: el tipo de pila de la interfaz de Private Service Connect dinámica.

      Para crear una interfaz con una dirección IPv4, especifique IPV4_ONLY (el valor predeterminado). Para crear una interfaz que utilice tanto una dirección IPv4 como una IPv6 (de doble pila), especifica IPV4_IPV6. Si solo quieres usar IPv6, especifica IPV6_ONLY.

      El tipo de pila de la interfaz debe ser compatible con el tipo de pila de la subred del archivo adjunto de red.

  • Para crear una VM con una interfaz de Private Service Connect dinámica, envía la siguiente solicitud. Incluye un ID de VLAN en el objeto de interfaz de red para especificar la creación de una interfaz de Private Service Connect dinámica.

    Método HTTP y URL:

    POST https://compute.googleapis.com/compute/v1/projects/PRODUCER_PROJECT_ID/zones/INSTANCE_ZONE/instances

    Cuerpo JSON de la solicitud:

    {
  "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "disks": [
    {
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
      },
      "boot": true
    }
  ],
  "networkInterfaces": [
    {
      "network": "https://compute.googleapis.com/compute/v1/projects/PRODUCER_PROJECT_ID/global/networks/PRODUCER_NETWORK",
      "subnetwork": "https://compute.googleapis.com/compute/v1/projects/PRODUCER_PROJECT_ID/regions/SUBNET_REGION/subnetworks/PRODUCER_SUBNET"
    },
    {
      "networkAttachment": "ATTACHMENT_URI",
      "vlan": VLAN_ID,
      "stackType": "IPV4_IPV6"
    }
  ]
}

    Sustituye VLAN_ID por el ID de VLAN de la interfaz de Private Service Connect dinámica, que debe ser un número entero entre 2 y 255.

    Los IDs de VLAN deben ser únicos para cada interfaz dinámica que comparta una vNIC principal. Puedes reutilizar el mismo ID para otras interfaces dinámicas asociadas a diferentes vNICs.

  • Para asignar intervalos de IP de alias a una interfaz de Private Service Connect, envía la siguiente solicitud. Incluye el campo aliasesIpRanges.

    Método HTTP y URL:

    POST https://compute.googleapis.com/compute/v1/projects/PRODUCER_PROJECT_ID/zones/INSTANCE_ZONE/instances

    Cuerpo JSON de la solicitud:

    {
  "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "disks": [
    {
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      },
      "boot": true
    }
  ],
  "networkInterfaces": [
    {
      "network": "https://compute.googleapis.com/compute/v1/projects/PRODUCER_PROJECT_ID/global/networks/PRODUCER_NETWORK",
      "subnetwork": "https://compute.googleapis.com/compute/v1/projects/PRODUCER_PROJECT_ID/regions/SUBNET_REGION/subnetworks/PRODUCER_SUBNET"
    },
    {
      "aliasIpRanges": [
        {
          "ipCidrRange": "ALIAS_IP_RANGE"
        }
      ],
      "networkAttachment": "ATTACHMENT_URI"
    }
  ]
}

    Sustituye ALIAS_IP_RANGE por los intervalos de IP de alias que quieras asignar a la interfaz. Puede introducir un intervalo específico (192.168.100.0/24), una dirección IP específica (192.168.100.1) o una longitud de prefijo en formato CIDR (/24).

    Puedes especificar varios intervalos de IPs de alias en el array aliasIpRanges. Cada intervalo debe especificarse con el mismo formato:

    "aliasIpRanges": [
  {
    "ipCidrRange": "/28"
  },
  {
    "ipCidrRange": "/30"
  }
]

  • Para crear una VM con varias interfaces de Private Service Connect, incluya objetos independientes en la matriz networkInterfaces para cada interfaz, donde cada objeto de interfaz haga referencia a un adjunto de red diferente.

    En el caso de las interfaces de Private Service Connect dinámicas, la vNIC principal se determina según el orden de los objetos en la matriz. La NIC virtual principal es la primera NIC virtual que especifica antes de la interfaz dinámica.

    Puedes crear interfaces de Private Service Connect dinámicas y virtuales que coexistan en la misma VM. Por ejemplo, la siguiente solicitud crea una VM con interfaces de Private Service Connect virtuales y dinámicas.

    El elemento superior de las interfaces dinámicas de Private Service Connect que tienen los IDs de VLAN 2 y 3 es la primera interfaz de red virtual, que se conecta a producer-subnet. El elemento superior de la interfaz dinámica que tiene el ID de VLAN 4 es la NIC virtual que se conecta a producer-subnet-2. La última interfaz es una interfaz virtual de Private Service Connect.

    {
  "machineType": "zones/us-west-1a/machineTypes/e2-medium",
  "name": "producer-vm",
  "disks": [
    {
      "initializeParams": {
        "sourceImage": "projects/debian-cloud/global/images/family/debian-11"
    },
    "boot": true
  }
  ],
  "networkInterfaces": [
    {
      "network": "https://www.googleapis.com/compute/v1/projects/producer-project-id/global/networks/producer-vpc-1",
      "subnetwork": "https://www.googleapis.com/compute/v1/projects/producer-project-id/regions/us-west-1/subnetworks/producer-subnet"
    },
    {
      "networkAttachment": "projects/consumer-project1/regions/us-west-1/networkAttachments/consumer-1-network-attachment",
      "vlan": 2
    },
    {
      "networkAttachment": "projects/consumer-project2/regions/us-west-1/networkAttachments/consumer-2-network-attachment",
      "vlan": 3
    },
    {
      "network": "https://www.googleapis.com/compute/v1/projects/producer-project-id/global/networks/producer-vpc-2",
      "subnetwork": "https://www.googleapis.com/compute/v1/projects/producer-project-id/regions/us-west-1/subnetworks/producer-subnet-2"
    },
    {
      "networkAttachment": "projects/consumer-project3/regions/us-west-1/networkAttachments/consumer-3-network-attachment",
      "vlan": 4
    },
    {
      "networkAttachment": "projects/consumer-project4/regions/us-west-1/networkAttachments/consumer-4-network-attachment"
    }
  ]
}
```

Para obtener más información sobre cómo crear instancias de VM, consulta Crear e iniciar una instancia de VM.

Añadir interfaces de Private Service Connect dinámicas a VMs

Puedes añadir una interfaz dinámica de Private Service Connect a una VM que ya tengas sin tener que reiniciarla.

Debes configurar el enrutamiento para que el tráfico pueda fluir a través de una nueva interfaz de Private Service Connect.

Consola

  1. En la Google Cloud consola, ve a la página Instancias de VM:

    Ir a instancias de VM

  2. Haz clic en el nombre de la VM que quieras actualizar.

  3. Haz clic en Editar.

  4. En la sección Redes, haga clic en Añadir una interfaz de red dinámica.

  5. En Tipo de interfaz, selecciona Private Service Connect.

  6. Selecciona una interfaz de red principal.

  7. Introduce un ID de VLAN.

  8. Introduce la URL del archivo de red de esta interfaz.

  9. Selecciona un tipo de pila de IP para la interfaz. La subred del adjunto de red determina los tipos de pila posibles.

  10. Opcional: Para añadir un intervalo de IP de alias, siga estos pasos:

    1. En la sección Intervalos de IPs de alias, haz clic en Añadir intervalo de IPs.
    2. En el cuadro Longitud del prefijo, introduce la longitud del prefijo (por ejemplo, /30). Puedes añadir varios intervalos de IP de alias haciendo clic en Añadir intervalo de IP y, a continuación, introduciendo la longitud del prefijo de cada intervalo de IP de alias adicional que quieras añadir.

  11. Haz clic en Listo.

  12. Haz clic en Guardar.

gcloud

Para añadir una interfaz dinámica de Private Service Connect a una máquina virtual, usa el comando gcloud compute instances network-interfaces add.

Para añadir varias interfaces de Private Service Connect dinámicas, repite el comando con cada interfaz que quieras añadir.

gcloud compute instances network-interfaces add INSTANCE_NAME \
    --zone=ZONE \
    --vlan=VLAN_ID \
    --parent-nic-name=PARENT_NIC_NAME \
    --network-attachment=ATTACHMENT_URI

Haz los cambios siguientes:

  • INSTANCE_NAME: el nombre de la instancia que se va a actualizar
  • ZONE: la zona de la instancia que se va a actualizar

  • VLAN_ID: ID (entero del 2 al 4094) de la interfaz dinámica de Private Service Connect.

    Los IDs de VLAN deben ser únicos para cada interfaz dinámica que comparta una vNIC principal. Puedes reutilizar el mismo ID para otras interfaces dinámicas asociadas a diferentes vNICs.

  • PARENT_NIC_NAME: el nombre de la interfaz de red principal de la nueva NIC de VLAN. Por ejemplo, nic0.

  • ATTACHMENT_URI: el URI de la red attachment. Por ejemplo: projects/CONSUMER_PROJECT_ID/regions/REGION/networkAttachments/ATTACHMENT_NAME

API

Para añadir una interfaz dinámica de Private Service Connect a una VM, envía una solicitud al método instances.addNetworkInterface.

Para añadir varias interfaces de Private Service Connect dinámicas, repite la solicitud para cada interfaz que quieras añadir.

Método HTTP y URL:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/addNetworkInterface

Cuerpo JSON de la solicitud:

{
  "networkAttachment": "ATTACHMENT_URI",
  "parentNicName": "PARENT_NIC_NAME",
  "vlan": VLAN_ID
}

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto de la VM
  • ZONE: la zona de la VM

  • INSTANCE_NAME: el nombre de la VM que se va a actualizar

  • ATTACHMENT_URI: el URI de la red attachment. Por ejemplo: projects/CONSUMER_PROJECT_ID/regions/REGION/networkAttachments/ATTACHMENT_NAME

  • PARENT_NIC_NAME: el nombre de la interfaz de red principal de la nueva NIC de VLAN; por ejemplo, nic0

  • VLAN_ID: un ID (un número entero del 2 al 4094) de la interfaz Private Service Connect de la NIC de VLAN.

    Los IDs de interfaz de NIC de VLAN deben ser únicos para cada NIC de VLAN de una interfaz de red principal, pero puedes reutilizar el mismo ID para otras NICs de VLAN asociadas a diferentes interfaces de red principales.

Migrar de interfaces de Private Service Connect virtuales a dinámicas

Para configurar tu servicio de forma que use interfaces de Private Service Connect dinámicas en lugar de interfaces de Private Service Connect virtuales, haz lo siguiente.

  1. Crea una VM que use interfaces de Private Service Connect dinámicas.
  2. Configura el enrutamiento de la nueva VM.
  3. Actualiza tu servicio para usar la nueva máquina virtual.
  4. Elimina la VM que usa interfaces virtuales de Private Service Connect.

Crear y gestionar interfaces Private Service Connect mediante plantillas de instancia

Puedes crear y gestionar interfaces de Private Service Connect mediante plantillas de instancia.

Una vez que hayas creado una plantilla de instancia, podrás usarla para lo siguiente:

Para crear plantillas de instancias que usen intervalos de IP de alias o varias interfaces de Private Service Connect, sigue el mismo procedimiento que para crear VMs con interfaces de Private Service Connect. Las plantillas de instancia solo admiten la especificación de intervalos de IP de alias por longitud de prefijo.

Consola

  1. En la Google Cloud consola, ve a la página Plantillas de instancia:

    Ir a Plantillas de instancia

  2. Haz clic en Crear plantilla de instancia.

  3. Introduce un nombre para la plantilla de instancia.

  4. Haz clic en Advanced options (Opciones avanzadas).

  5. Haz clic en Redes.

  6. En la sección Interfaces de red, haz clic en la flecha de expansión .

  7. Selecciona una red y una subred para la interfaz de red principal de la plantilla de instancia.

  8. Haz clic en Listo.

  9. Para añadir una interfaz de Private Service Connect, sigue estos pasos: Puedes repetir estos pasos con cada interfaz que quieras añadir:

    • Para una interfaz virtual de Private Service Connect, haz lo siguiente:
      1. Haz clic en Añadir una interfaz de red.
      2. En Tipo de interfaz, selecciona Private Service Connect.
    • Para una interfaz de Private Service Connect dinámica, haz lo siguiente:
      1. Haz clic en Añadir interfaz de red dinámica.
      2. En Tipo de interfaz, selecciona Private Service Connect.
      3. Selecciona una interfaz de red principal.
      4. Introduce un ID de VLAN.

  10. Para completar la configuración de tu interfaz de Private Service Connect, haz lo siguiente:

    1. Introduce la URL del archivo de red de esta interfaz.
    2. Selecciona un tipo de pila de IP para la interfaz. La subred del adjunto de red determina los tipos de pila posibles.
    3. Opcional: Para añadir un intervalo de IP de alias, haz lo siguiente:
      1. En la sección Intervalos de IPs de alias, haz clic en Añadir intervalo de IPs.
      2. En el cuadro Longitud del prefijo, introduce la longitud del prefijo (por ejemplo, /30). Puedes añadir varios intervalos de IP de alias haciendo clic en Añadir intervalo de IP y, a continuación, introduciendo la longitud del prefijo de cada intervalo de IP de alias adicional que quieras añadir.
    4. Haz clic en Listo.

  11. Para crear la VM, haz clic en Crear.

gcloud

  • Para crear una plantilla de instancia con una interfaz virtual de Private Service Connect, usa el comando gcloud compute instance-templates create.

    gcloud compute instance-templates create NAME \
    --machine-type=MACHINE_TYPE \
    --image-project=IMAGE_PROJECT \
    --image-family=IMAGE_FAMILY \
    --region=REGION \
    --network-interface='subnet=PRODUCER_SUBNET,no-address' \
    --network-interface='network-attachment=ATTACHMENT_URI,stack-type=STACK_TYPE'

    Haz los cambios siguientes:

    • NAME: el nombre de la nueva plantilla de instancia
    • MACHINE_TYPE: el tipo de máquina de la instancia, que puede ser predefinido o personalizado. Por ejemplo, n1-standard-1.

    • IMAGE_PROJECT: el proyecto de la familia de imágenes

      Por ejemplo, si especifica debian-12 como familia de imágenes, especifique debian-cloud como proyecto de imagen. Puedes ver una lista de las imágenes, los proyectos de imágenes y las familias de imágenes disponibles con el comando gcloud compute images list.

    • IMAGE_FAMILY: la familia de imágenes de la instancia

      De esta forma, se crea la VM con la imagen de SO más reciente y no obsoleta de la familia de imágenes. Por ejemplo, si especificas debian-12, Compute Engine usará la versión más reciente de la imagen del SO en la familia de imágenes Debian 12.

    • REGION: la región de la subred del productor de la plantilla de instancia.

    • PRODUCER_SUBNET: la subred de la plantilla de la instancia

      Cuando creas una VM mediante esta plantilla de instancia, se asigna una dirección IP interna de esta subred a la interfaz de red principal de la VM. Esta subred debe estar en la misma región que la red de la interfaz de Private Service Connect.

    • ATTACHMENT_URI: el URI de la red attachment. Por ejemplo: projects/CONSUMER_PROJECT_ID/regions/REGION/networkAttachments/ATTACHMENT_NAME

    • STACK_TYPE: el tipo de pila de la interfaz Private Service Connect dinámica de la plantilla de instancia.

      Para crear una interfaz con una dirección IPv4, especifique IPV4_ONLY (el valor predeterminado). Para crear una interfaz que utilice tanto una dirección IPv4 como una IPv6 (doble pila), especifica IPV4_IPV6. Si solo quieres usar IPv6, especifica IPV6_ONLY.

      El tipo de pila de la interfaz debe ser compatible con el tipo de pila de la subred del archivo adjunto de red.

  • Para crear una plantilla de instancia con una interfaz de Private Service Connect dinámica, usa el siguiente comando:

    gcloud compute instance-templates create NAME \
    --machine-type=MACHINE_TYPE \
    --image-project=IMAGE_PROJECT \
    --image-family=IMAGE_FAMILY \
    --region=REGION \
    --network-interface='subnet=PRODUCER_SUBNET,no-address' \
    --network-interface='network-attachment=ATTACHMENT_URI,vlan=VLAN_ID,stack-type=STACK_TYPE'

    Sustituye VLAN_ID por el ID de VLAN de la interfaz de Private Service Connect dinámica, que debe ser un número entero entre 2 y 255.

    Los IDs de VLAN deben ser únicos para cada interfaz dinámica que comparta una vNIC principal. Puedes reutilizar el mismo ID para otras interfaces dinámicas asociadas a diferentes vNICs.

API

  • Para crear una plantilla de instancia con una interfaz virtual de Private Service Connect, envía una solicitud al método instanceTemplates.insert.

    Método HTTP y URL:

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/instanceTemplates

    Cuerpo JSON de la solicitud:

    {
  "name": "NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "subnetwork": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/SUBNET_REGION/subnetworks/PRODUCER_SUBNET"
      },
      {
        "networkAttachment": "ATTACHMENT_URI",
        "stackType": "STACK_TYPE"
      }
    ]
  }
}

    Haz los cambios siguientes:

    • PROJECT_ID: el ID de proyecto de la plantilla de instancia
    • NAME: el nombre de la nueva plantilla de instancia

    • IMAGE_PROJECT: el proyecto de la familia de imágenes

      Por ejemplo, si especifica debian-12 como familia de imágenes, especifique debian-cloud como proyecto de imagen. Para ver una lista de las imágenes, los proyectos de imágenes y las familias de imágenes disponibles, usa el comando gcloud compute images list.

    • IMAGE_FAMILY: la familia de imágenes de la instancia.

      De esta forma, se crea la VM con la imagen de SO más reciente y no obsoleta de la familia de imágenes. Por ejemplo, si especificas debian-12, Compute Engine usará la versión más reciente de la imagen del SO en la familia de imágenes Debian 12.

    • MACHINE_TYPE: el tipo de máquina de la instancia, que puede ser predefinido o personalizado. Por ejemplo, n1-standard-1.

    • SUBNET_REGION: la región de la subred del productor de la plantilla de instancia.

    • PRODUCER_SUBNET: la subred de la plantilla de la instancia

      Cuando creas una VM mediante esta plantilla de instancia, se asigna una dirección IP interna de esta subred a la interfaz de red principal de la VM. Esta subred debe estar en la misma región que la red de la interfaz de Private Service Connect.

    • ATTACHMENT_URI: el URI de la red adjunta. Por ejemplo: projects/CONSUMER_PROJECT_ID/regions/REGION/networkAttachments/ATTACHMENT_NAME

    • STACK_TYPE: el tipo de pila de la interfaz Private Service Connect dinámica de la plantilla de instancia

      Para crear una interfaz con una dirección IPv4, especifique IPV4_ONLY (el valor predeterminado). Para crear una interfaz que utilice tanto una dirección IPv4 como una IPv6 (doble pila), especifica IPV4_IPV6. Si solo quieres usar IPv6, especifica IPV6_ONLY.

      El tipo de pila de la interfaz debe ser compatible con el tipo de pila de la subred del archivo adjunto de red.

  • Para crear una plantilla de instancia con una interfaz de Private Service Connect dinámica, haz la siguiente solicitud.

    Método HTTP y URL:

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/instanceTemplates

    Cuerpo JSON de la solicitud:

    {
  "name": "NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "subnetwork": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/SUBNET_REGION/subnetworks/PRODUCER_SUBNET"
      },
      {
        "networkAttachment": "ATTACHMENT_URI",
        "vlan": VLAN_ID,
        "stackType": "STACK_TYPE"
      }
    ]
  }
}

    Sustituye VLAN_ID por el ID de VLAN de la interfaz de Private Service Connect dinámica, que debe ser un número entero entre 2 y 255.

    Los IDs de VLAN deben ser únicos para cada interfaz dinámica que comparta una vNIC principal. Puedes reutilizar el mismo ID para otras interfaces dinámicas asociadas a diferentes vNICs.

Para obtener más información sobre cómo crear plantillas de instancia, consulta el artículo Crear plantillas de instancia.

Describe una interfaz de Private Service Connect

Puedes describir una VM para ver los detalles de sus interfaces de Private Service Connect. El nombre, la dirección IP, los intervalos de IP de alias, la vinculación de red y la subred de consumidor de cada interfaz se indican en la sección de interfaces de red de la descripción de la máquina virtual.

Consola

  1. En la consola de Google Cloud , ve a la página Instancias de VM.

    Ir a instancias de VM

  2. Haz clic en la VM que tenga tu interfaz de Private Service Connect.

  3. En la sección Interfaces de red, consulta los detalles de tu interfaz de Private Service Connect.

gcloud

gcloud compute instances describe VM_NAME
    --zone=ZONE

Haz los cambios siguientes:

  • VM_NAME: el nombre de la máquina virtual de tu interfaz.
  • ZONE: la zona de tu VM.

API 

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME

Haz los cambios siguientes:

  • PROJECT_ID: el ID de proyecto de la VM.
  • ZONE: la zona de la VM.
  • VM_NAME: el nombre de la VM.

Finalizar conexiones de interfaz de Private Service Connect

Para finalizar una conexión entre una interfaz de Private Service Connect virtual y un adjunto de red, elimina la VM de la interfaz.

Para finalizar una conexión entre una interfaz de Private Service Connect dinámica y un archivo adjunto de red, haz una de las siguientes acciones:

  • Quita la interfaz dinámica de Private Service Connect.
  • Elimina la VM de la interfaz dinámica de Private Service Connect.

Quitar una interfaz de Private Service Connect dinámica

Puedes quitar una interfaz de Private Service Connect dinámica sin reiniciar la VM asociada.

Consola

  1. En la Google Cloud consola, ve a la página Instancias de VM:

    Ir a instancias de VM

  2. Haz clic en el nombre de la VM que quieras actualizar.

  3. Haz clic en Editar.

  4. En la sección Interfaces de red dinámicas, haga clic en Eliminar junto a la interfaz que quiera eliminar.

gcloud

Usa el comando gcloud compute instances network-interfaces delete.

gcloud compute instances network-interfaces delete INSTANCE_NAME \
    --zone=ZONE \
    --network-interface=INTERFACE_NAME

Haz los cambios siguientes:

  • INSTANCE_NAME: el nombre de la instancia de VM de la interfaz
  • ZONE: la zona de la instancia de VM de la interfaz

  • INTERFACE_NAME: el Google Cloud nombre de la interfaz de Private Service Connect dinámica que se va a eliminar.

    Por ejemplo, nic0.10 es el nombre de una interfaz de Private Service Connect dinámica, donde nic0 es el elemento superior y 10 es el ID de VLAN.

API

Envía una solicitud al método instances.deleteNetworkInterface.

Método HTTP y URL:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/deleteNetworkInterface?networkInterfaceName=INTERFACE_NAME

Haz los cambios siguientes:

  • PROJECT_ID: el ID de proyecto de la VM de la interfaz
  • ZONE: la zona de la VM de la interfaz
  • INSTANCE_NAME: el nombre de la VM de la interfaz

  • INTERFACE_NAME: nombre de la interfaz de Private Service Connect dinámica que se va a eliminar. Google Cloud

    Por ejemplo, nic0.10 es el nombre de una interfaz de Private Service Connect dinámica, donde nic0 es el nombre de la vNIC superior y 10 es el ID de VLAN.

Eliminar una VM con una interfaz de Private Service Connect

Si eliminas una VM, se terminarán todas las conexiones de la interfaz de Private Service Connect.

Para obtener información sobre cómo eliminar una VM, consulta Eliminar una instancia.

Siguientes pasos