Crea una instancia con el modelo vinculado a la reserva

En este documento, se explica cómo crear una instancia independiente de Compute Engine con el modelo de aprovisionamiento vinculado a la reserva. Este modelo de aprovisionamiento te permite crear instancias A4X Max, A4X, A4, A3 Ultra, A3 Mega, A3 High con 8 GPUs, A3 Edge o H4D mediante el consumo de capacidad reservada previamente.

Para conocer otros métodos para crear instancias de procesamiento con el modelo de aprovisionamiento vinculado a la reserva, consulta Descripción general de las opciones de implementación en la documentación de AI Hypercomputer.

Antes de comenzar

• Si aún no lo hiciste, configura la autenticación. La autenticación verifica tu identidad para acceder a los Google Cloud servicios y las APIs. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

  Selecciona la pestaña según cómo planeas usar las muestras en esta página:

  Console

  Cuando usas la Google Cloud consola para acceder a los Google Cloud servicios y las APIs, no necesitas configurar la autenticación.

  gcloud

  1. Instala la Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando:

     gcloud init

     Si usas un proveedor de identidad (IdP) externo, primero debes acceder a gcloud CLI con tu identidad federada.

     Nota: Si ya instalaste gcloud CLI, asegúrate de tener la versión más reciente ejecutando gcloud components update.
• Configura una región y una zona predeterminadas.

REST

Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.

Instala la Google Cloud CLI.

Si usas un proveedor de identidad (IdP) externo, primero debes acceder a gcloud CLI con tu identidad federada.

Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de. Google Cloud

Roles obligatorios

Para obtener los permisos que necesitas para crear instancias de procesamiento con el modelo de aprovisionamiento vinculado a la reserva, pídele al administrador que te otorgue el rol de IAM Administrador de instancias de Compute (v1) (roles/compute.instanceAdmin.v1) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para crear instancias de procesamiento con el modelo de aprovisionamiento vinculado a la reserva. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para crear instancias de procesamiento con el modelo de aprovisionamiento vinculado a la reserva:

• compute.instances.create en el proyecto
• Si deseas usar una imagen personalizada para crear la VM, sigue estos pasos: compute.images.useReadOnly en la imagen
• Para usar una instantánea a fin de crear la VM, haz lo siguiente: compute.snapshots.useReadOnly en la instantánea
• Si quieres usar una plantilla de instancias para crear la VM, sigue estos pasos: compute.instanceTemplates.useReadOnly en la plantilla de instancias
• A fin de especificar una subred para tu VM: compute.subnetworks.use en el proyecto o en la subred elegida
• Si deseas especificar una dirección IP estática para la VM: compute.addresses.use en el proyecto
• Para asignar una dirección IP externa a la VM cuando se usa una red de VPC: compute.subnetworks.useExternalIp en el proyecto o en la subred elegida.
• Para asignar una red heredada a la VM: compute.networks.use en el proyecto.
• Para asignar una dirección IP externa a la VM cuando se usa una red heredada: compute.networks.useExternalIp en el proyecto
• Para configurar los metadatos de la instancia de VM para la VM: compute.instances.setMetadata en el proyecto.
• Para configurar etiquetas en la VM, haz lo siguiente: compute.instances.setTags en la VM
• Para configurar etiquetas en la VM, haz lo siguiente: compute.instances.setLabels en la VM
• A fin de configurar una cuenta de servicio para que la VM use: compute.instances.setServiceAccount en la VM
• Crear un disco nuevo para la VM: compute.disks.create en el proyecto
• Para conectar un disco existente en modo de solo lectura o de lectura y escritura, usa compute.disks.use en el disco.
• Para conectar un disco existente en modo de solo lectura, haz lo siguiente: compute.disks.useReadOnly en el disco

También puedes obtener estos permisos con roles personalizados o otros roles predefinidos.

Crea una instancia que use el modelo de aprovisionamiento vinculado a la reserva

Para crear una instancia A4X Max, A4X, A4, A3 Ultra, A3 Mega, A3 High con 8 GPUs o H4D con el modelo de aprovisionamiento vinculado a la reserva, debes esperar hasta que la reserva creada de forma automática que deseas usar alcance su hora de inicio. Además, la instancia de procesamiento que deseas crear debe cumplir con todos los siguientes requisitos:

• La instancia de procesamiento y la reserva deben tener propiedades coincidentes.

• La instancia de procesamiento debe orientarse específicamente a la reserva para consumirla.

