Crear una VM que use el modelo de reserva

En este documento se explica cómo crear una instancia de máquina virtual (VM) independiente mediante el modelo de aprovisionamiento vinculado a reservas. Este modelo de aprovisionamiento te permite crear máquinas virtuales A4X, A4 o A3 Ultra consumiendo capacidad reservada previamente.

Para ver otros métodos para crear VMs mediante el modelo de aprovisionamiento vinculado a reservas, consulta el artículo Descripción general de las opciones de implementación en la documentación de AI Hypercomputer.

Antes de empezar

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

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

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

     gcloud init

     Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

     Nota: Si ya has instalado la CLI de gcloud, asegúrate de que tienes la versión más reciente ejecutando gcloud components update.
  2. Set a default region and zone.

  REST

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

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

  gcloud init

  Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

  Nota: Si ya has instalado la CLI de gcloud, asegúrate de que tienes la versión más reciente ejecutando gcloud components update.

  Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

Roles obligatorios

Para obtener los permisos que necesitas para crear VMs mediante el modelo de aprovisionamiento vinculado a reservas, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de instancias de Compute (v. 1) (roles/compute.instanceAdmin.v1) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para crear VMs mediante el modelo de aprovisionamiento vinculado a reservas. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

Permisos obligatorios

Se necesitan los siguientes permisos para crear VMs mediante el modelo de aprovisionamiento vinculado a reservas:

• compute.instances.create del proyecto
• Para usar una imagen personalizada para crear la VM, sigue estos pasos: compute.images.useReadOnly en la imagen
• Para usar una captura para crear la VM, sigue estos pasos: compute.snapshots.useReadOnly en la captura
• Para usar una plantilla de instancia para crear la VM, haz lo siguiente: compute.instanceTemplates.useReadOnly en la plantilla de instancia
• Para especificar una subred para tu VM, haz lo siguiente: compute.subnetworks.use en el proyecto o en la subred elegida
• Para especificar una dirección IP estática para la máquina virtual, haz lo siguiente: compute.addresses.use en el proyecto
• Para asignar una dirección IP externa a la VM cuando se usa una red de VPC, sigue estos pasos: compute.subnetworks.useExternalIp en el proyecto o en la subred elegida
• Para asignar una red antigua a la VM, sigue estos pasos: compute.networks.use en el proyecto
• Para asignar una dirección IP externa a la VM cuando se usa una red antigua, haz lo siguiente: compute.networks.useExternalIp en el proyecto
• Para definir los metadatos de la instancia de VM: compute.instances.setMetadata en el proyecto
• Para definir etiquetas en la VM, haz lo siguiente: compute.instances.setTags en la VM
• Para definir etiquetas en la VM, sigue estos pasos: compute.instances.setLabels en la VM
• Para definir una cuenta de servicio que pueda usar la VM, sigue estos pasos: compute.instances.setServiceAccount en la VM
• Para crear un disco para la VM, sigue estos pasos: compute.disks.create en el proyecto
• Para adjuntar un disco en modo de solo lectura o de lectura y escritura, sigue estos pasos: compute.disks.use en el disco
• Para adjuntar un disco en modo de solo lectura, sigue estos pasos: compute.disks.useReadOnly en el disco

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

Crear una VM que use el modelo de aprovisionamiento vinculado a la reserva

Para crear una VM A4X, A4 o A3 Ultra mediante el modelo de aprovisionamiento enlazado a reservas, debes esperar a que la reserva automática que quieras usar alcance su hora de inicio. Además, la VM que quieras crear debe cumplir todos los requisitos que se indican a continuación:

• La máquina virtual y la reserva deben tener propiedades coincidentes.

• La VM debe orientarse específicamente a la reserva para su consumo.

• La VM debe detenerse o eliminarse a la hora de finalización de la reserva.

En el siguiente ejemplo, se crea una solicitud de reserva futura en modo de calendario para cinco máquinas virtuales A3 Ultra y, a continuación, se crea una máquina virtual A3 Ultra consumiendo la reserva creada automáticamente para la solicitud.

Para crear una VM de ejemplo mediante el modelo de aprovisionamiento vinculado a la reserva, selecciona una de las siguientes opciones:

Consola

