Se usó la API de Cloud Translation para traducir esta página.

Crea una VM que use el modelo vinculado a la reserva

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

Para conocer otros métodos para crear VMs 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 servicios y las APIs de Google Cloud . Para ejecutar código o muestras 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 Google Cloud CLI ejecutando el siguiente comando:
  gcloud init
  Si usas un proveedor de identidad externo (IdP), 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; para ello, ejecuta gcloud components update.
2. Set a default region and zone.
REST

Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a gcloud CLI.
Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .

Roles requeridos

Para obtener los permisos que necesitas para crear VMs con el modelo de aprovisionamiento vinculado a la reserva, pídele a tu 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 VMs 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 VMs 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, ejecuta compute.networks.use en el proyecto.
Para asignar una dirección IP externa a la VM cuando se usa una red heredada, ejecuta 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 con otros roles predefinidos.

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

Para crear una VM A4X, A4 o A3 Ultra con el modelo de aprovisionamiento vinculado a la reserva, debes esperar hasta que la reserva automática que deseas usar alcance su hora de inicio. Además, la VM que deseas crear debe cumplir con todos los siguientes requisitos:

La VM y la reserva deben tener propiedades coincidentes.
La VM debe orientarse específicamente a la reserva para consumirla.
La VM 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 modo de calendario para cinco VMs A3 Ultra y, luego, se crea una VM A3 Ultra consumiendo la reserva creada automáticamente para la solicitud.

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

Console

Crea una solicitud de ejemplo para cinco VMs A3 Ultra y envíala para su revisión:
1. En la consola de Google Cloud , 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. En la sección Configuración de hardware, selecciona Especificar tipo de máquina y, luego, especifica una instancia de A3 Ultra.
5. En la sección Método de obtención, completa los siguientes pasos:
  1. Selecciona Buscar capacidad para hasta 90 días.
  2. En las listas Región y Zona, especifica la región y la zona en las que se reservarán los recursos. Para este ejemplo, selecciona us-central1 y us-central1-a, respectivamente.
  3. En el campo Capacidad total necesaria, ingresa 5.
  4. En la sección Período de reserva, especifica el período de reserva.
6. Especifica los campos restantes y, luego, haz clic en Enviar.
En la hora de inicio de la solicitud, para crear una VM A3 Ultra que consuma la reserva de ejemplo creada de forma automática, haz lo siguiente:

Importante: En los siguientes pasos, se muestra cómo crear una VM A3 Ultra con una sola NIC, lo que resulta útil para realizar pruebas rápidas. Para crear una VM A3 Ultra con varias NIC, consulta Crea una instancia A3 Ultra o A4.
1. En la consola de Google Cloud , ve a la página Crear una instancia.
  
  Ir a Crear una instancia
2. En el campo Nombre, ingresa un nombre para la VM. En este ejemplo, ingresa example-vm.
3. Especifica la región y la zona en las que deseas reservar los recursos. Para este ejemplo, selecciona us-central1 y us-central1-a, respectivamente.
4. Haz clic en la pestaña GPUs y, luego, en la lista Tipo de GPU, selecciona NVIDIA H200 141 GB. Esta acción especifica una VM 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 reserva.
7. En el panel Elige una reserva, haz lo siguiente:
  1. Selecciona una reserva específica. Si deseas consumir una reserva compartida que existe en un proyecto diferente, en la lista Proyecto, selecciona el proyecto en el que existe la reserva.
  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 VMs.
9. En la lista Finalización de VM, selecciona Detener (predeterminado) o Borrar.
10. Haz clic en Crear.

gcloud

Para crear una solicitud de ejemplo de cinco VMs A3 Ultra y enviarla para su revisión, 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 Compute Engine crea automáticamente una reserva vacía. A la hora de inicio de la solicitud, el 5 de octubre de 2025, Compute Engine aumenta la cantidad de VMs con GPU reservadas en la reserva. Luego, puedes consumir la reserva.

En la hora de inicio de la solicitud, para crear una VM de A3 Ultra y consumir la reserva de ejemplo creada automáticamente, usa el comando gcloud compute instances create 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 todos los requisitos para crear una VM A3 Ultra, consulta Crea 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 borra (DELETE) la VM al final del período de reserva.
- RESERVATION_URL: Es la URL de la reserva, con el siguiente formato:
  - Si la reserva creada automáticamente existe en tu proyecto, example-reservation.
  - Si la reserva creada automáticamente existe en un proyecto diferente, usa projects/PROJECT_ID/reservations/example-reservation.

REST

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

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"
  }
}

En la hora de inicio de la solicitud, para crear una VM de A3 Ultra que consuma la reserva de ejemplo creada de forma automática, realiza una solicitud POST al método instances.insert. 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 en 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 todos los requisitos para crear una VM A3 Ultra, consulta Crea 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: Es la URL de la reserva, con el siguiente formato:
  - Si la reserva creada automáticamente existe en tu proyecto, example-reservation.
  - Si la reserva creada automáticamente existe en un proyecto diferente, usa projects/PROJECT_ID/reservations/example-reservation.
- TERMINATION_ACTION: Indica si Compute Engine detiene (STOP) o borra (DELETE) la VM al final del período de reserva.

¿Qué sigue?

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 y, además, implementar cargas de trabajo.

Probar Compute Engine gratis

Crea una VM que use el modelo vinculado a la reserva Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Antes de comenzar

Console

gcloud

REST

Roles requeridos

Permisos necesarios

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

Console

gcloud

REST

¿Qué sigue?

Pruébalo tú mismo

Crea una VM que use el modelo vinculado a la reserva