• La instancia de procesamiento debe detenerse o borrarse a la hora de finalización de la reserva.

En el siguiente ejemplo, se crea una solicitud de reserva futura en el modo de calendario para cinco instancias A3 Ultra y, luego, se crea una instancia A3 Ultra mediante el consumo de la reserva creada de forma automática para la solicitud.

Para crear una instancia de procesamiento de ejemplo con el modelo de aprovisionamiento vinculado a la reserva, selecciona una de las siguientes opciones:

Console

1. Crea una solicitud de ejemplo para cinco instancias A3 Ultra y envíala para su revisión:

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

      Ir a Reservas

   2. Haz clic en la pestaña Reservas futuras.

   3. Haz clic en Crear reserva futura. Aparecerá la página Crear una reserva futura.

   4. Haz clic en la pestaña GPUs y, luego, en la lista Tipo de GPU, selecciona NVIDIA H200 141GB. Esta acción especifica una instancia A3 Ultra.

   5. En el campo Capacidad total necesaria, ingresa 5.

   6. En la sección Período de reserva, especifica la hora de inicio y la duración del período de reserva.

   7. Haz clic en Buscar capacidad y, luego, en la sección Capacidad disponible, selecciona una de las máquinas disponibles.

   8. Haz clic en Crear.

2. A la hora de inicio de la solicitud, para crear una instancia A3 Ultra que consuma la reserva creada de forma automática de ejemplo, haz lo siguiente:

   Importante: En los siguientes pasos, se muestra cómo crear una instancia A3 Ultra de una sola NIC, lo que resulta útil para pruebas rápidas. Para crear una instancia A3 Ultra con varias NIC, consulta en su lugar Crea una instancia A3 Ultra o A4.

   1. En la Google Cloud consola, ve a la página Crear una instancia.

      Ir a Crear una instancia

   2. En el campo Nombre, ingresa un nombre para la instancia de procesamiento. Para este ejemplo, ingresa example-instance.

   3. Especifica la región y la zona en las que existe la reserva creada de forma automática. Para este ejemplo, selecciona us-central1 y us-central1-b , respectivamente.

   4. Haz clic en la pestaña GPUs y, luego, en la lista Tipo de GPU, selecciona NVIDIA H200 141GB. Esta acción especifica una instancia A3 Ultra y establece el modelo de aprovisionamiento en Vinculado a la reserva.

   5. En el menú de navegación, haz clic en Opciones avanzadas.

   6. En la sección Reservas, selecciona Elegir una reserva, y, luego, haz clic en Elegir una reserva.

   7. En el panel Elegir una reserva, haz lo siguiente:

      1. Selecciona la reserva creada de forma automática de ejemplo.

      2. Haz clic en Elegir.

   8. En la sección Modelo de aprovisionamiento, expande la sección Configuración avanzada del modelo de aprovisionamiento de VM.

   9. En la lista Finalización de VM, selecciona Detener (predeterminado) o Borrar.

   10. Haz clic en Crear.

gcloud

1. Para crear una solicitud de ejemplo para cinco instancias A3 Ultra y enviarla para su revisión, usa el gcloud beta compute future-reservations create comando:

   gcloud beta compute future-reservations create example-fr \
       --auto-delete-auto-created-reservations \
       --deployment-type=DENSE \
       --planning-status=SUBMITTED \
       --require-specific-reservation \
       --reservation-mode=CALENDAR \
       --reservation-name=example-reservation \
       --share-setting=local \
       --start-time=2026-03-05T00:00:00Z \
       --end-time=2026-03-19T00:00:00Z \
       --machine-type=a3-ultragpu-8g \
       --total-count=5 \
       --zone=us-central1-b
   

   Supongamos que Google Cloud aprueba la solicitud y Compute Engine crea automáticamente una reserva vacía. A la hora de inicio de la solicitud, el 5 de marzo de 2026, Compute Engine aumenta la cantidad de instancias de GPU reservadas en la reserva. Luego, puedes consumir la reserva.