1. Crea una solicitud de ejemplo de cinco máquinas virtuales A3 Ultra y envíala para que se revise:

   1. En la Google Cloud consola, 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. Se abrirá la página Crear una reserva futura.

   4. En la sección Configuración de hardware, selecciona Especificar tipo de máquina y, a continuación, especifica una instancia A3 Ultra.

   5. En la sección Método de obtención, sigue estos pasos:

      1. Selecciona Buscar capacidad durante un máximo de 90 días.

      2. En las listas Región y Zona, especifica la región y la zona en las que quieres reservar recursos. En este ejemplo, selecciona us-central1 y us-central1-a respectivamente.

      3. En el campo Capacidad total necesaria, introduce 5.

      4. En la sección Periodo de reserva, especifica el periodo de reserva.

   6. Especifica los campos restantes y haz clic en Enviar.

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

   Importante: En los pasos siguientes se explica cómo crear una VM A3 Ultra con una sola NIC, lo que resulta útil para hacer pruebas rápidas. Para crear una VM A3 Ultra con varias NICs, consulta el artículo sobre cómo crear 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, introduce un nombre para la VM. En este ejemplo, introduce example-vm.

   3. Especifica la región y la zona en las que quieras reservar recursos. En este ejemplo, selecciona us-central1 y us-central1-a respectivamente.

   4. Haz clic en la pestaña GPUs (GPUs) y, a continuación, en la lista GPU type (Tipo de GPU), selecciona NVIDIA H200 141GB. Esta acción especifica una VM A3 Ultra y define el modelo de aprovisionamiento como Vinculado a reserva.

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

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

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

      1. Selecciona una reserva específica. Si quieres usar una reserva compartida que esté en otro proyecto, selecciona el proyecto en el que se encuentre la reserva en la lista Proyecto.

      2. Haz clic en Elegir.

   8. En la sección Modelo de aprovisionamiento, despliega la sección Configuración avanzada del modelo de aprovisionamiento de VMs.

   9. En la lista Al finalizar la VM, selecciona Detener (opción predeterminada) o Eliminar.

   10. Haz clic en Crear.

gcloud

1. Para crear una solicitud de ejemplo de cinco máquinas virtuales A3 Ultra y enviarla para que se revise, usa el comando gcloud beta compute future-reservations create:

   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-type=local \
       --start-time=2025-10-05T00:00:00Z \
       --end-time=2025-10-19T00:00:00Z \
       --machine-type=a3-ultragpu-8g \
       --total-count=5 \
       --zone=us-central1-a
   

   Supongamos que Google Cloud aprueba la solicitud y que Compute Engine crea automáticamente una reserva vacía. A la hora de inicio de la solicitud, el 5 de octubre del 2025, Compute Engine aumenta el número de VMs con GPU reservadas en la reserva. Después, puedes usar la reserva.

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

   • La bandera de --instance-termination-action.

   • La marca --provisioning-model se ha definido como RESERVATION_BOUND.

   • La bandera de --reservation.

   • La marca --reservation-affinity se ha definido como specific.

   El comando es similar al siguiente. Para consultar todos los requisitos para crear una VM A3 Ultra, consulta Crear una instancia A3 Ultra o A4.

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

   El comando incluye los siguientes valores:

   • TERMINATION_ACTION: indica si Compute Engine detiene (STOP) o elimina (DELETE) la VM al final del periodo de reserva.

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

     • Si la reserva creada automáticamente existe en tu proyecto, haz lo siguiente: example-reservation.

     • Si la reserva creada automáticamente está en otro proyecto: projects/PROJECT_ID/reservations/example-reservation.

REST

1. Para crear una solicitud de ejemplo de cinco máquinas virtuales A3 Ultra y enviarla para que se revise, haz una solicitud POST al método beta futureReservations.insert:

   POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/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": "2025-10-05T00:00:00Z",
       "endTime": "2025-10-19T00:00:00Z"
     }
   }
   

   Supongamos que Google Cloud aprueba la solicitud y que Compute Engine crea automáticamente una reserva vacía. A la hora de inicio de la solicitud, el 5 de octubre del 2025, Compute Engine aumenta el número de VMs con GPU reservadas en la reserva. Después, puedes usar la reserva.

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

   • El campo reservationAffinity.consumeReservationType tiene el valor SPECIFIC_RESERVATION.

   • El campo reservationAffinity.key tiene el valor compute.googleapis.com/reservation-name.

   • El campo reservationAffinity.values se ha definido en la URL de la reserva.

   • El campo scheduling.instanceTerminationAction.

   • El campo scheduling.provisioningModel se ha definido como RESERVATION_BOUND.

   La solicitud es similar a la siguiente. Para consultar todos los requisitos para crear una VM A3 Ultra, consulta Crear una instancia A3 Ultra o A4.

   POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/instances
   
   {
     {
       "machineType": "projects/example-project/zones/us-central1-a/machineTypes/a3-ultragpu-8g",
       "name": "example-vm",
       "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: la URL de la reserva, que tiene el siguiente formato:

     • Si la reserva creada automáticamente existe en tu proyecto, haz lo siguiente: example-reservation.

     • Si la reserva creada automáticamente está en otro proyecto: projects/PROJECT_ID/reservations/example-reservation.

   • TERMINATION_ACTION: indica si Compute Engine detiene (STOP) o elimina (DELETE) la VM al final del periodo de reserva.

Siguientes pasos

• Conéctate a tu VM

• Ejecutar secuencias de comandos de apagado

• Plantillas de instancias

• Detener o reiniciar una máquina virtual

Pruébalo

Si es la primera vez que utilizas Google Cloud, crea una cuenta para evaluar el rendimiento de Compute Engine en situaciones reales. Los nuevos clientes también reciben 300 USD en crédito gratuito para ejecutar, probar y desplegar cargas de trabajo.

Probar Compute Engine gratis