2. A la hora de inicio de la solicitud, para crear una instancia A3 Ultra que consuma la reserva creada de forma automática de ejemplo, usa el gcloud compute instances create comando con las siguientes marcas:

   • La marca --instance-termination-action

   • La marca --provisioning-model configurada como RESERVATION_BOUND

   • La marca --reservation

   • La marca --reservation-affinity configurada como specific

   El comando es similar al siguiente. Para conocer los requisitos completos para crear una instancia A3 Ultra, consulta en su lugar Crea una instancia A3 Ultra o A4.

   gcloud compute instance create example-a3ultra-instance  \
       --machine-type=a3-ultragpu-8g \
       --instance-termination-action=TERMINATION_ACTION \
       --provisioning-model=RESERVATION_BOUND \
       --reservation-affinity=specific \
       --reservation=RESERVATION_URL \
       --zone=us-central1-b \
       ...
   

   El comando incluye los siguientes valores:

   • TERMINATION_ACTION: Indica si Compute Engine detiene (STOP) o borra (DELETE) la instancia de procesamiento al final del período de reserva.

   • RESERVATION_URL: Es la URL de la reserva, que tiene el siguiente formato:

     • Si la reserva creada de forma automática existe en tu proyecto: example-reservation.

     • Si la reserva creada de forma automática existe en un proyecto diferente: projects/PROJECT_ID/reservations/example-reservation.

REST

1. Para crear una solicitud de ejemplo para cinco instancias A3 Ultra y enviarla para su revisión, realiza una POST solicitud al método futureReservations.insert beta:

   POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-b/futureReservations
   
   {
     "name": "example-request-calendar-mode",
     "autoDeleteAutoCreatedReservations": true,
     "deploymentType": "DENSE",
     "planningStatus": "SUBMITTED",
     "reservationMode": "CALENDAR",
     "reservationName": "example-reservation",
     "shareSettings": {
       "shareType": "LOCAL"
     },
     "specificReservationRequired": true,
     "specificSkuProperties": {
       "machineType": "a3-ultragpu-8g",
       "totalCount": 5
     },
     "timeWindow": {
       "startTime": "2026-03-05T00:00:00Z",
       "endTime": "2026-03-19T00:00:00Z"
     }
   }
   

   Supongamos que Google Cloud aprueba la solicitud y Compute Engine crea automáticamente una reserva vacía. A la hora de inicio de la solicitud, el 5 de marzo de 2026, Compute Engine aumenta la cantidad de instancias de GPU reservadas en la reserva. Luego, puedes consumir la reserva.

2. A la hora de inicio de la solicitud, para crear una instancia A3 Ultra que consuma la reserva creada de forma automática de ejemplo, realiza una solicitud POST al instances.insert método. En el cuerpo de la solicitud, incluye los siguientes campos:

   • El campo reservationAffinity.consumeReservationType configurado como SPECIFIC_RESERVATION

   • El campo reservationAffinity.key configurado como compute.googleapis.com/reservation-name

   • El campo reservationAffinity.values configurado como la URL de la reserva

   • El campo scheduling.instanceTerminationAction

   • El campo scheduling.provisioningModel configurado como RESERVATION_BOUND

   La solicitud es similar a la siguiente. Para conocer los requisitos completos para crear una instancia A3 Ultra, consulta en su lugar Crea una instancia A3 Ultra o A4.

   POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-b/instances
   
   {
     {
       "machineType": "projects/example-project/zones/us-central1-b/machineTypes/a3-ultragpu-8g",
       "name": "example-a3ultra-instance",
       "reservationAffinity": {
         "consumeReservationType": "SPECIFIC_RESERVATION",
         "key": "compute.googleapis.com/reservation-name",
         "values":[
           "RESERVATION_URL"
         ],
       },
       "scheduling": {
         "instanceTerminationAction": "TERMINATION_ACTION",
         "provisioningModel": "RESERVATION_BOUND"
       },
       ...
     }
   }
   

   El cuerpo de la solicitud incluye los siguientes valores:

   • RESERVATION_URL: Es la URL de la reserva, que tiene el siguiente formato:

     • Si la reserva creada de forma automática existe en tu proyecto: example-reservation.

     • Si la reserva creada de forma automática existe en un proyecto diferente: projects/PROJECT_ID/reservations/example-reservation.

   • TERMINATION_ACTION: Indica si Compute Engine detiene (STOP) o borra (DELETE) la instancia de procesamiento al final del período de reserva.

¿Qué sigue?

• Conéctate a tu instancia de procesamiento

• Ejecuta secuencias de comandos de cierre

• Plantillas de instancia

• Detén o reinicia una instancia

Pruébalo tú mismo

Si es la primera vez que usas Google Cloud, crea una cuenta para evaluar el rendimiento de Compute Engine en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar e implementar cargas de trabajo.

Probar Compute Engine gratis