Crea solicitudes de reserva futuras compartidas

En este documento, se explica cómo crear solicitudes de reserva futuras compartidas.

Si Google Cloud aprueba tu solicitud de reserva futura compartida, en la hora de inicio especificado en tu solicitud, Compute Engine crea automáticamente reservas que se comparten en varios proyectos. Estas reservas compartidas creadas automáticamente se consumen con las VMs coincidentes y las reservas existentes en el proyecto que aloja la reserva futura (proyecto de propietario) y los proyectos con los que se comparte la reserva futura (proyectos de consumidor). Para obtener más información acerca de cómo funcionan las reservas compartidas creadas automáticamente y cómo se pueden utilizar, consulta Crea reservas compartidas.

Antes de comenzar

  • Si aún no lo hiciste, completa estos pasos:
  • Configura la autenticación si aún no lo hiciste. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API de Google Cloud. Para ejecutar un código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera.

    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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. 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 proporcionas a la CLI de gcloud.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Si deseas obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud.

Roles obligatorios

Para obtener los permisos que necesitas para crear solicitudes de reserva futuras compartidas, pídele a tu administrador que te otorgue la función de IAM deUsuario de reserva futura de Compute (roles/compute.futureReservationUser) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Esta función predefinida contiene los permisos necesarios para crear solicitudes de reserva futuras compartidas. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para crear solicitudes de reserva futuras compartidas:

  • Para crear una solicitud de reserva futura, usa compute.futureReservations.create en el proyecto.
  • Para permitir que Compute Engine cree reservas de forma automática: compute.reservations.create en el proyecto
  • Para especificar una plantilla de instancias: usa compute.instanceTemplates.useReadOnly en la plantilla de instancias

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

Restricciones

Además de las restricciones generales para las reservas futuras, la creación de solicitudes de reserva futuras compartidas tiene las siguientes restricciones:

  • El proyecto que usas para crear solicitudes de reserva futuras compartidas (el proyecto propietario) debe agregarse a la lista de entidades permitidas de la organización Proyectos de propietario de las reservas compartidas (compute.sharedReservationsOwnerProjects). restricción de política por parte de un administrador de políticas de la organización. Para obtener más información, consulta Permite y restringe los proyectos para crear y cambiar reservas compartidas en la documentación de reservas de Compute Engine.

  • Si mueves un proyecto que creó una solicitud de reserva futura compartida a una organización diferente, se borrará la reserva futura compartida. El proyecto no se quita de forma automática de la restricción de la política de la organización Proyectos de propietario de las reservas compartidas (compute.sharedReservationsOwnerProjects), pero puedes quitarlo de esta restricción si lo deseas.

  • Cada solicitud de reserva futura compartida se puede compartir con hasta 100 proyectos de consumidor.

  • En cada organización, puedes crear hasta 100 solicitudes de reserva futuras contempladas para cada combinación única de propiedades de la VM.

Crea una solicitud de borrador

Cuando creas una solicitud de reserva futura, puedes guardarla como borrador y, luego, enviarla a Google Cloud para su revisión, o enviar directamente la solicitud para su revisión. Google recomienda crear primero una solicitud de borrador, ya que esto te permite determinar la cantidad de VMs que Compute Engine aprovisionará para tu solicitud en lugar de estimar esta cantidad de forma manual y, de manera opcional, modificar la cantidad de VMs reservadas en la solicitud antes de enviarla para su revisión.

Para utilizar una reserva creada automáticamente para una reserva futura, una VM debe tener propiedades que coincidan con exactitud con esa reserva. Para especificar las propiedades de las VMs que deseas solicitar a través de la creación de un borrador de solicitud de reserva futura, selecciona uno de los siguientes métodos:

  • Recomendado: especifica una plantilla de instancias

    Puedes usar una plantilla de instancias existente para definir las propiedades de un borrador de solicitud de reserva futura. a través de una plantilla de instancias, puedes definir las propiedades de una solicitud de reserva futura y las VMs que pueden utilizar las reservas creadas de forma automática en el mismo lugar. Sin embargo, debido a que las plantillas son específicas del proyecto, no puedes usar la misma plantilla para crear VMs que puedan utilizar las reservas creadas de forma automática fuera del proyecto que creó la solicitud de reserva futura. Para los proyectos con los que se comparte una reserva futura, debes crear plantillas similares o VMs a través de la especificación directa de las propiedades.

  • Especifica una VM existente

    Puedes usar una VM existente para definir las propiedades de una solicitud de reserva futura. Si usas las propiedades de una VM existente, puedes consumir las reservaciones creadas automáticamente aprovisionadas para la reserva futura creando VMs con propiedades que coincidan con la VM de referencia.

  • Especifica las propiedades directamente

    Puedes definir directamente las propiedades de un borrador de solicitud de reserva futura. Este método requiere que te asegures de forma manual de que las propiedades de las VMs y las reservas creadas de forma automática coincidan exactamente cualquier discrepancia impedirá su consumo.

Cualquier VM con propiedades coincidentes puede utilizar de forma automática una reserva creada de forma automática para una reserva futura. Si deseas evitar que una VM consuma alguna de estas reservas creadas de forma automática, consulta cómo crear VMs sin utilizar reservas.

Especifica una plantilla de instancias

Cuando crees una solicitud de reserva futura compartida mediante la especificación de una plantilla de instancias, ten en cuenta lo siguiente:

  • Una plantilla de instancias contiene una configuración específica del proyecto, por lo que solo puedes acceder a ella y usarla dentro del mismo proyecto. Si creas una solicitud de reserva futura compartida a través de la especificación de una plantilla de instancias, debes crear plantillas similares para crear VMs o crear VMs a través de la especificación directa de las propiedades coincidentes, para utilizar las reservas creadas de forma automática en cada consumidor.

  • Precaución: crea tu solicitud de reserva futura en la misma región y zona que los recursos dentro de la plantilla de instancias. Cualquier recurso zonal o regional que se especifique en una plantilla de instancias, como un tipo de máquina o Persistent Disk, restringe el uso de la plantilla a las ubicaciones en las que se ubiquen esos recursos. Por ejemplo, si tu plantilla de instancias especifica un Persistent Disk existente en la zona us-central1-a, debes crear tu solicitud de reserva futura en la misma zona. De lo contrario, la creación de la solicitud de reserva futura fallará.

    Para verificar si una plantilla existente especifica algún recurso que vincula la plantilla a una región o zona específica, consulta los detalles de la plantilla y busca referencias a recursos o zonales dentro.

  • Si deseas adjuntar las reservas creadas de forma automática aprovisionadas para una reserva futura a un compromiso, debes inhabilitar la opción de eliminación automática. Para obtener más información, consulta Restricciones después de la creación.

Después de crear una solicitud de reserva futura, no puedes modificarla para anular las propiedades de la VM de la plantilla ni especificar otra plantilla. En su lugar, si necesitas cambiar las propiedades de la VM especificadas en la solicitud, debes crear una solicitud de reserva futura nueva.

Para crear una reserva futura compartida a través de la especificación de una plantilla de instancias existente, elige una de las siguientes opciones:

Console

  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.

    Se abrirá la página Crear una reserva futura.

  4. En Nombre, ingresa un nombre para tu solicitud de reserva futura.

  5. En Prefijo, ingresa un prefijo de nombre. El nombre de cada reserva creada de forma automática de esta solicitud de reserva futura comienza con este prefijo.

  6. En Región y Zona, selecciona la región y la zona en las que deseas reservar los recursos.

  7. En Hora de inicio, ingresa una hora de inicio para el período de la reserva. La hora de inicio no puede ser posterior a un año a partir de la fecha y hora en que envías una solicitud de reserva futura para su revisión. Para tener tiempo suficiente para modificar, cancelar o borrar la reserva futura de forma opcional antes de que ingrese a la hora de bloqueo, especifica un valor recomendado para la hora de inicio.

  8. En Hora de finalización, ingresa una hora de finalización para el período de la reserva. El período de reserva debe durar al menos 24 horas.

    En la sección Resumen de la duración, puedes ver la duración del período de reserva. Para aumentar la probabilidad de que Google Cloud apruebe tu solicitud de reserva futura después de enviarla para su revisión, asegúrate de especificar un valor recomendado para el período de reserva.

  9. En la sección Tipo de fuente, haz lo siguiente:

    1. Para especificar una solicitud de reserva futura compartida, selecciona Compartido.

    2. Haz clic en Agregar proyectos y selecciona los proyectos de la organización actual del proyecto con el que quieres compartir la solicitud de reserva futura. Puedes seleccionar hasta 100 proyectos.

  10. En Cantidad de instancias de VM, ingresa el recuento total de VMs que deseas reservar para el período, la configuración de VM y los proyectos especificados en esta solicitud de reserva futura.

  11. En la sección Configuración de la máquina, haz lo siguiente:

    1. Selecciona Usar plantilla de instancias.

    2. En Plantilla de instancias, selecciona la plantilla que prefieras. Si seleccionas una plantilla de instancias regional, solo puedes reservar recursos dentro de la misma región que la región de la plantilla.

  12. En la sección Tiempo de eliminación automática de reservas generadas de forma automática, realiza una de las siguientes acciones:

    • Para permitir que se borren de forma automática las reservas creadas de forma automática en tu solicitud de reserva futura con Compute Engine, haz lo siguiente:

      1. Haz clic en el botón de activación Habilitar eliminación automática para llevarlo a la posición activada si aún no está configurado.

      2. Opcional: En Hora de eliminación automática, ingresa una fecha y hora nuevas para borrar las reservas creadas de forma automática. La fecha y la hora deben ser posteriores a la hora de finalización del período de reserva. Si dejas este campo vacío, las reservas creadas de forma automática se borran en un plazo de dos horas después de la hora de finalización del período de reserva.

    • De lo contrario, haz clic en el botón de activación Habilitar eliminación automática para llevarlo a la posición desactivada.

  13. Para terminar de crear el borrador de la solicitud de reserva futura, haz clic en Guardar borrador.

Se abrirá la página Reservas. La creación de la solicitud de reserva futura puede tardar hasta un minuto en completarse.

gcloud

Para crear una solicitud de reserva futura compartida a través de la especificación de una plantilla de instancias, usa el comando gcloud beta compute future-reservations create con las marcas --share-setting=projects y --share-with.

Para crear un borrador de una solicitud de reserva futura con la especificación de una plantilla de instancias sin incluir marcas opcionales y borrar automáticamente la reserva creada de forma automática al final del período de reserva, ejecuta el siguiente comando:

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Reemplaza lo siguiente:

  • FUTURE_RESERVATION_NAME: Es el nombre de la solicitud de reserva futura.

  • MACHINE_TYPE: Es el nuevo tipo de máquina que se usará para cada VM reservada.

  • CONSUMER_PROJECT_IDS: Es una lista separada por comas de los IDs de los proyectos en los que deseas permitir que se consuman las reservas creadas automáticamente para esta solicitud de reserva futura, por ejemplo, project-1,project-2. Puedes especificar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto en el que se creó esta solicitud de reserva futura (el proyecto propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se pueden utilizar las reservas creadas de forma automática para esta solicitud de reserva futura.

  • PROJECT_ID: el ID del proyecto en el que deseas reservar los recursos y donde se encuentra la plantilla de instancias.

  • LOCATION: la ubicación de la plantilla de instancias. Especifica uno de los siguientes valores:

    • Para una plantilla de instancias regional: regions/REGION. Reemplaza REGION por la región en la que se encuentra la plantilla de instancias. Si especificas una plantilla de instancias regional, solo puedes crear la solicitud de reserva futura dentro de la misma región que la región de la plantilla.

    • Para una plantilla de instancias global: global.

  • INSTANCE_TEMPLATE_NAME: Es nombre de una plantilla de instancias existente.

  • START_TIME: La hora de inicio del período de reserva como una marca de tiempo RFC 3339, que debe tener el siguiente formato:

    YYYY-MM-DDTHH:MM:SSOFFSET

    Reemplaza lo siguiente:

    • YYYY-MM-DD: una fecha con formato de un año de 4 dígitos, un mes de 2 dígitos y un día de 2 dígitos del mes separado por guiones (-)

    • HH:MM:SS: una hora con formato de hora de 2 dígitos con un formato de 24 horas, minutos de 2 dígitos y segundos de 2 dígitos separados por dos puntos (:)

    • OFFSET: la zona horaria con formato como una compensación del horario universal coordinado (UTC). Por ejemplo, para usar la hora estándar del Pacífico (PST), especifica -08:00. Como alternativa, para no usar compensación, especifica Z.

    La hora de inicio no puede ser posterior a un año a partir de la fecha y hora en que envías una solicitud de reserva futura para su revisión. Para tener tiempo suficiente para cancelar, borrar o modificar una solicitud de reserva futura después de que se apruebe y antes de que ingrese a la hora de bloqueo, especifica un valor recomendado para la hora de inicio.

  • END_TIME: La hora de finalización del período de reserva con un formato de marca de tiempo RFC 3339. El período de reserva debe durar al menos 24 horas. Como alternativa, puedes reemplazar la marca --end-time por la marca --duration=END_DURATION. Reemplaza END_DURATION por la duración del período de reserva en segundos. Por ejemplo, especifica 1209600 para 1,209,600 segundos (14 días).

    Para aumentar la probabilidad de que Google Cloud apruebe una solicitud de reserva futura después de enviarla para su revisión, especifica una duración mínima recomendada.

  • TOTAL_COUNT: Es el registro total de las VMs que deseas reservar.

  • ZONE: Es la zona en la que se reservarán los recursos.

Por ejemplo, supongamos que deseas crear un borrador de solicitud de reserva futura con el nombre fr-02 en la zona us-central1-a con las siguientes propiedades:

  • Un período de reserva que comienza a la medianoche del 10 de noviembre de 2024 a UTC y finaliza a la medianoche del 10 de diciembre de 2024 a UTC.

  • Un recuento total de 80 VMs.

  • Una plantilla de instancias regional de la región us-central1.
  • La opción de eliminación automática está habilitada. Las reservas creadas de forma automática se borran al final del período de reserva.
  • La solicitud de reserva futura se comparte con project-1 y project-2.

Para crear fr-02, ejecuta el siguiente comando:

gcloud beta compute future-reservations create fr-02 \
    --auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --source-instance-template=projects/example-project/regions/us-central1/instanceTemplates/example-template \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

De manera opcional, puedes hacer una o más de las siguientes acciones:

  • Para borrar las reservas creadas de forma automática después de la hora de finalización del período de reserva, selecciona uno de los siguientes métodos:

    • Para borrar las reservas creadas de forma automática en una fecha y hora específicas después de la hora de finalización del período de reserva, incluye la marca --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

      Reemplaza AUTO_CREATED_RESERVATIONS_DELETE_TIME por una fecha y hora con formato de marca de tiempo RFC 3339.

    • Para borrar las reservas creadas de forma automática después de una duración específica posterior a la hora de finalización del período de reserva, incluye la marca --auto-created-reservations-duration.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

      Reemplaza DURATION_BEFORE_DELETE por una duración en días, horas, minutos o segundos. Por ejemplo, especifica 30m para 30 minutos o 1d2h3m4s para un día, dos horas, tres minutos y cuatro segundos.

  • Para inhabilitar la opción de eliminación automática de las reservas creadas de forma automática, reemplaza la marca --auto-delete-auto-created-reservations por la marca --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

  • Para especificar un prefijo de nombre para las reservas creadas de forma automática, incluye la marca --name-prefix.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --name-prefix=NAME_PREFIX \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Reemplaza NAME_PREFIX por el prefijo del nombre de cada reserva creada de forma automática. Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, Google Cloud recomienda especificar un prefijo de nombre único.

REST

Para crear una solicitud de reserva futura compartida a través de la especificación de una plantilla de instancias, realiza una solicitud POST al método beta.futureReservations.insert.

Para crear un borrador de una solicitud de reserva futura mediante la especificación de una plantilla de instancias sin incluir campos opcionales, realiza una solicitud POST de la siguiente manera:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto en el que deseas reservar los recursos y donde se encuentra la plantilla de instancias.

  • ZONE: Es la zona en la que se reservarán los recursos.

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Si configuras este campo como true, Compute Engine borrará automáticamente las reservas creadas de forma automática para esta reserva futura en un plazo de dos horas a partir de la hora de finalización del período de reserva. Si deseas adjuntar tus reservas creadas de forma automática a un compromiso, establece este campo en false.

  • CONSUMER_PROJECT_ID_1 y CONSUMER_PROJECT_ID_2: Los IDs de los proyectos con los que se puede compartir esta solicitud de reserva futura. Puedes especificar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto en el que se creó esta solicitud de reserva futura (el proyecto propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se pueden utilizar las reservas creadas de forma automática para esta solicitud de reserva futura.

  • LOCATION: la ubicación de la plantilla de instancias. Especifica uno de los siguientes valores:

    • Para una plantilla de instancias regional: regions/REGION. Reemplaza REGION por la región en la que se encuentra la plantilla de instancias. Si especificas una plantilla de instancias regional, solo puedes crear la solicitud de reserva futura dentro de la misma región que la región de la plantilla.

    • Para una plantilla de instancias global: global.

  • INSTANCE_TEMPLATE_NAME: Es nombre de una plantilla de instancias existente.

  • TOTAL_COUNT: Es el recuento total de las VMs que deseas reservar.

  • START_TIME: La hora de inicio del período de reserva como una marca de tiempo RFC 3339, que debe tener el siguiente formato:

    YYYY-MM-DDTHH:MM:SSOFFSET

    Reemplaza lo siguiente:

    • YYYY-MM-DD: una fecha con formato de un año de 4 dígitos, un mes de 2 dígitos y un día de 2 dígitos del mes separado por guiones (-)

    • HH:MM:SS: una hora con formato de hora de 2 dígitos con un formato de 24 horas, minutos de 2 dígitos y segundos de 2 dígitos separados por dos puntos (:)

    • OFFSET: la zona horaria con formato como una compensación del horario universal coordinado (UTC). Por ejemplo, para usar la hora estándar del Pacífico (PST), especifica -08:00. Como alternativa, para no usar compensación, especifica Z.

    La hora de inicio no puede ser posterior a un año a partir de la fecha y hora en que envías una solicitud de reserva futura para su revisión. Para tener tiempo suficiente para cancelar, borrar o modificar una solicitud de reserva futura después de que se apruebe y antes de que ingrese a la hora de bloqueo, especifica un valor recomendado para la hora de inicio.

  • END_TIME: La hora de finalización del período de reserva con un formato de marca de tiempo RFC 3339. El período de reserva debe durar al menos 24 horas. Como alternativa, puedes reemplazar el campo endTime por el campo duration para especificar una duración específica desde la hora de inicio del período de reserva:

    "duration": {
  "seconds": END_DURATION
}

    Reemplaza END_DURATION por una duración en segundos. Por ejemplo, especifica 1209600 para 1,209,600 segundos (14 días).

    Para aumentar la probabilidad de que a través de Google Cloud se apruebe una solicitud de reserva futura después de enviarla para su revisión, asegúrate de especificar uno de los valores recomendados para el período de la reserva.

Por ejemplo, supongamos que deseas crear un borrador de solicitud de reserva futura con el nombre fr-02 en la zona us-central1-a con las siguientes propiedades:

  • Un período de reserva que comienza a la medianoche del 10 de noviembre de 2024 a UTC y finaliza a la medianoche del 10 de diciembre de 2024 a UTC.

  • Un recuento total de 80 VMs.

  • Una plantilla de instancias regional de la región us-central1.
  • La opción de eliminación automática está habilitada. Las reservas creadas de forma automática se borran al final del período de reserva.
  • La solicitud de reserva futura se comparte con project-1 y project-2.

Para modificar fr-02, realiza una solicitud POST de la siguiente manera:

POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-02",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/example-project/regions/us-central1/instanceTemplates/example-template",
    "totalCount": 80
  },
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

De manera opcional, puedes hacer una o más de las siguientes acciones:

  • Para especificar un prefijo de nombre para las reservas creadas de forma automática, incluye el campo namePrefix.

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Reemplaza NAME_PREFIX por el prefijo del nombre de cada reserva creada de forma automática. Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, Google Cloud recomienda especificar un prefijo de nombre único.

  • Para borrar las reservas creadas de forma automática después de la hora de finalización del período de reserva, selecciona uno de los siguientes métodos:

    • Para borrar las reservas creadas de forma automática en un momento específico después del final de tu período de reserva, configura autoDeleteAutoCreatedReservations como true y especifica el campo autoCreatedReservationsDeleteTime.

      POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

      Reemplaza DELETE_TIME por una fecha y hora en la que Compute Engine borre las reservas creadas de forma automática. La fecha y la hora deben tener el formato de una marca de tiempo RFC 3339.

    • Para borrar las reservas creadas de forma automática después de una duración específica desde la hora de inicio del período de reserva, configura autoDeleteAutoCreatedReservations como true y especifica el campo autoCreatedReservationsDuration.

      POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

      Reemplaza DURATION_BEFORE_DELETE por una duración en segundos. Por ejemplo, especifica 604800 para 604,800 segundos (7 días).

Después de crear un borrador de solicitud de reserva futura, puedes determinar la cantidad de VMs que Compute Engine aprovisionará para la solicitud.

Especifica una VM existente

Solo puedes crear un borrador de solicitud de reserva futura basado en una VM existente en el mismo proyecto y zona que la VM.

Después de que Google Cloud apruebe la solicitud de reserva futura y esta entre en su período de reserva, puedes consumir sus reservas creadas de forma automática. Para ello, crea VMs con propiedades que coincidan con la VM de referencia. Para ello, puedes optar por cualquiera de las siguientes opciones:

  • Crea y usa una plantilla de instancias de la siguiente manera:

    1. Crea una plantilla de instancias basada en la VM de referencia sin anular las propiedades de la VM de referencia.

    2. Para crear VMs con la plantilla recién creada, haz una de las siguientes acciones o ambas:

  • Crea una VM con propiedades que coincidan de forma exacta con la VM de referencia de la siguiente manera:

    • En el proyecto del propietario, crea una VM basada en la VM de referencia sin cambiar las propiedades de la VM que estás creando.

    • En los proyectos de consumidor, crea una VM y asegúrate de forma manual de que sus propiedades y las de la VM de referencia coincidan.

Para crear una solicitud de reserva futura compartida que use las propiedades de una VM existente, haz lo siguiente:

  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.

    Se abrirá la página Crear una reserva futura.

  4. En Nombre, ingresa un nombre para tu solicitud de reserva futura.

  5. En Prefijo, ingresa un prefijo de nombre. El nombre de cada reserva creada de forma automática de esta solicitud de reserva futura comienza con este prefijo.

  6. En Región y Zona, selecciona la región y la zona en las que deseas reservar los recursos.

  7. En Hora de inicio, ingresa una hora de inicio para el período de la reserva. La hora de inicio no puede ser posterior a un año a partir de la fecha y hora en que envías una solicitud de reserva futura para su revisión. Para tener tiempo suficiente para modificar, cancelar o borrar la reserva futura de forma opcional antes de que ingrese a la hora de bloqueo, especifica un valor recomendado para la hora de inicio.

  8. En Hora de finalización, ingresa una hora de finalización para el período de la reserva. El período de reserva debe durar al menos 24 horas.

    En la sección Resumen de la duración, puedes ver la duración del período de reserva. Para aumentar la probabilidad de que Google Cloud apruebe tu solicitud de reserva futura después de enviarla para su revisión, asegúrate de especificar un valor recomendado para el período de reserva.

  9. En la sección Tipo de fuente, haz lo siguiente:

    1. Para especificar una solicitud de reserva futura compartida, selecciona Compartido.

    2. Haz clic en Agregar proyectos y selecciona los proyectos de la organización actual del proyecto con el que quieres compartir la solicitud de reserva futura. Puedes seleccionar hasta 100 proyectos.

  10. En Cantidad de instancias de VM, ingresa el recuento total de VMs que deseas reservar para el período, la configuración de VM y los proyectos especificados en esta solicitud de reserva futura.

  11. En la sección Configuración de la máquina, haz lo siguiente:

    1. Selecciona Usar VM existente.

    2. En VM existente, selecciona la VM cuyas propiedades deseas usar para crear la reserva.

  12. En la sección Tiempo de eliminación automática de reservas generadas de forma automática, realiza una de las siguientes acciones:

    • Para permitir que se borren de forma automática las reservas creadas de forma automática en tu solicitud de reserva futura con Compute Engine, haz lo siguiente:

      1. Haz clic en el botón de activación Habilitar eliminación automática para llevarlo a la posición activada si aún no está configurado.

      2. Opcional: En Hora de eliminación automática, ingresa una fecha y hora nuevas para borrar las reservas creadas de forma automática. La fecha y la hora deben ser posteriores a la hora de finalización del período de reserva. Si dejas este campo vacío, las reservas creadas de forma automática se borran en un plazo de dos horas después de la hora de finalización del período de reserva.

    • De lo contrario, haz clic en el botón de activación Habilitar eliminación automática para llevarlo a la posición desactivada.

  13. Para terminar de crear el borrador de la solicitud de reserva futura, haz clic en Guardar borrador.

Se abrirá la página Reservas. La creación de la solicitud de reserva futura puede tomar hasta un minuto en completarse.

Después de crear un borrador de solicitud de reserva futura, puedes determinar la cantidad de VMs que Compute Engine aprovisionará para la solicitud.

Especifica las propiedades directamente

Si deseas adjuntar las reservas creadas de forma automática aprovisionadas para una reserva futura a un compromiso, debes inhabilitar la opción de eliminación automática. Para obtener más información, consulta Restricciones después de la creación.

Para crear una solicitud de reserva futura compartida a través de la especificación directa de las propiedades, selecciona una de las siguientes opciones:

Console

  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.

    Se abrirá la página Crear una reserva futura.

  4. En Nombre, ingresa un nombre para tu solicitud de reserva futura.

  5. En Prefijo, ingresa un prefijo de nombre. El nombre de cada reserva creada de forma automática de esta solicitud de reserva futura comienza con este prefijo.

  6. En Región y Zona, selecciona la región y la zona en las que deseas reservar los recursos.

  7. En Hora de inicio, ingresa una hora de inicio para el período de la reserva. La hora de inicio no puede ser posterior a un año a partir de la fecha y hora en que envías una solicitud de reserva futura para su revisión. Para tener tiempo suficiente para modificar, cancelar o borrar la reserva futura de forma opcional antes de que ingrese a la hora de bloqueo, especifica un valor recomendado para la hora de inicio.

  8. En Hora de finalización, ingresa una hora de finalización para el período de la reserva. El período de reserva debe durar al menos 24 horas.

    En la sección Resumen de la duración, puedes ver la duración del período de reserva. Para aumentar la probabilidad de que Google Cloud apruebe tu solicitud de reserva futura después de enviarla para su revisión, asegúrate de especificar un valor recomendado para el período de reserva.

  9. En la sección Tipo de fuente, haz lo siguiente:

    1. Para especificar una solicitud de reserva futura compartida, selecciona Compartido.

    2. Haz clic en Agregar proyectos y selecciona los proyectos de la organización actual del proyecto con el que quieres compartir la solicitud de reserva futura. Puedes seleccionar hasta 100 proyectos.

  10. En Cantidad de instancias de VM, ingresa el recuento total de VMs que deseas reservar para el período, la configuración de VM y los proyectos especificados en esta solicitud de reserva futura.

  11. En la sección Configuración de la máquina, haz lo siguiente:

    1. Selecciona Especificar tipo de máquina si aún no está seleccionado.

    2. Especifica el tipo de máquina que se usará para las VMs reservadas.

  12. En la sección Tiempo de eliminación automática de reservas generadas de forma automática, realiza una de las siguientes acciones:

    • Para permitir que se borren de forma automática las reservas creadas de forma automática en tu solicitud de reserva futura con Compute Engine, haz lo siguiente:

      1. Haz clic en el botón de activación Habilitar eliminación automática para llevarlo a la posición activada si aún no está configurado.

      2. Opcional: En Hora de eliminación automática, ingresa una fecha y hora nuevas para borrar las reservas creadas de forma automática. La fecha y la hora deben ser posteriores a la hora de finalización del período de reserva. Si dejas este campo vacío, las reservas creadas de forma automática se borran en un plazo de dos horas después de la hora de finalización del período de reserva.

    • De lo contrario, haz clic en el botón de activación Habilitar eliminación automática para llevarlo a la posición desactivada.

  13. Para terminar de crear el borrador de la solicitud de reserva futura, haz clic en Guardar borrador.

Se abrirá la página Reservas. La creación de la solicitud de reserva futura puede tardar hasta un minuto en completarse.

gcloud

Para crear una solicitud de reserva futura compartida a través de la especificación directa de las propiedades, usa el comando gcloud beta compute future-reservations create con las marcas --share-setting=projects y --share-with.

Para crear un borrador de una solicitud de reserva futura mediante la especificación de propiedades directamente sin incluir marcas opcionales y borrar automáticamente la reserva creada de forma automática al final de el período de reserva, ejecuta el siguiente comando:

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Reemplaza lo siguiente:

  • FUTURE_RESERVATION_NAME: Es el nombre de la solicitud de reserva futura.

  • MACHINE_TYPE: Es el nuevo tipo de máquina que se usará para cada VM reservada.

  • CONSUMER_PROJECT_IDS: Es una lista separada por comas de los IDs de los proyectos en los que deseas permitir que se consuman las reservas creadas automáticamente para esta solicitud de reserva futura, por ejemplo, project-1,project-2. Puedes especificar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto en el que se creó esta solicitud de reserva futura (el proyecto propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se pueden utilizar las reservas creadas de forma automática para esta solicitud de reserva futura.

  • START_TIME: La hora de inicio del período de reserva como una marca de tiempo RFC 3339, que debe tener el siguiente formato:

    YYYY-MM-DDTHH:MM:SSOFFSET

    Reemplaza lo siguiente:

    • YYYY-MM-DD: una fecha con formato de un año de 4 dígitos, un mes de 2 dígitos y un día de 2 dígitos del mes separado por guiones (-)

    • HH:MM:SS: una hora con formato de hora de 2 dígitos con un formato de 24 horas, minutos de 2 dígitos y segundos de 2 dígitos separados por dos puntos (:)

    • OFFSET: la zona horaria con formato como una compensación del horario universal coordinado (UTC). Por ejemplo, para usar la hora estándar del Pacífico (PST), especifica -08:00. Como alternativa, para no usar compensación, especifica Z.

    La hora de inicio no puede ser posterior a un año a partir de la fecha y hora en que envías una solicitud de reserva futura para su revisión. Para tener tiempo suficiente para cancelar, borrar o modificar una solicitud de reserva futura después de que se apruebe y antes de que ingrese a la hora de bloqueo, especifica un valor recomendado para la hora de inicio.

  • END_TIME: La hora de finalización del período de reserva con un formato de marca de tiempo RFC 3339. El período de reserva debe durar al menos 24 horas. Como alternativa, puedes reemplazar la marca --end-time por la marca --duration=END_DURATION. Reemplaza END_DURATION por la duración del período de reserva en segundos. Por ejemplo, especifica 1209600 para 1,209,600 segundos (14 días).

    Para aumentar la probabilidad de que Google Cloud apruebe una solicitud de reserva futura después de enviarla para su revisión, especifica una duración mínima recomendada.

  • TOTAL_COUNT: Es el recuento total de las VMs que deseas reservar.

  • ZONE: Es la zona en la que se reservarán los recursos.

Por ejemplo, supongamos que deseas crear un borrador de solicitud de reserva futura con el nombre fr-02 en la zona us-central1-a con las siguientes propiedades:

  • Un período de reserva que comienza a la medianoche del 10 de noviembre de 2024 a UTC y finaliza a la medianoche del 10 de diciembre de 2024 a UTC.

  • Un recuento total de 80 VMs.

  • Un tipo predefinido de máquina N2 con 4 CPUs virtuales.
  • La opción de eliminación automática está habilitada. Las reservas creadas de forma automática se borran al final del período de reserva.
  • La solicitud de reserva futura se comparte con project-1 y project-2.

Para crear fr-02, ejecuta el siguiente comando:

gcloud beta compute future-reservations create fr-02 \
    --auto-delete-auto-created-reservations \
    --machine-type=n2-standard-4 \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

De manera opcional, puedes hacer una o más de las siguientes acciones:

  • Para adjuntar GPUs a tus VMs N1 reservadas, incluye la marca --accelerator.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --accelerator=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Reemplaza lo siguiente:

    • NUMBER_OF_ACCELERATORS: Es la cantidad de GPU que se agregará por VM reservada.

    • ACCELERATOR_TYPE: Un modelo de GPU compatible para las VMs N1. Para evitar errores, asegúrate de que el modelo de GPU que elegiste esté disponible en la zona en la que creas la solicitud de reserva futura.

  • Para borrar las reservas creadas de forma automática después de la hora de finalización del período de reserva, selecciona uno de los siguientes métodos:

    • Para borrar las reservas creadas de forma automática en una fecha y hora específicas después de la hora de finalización del período de reserva, incluye la marca --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

      Reemplaza AUTO_CREATED_RESERVATIONS_DELETE_TIME por una fecha y hora con formato de marca de tiempo RFC 3339.

    • Para borrar las reservas creadas de forma automática después de una duración específica posterior a la hora de finalización del período de reserva, incluye la marca --auto-created-reservations-duration.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

      Reemplaza DURATION_BEFORE_DELETE por una duración en días, horas, minutos o segundos. Por ejemplo, especifica 30m para 30 minutos o 1d2h3m4s para un día, dos horas, tres minutos y cuatro segundos.

  • Para inhabilitar la opción de eliminación automática de las reservas creadas de forma automática, reemplaza la marca --auto-delete-auto-created-reservations por la marca --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

  • Para agregar uno o más discos SSD locales a cada VM reservada, incluye una o más marcas --local-ssd. Puedes especificar hasta 24 discos SSD locales. Cada disco SSD local es de 375 GB.

    Por ejemplo, para especificar dos discos SSD locales cuando creas un borrador de una solicitud de reserva futura, incluye dos marcas --local-ssd de la siguiente manera:

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Reemplaza INTERFACE_1 y INTERFACE_2 por el tipo de interfaz que deseas que use el disco SSD local de la siguiente manera:

    Asegúrate de que el tipo de máquina que especifiques para las VMs reservadas admita las interfaces de disco elegidas. De lo contrario, la creación de la solicitud de reserva futura fallará. Para obtener más información, consulta cómo elegir una interfaz de disco.

  • Para que las VMs reservadas usen una plataforma de CPU mínima específica en lugar de la plataforma de CPU predeterminada de la zona, incluye la marca --min-cpu-platform.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform="MIN_CPU_PLATFORM" \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Reemplaza MIN_CPU_PLATFORM por una plataforma de CPU mínima. Para asegurarte de que una plataforma de CPU esté disponible en la zona en la que reservas recursos, consulta las plataformas de CPU disponibles por zona.

  • Para especificar un prefijo de nombre para las reservas creadas de forma automática, incluye la marca --name-prefix.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --name-prefix=NAME_PREFIX \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Reemplaza NAME_PREFIX por el prefijo del nombre de cada reserva creada de forma automática. Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, Google Cloud recomienda especificar un prefijo de nombre único.

REST

Para crear una solicitud de reserva futura compartida a través de la especificación directa de las propiedades, realiza una solicitud POST al método beta.futureReservations.insert.

Para crear un borrador de solicitud de reserva futura mediante la especificación directa de las propiedades sin incluir ningún campo opcional, realiza una solicitud POST de la siguiente manera:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto en el que deseas reservar los recursos.

  • ZONE: Es la zona en la que se reservarán los recursos.

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Si configuras este campo como true, Compute Engine borrará automáticamente las reservas creadas de forma automática para esta reserva futura en un plazo de dos horas a partir de la hora de finalización del período de reserva. Si deseas adjuntar tus reservas creadas de forma automática a un compromiso, establece este campo en false.

  • CONSUMER_PROJECT_ID_1 y CONSUMER_PROJECT_ID_2: Los IDs de los proyectos con los que se puede compartir esta solicitud de reserva futura. Puedes especificar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto en el que se creó esta solicitud de reserva futura (el proyecto propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se pueden utilizar las reservas creadas de forma automática para esta solicitud de reserva futura.

  • TOTAL_COUNT: Es el registro total de las VMs que deseas reservar.

  • START_TIME: La hora de inicio del período de reserva como una marca de tiempo RFC 3339, que debe tener el siguiente formato:

    YYYY-MM-DDTHH:MM:SSOFFSET

    Reemplaza lo siguiente:

    • YYYY-MM-DD: una fecha con formato de un año de 4 dígitos, un mes de 2 dígitos y un día de 2 dígitos del mes separado por guiones (-)

    • HH:MM:SS: una hora con formato de hora de 2 dígitos con un formato de 24 horas, minutos de 2 dígitos y segundos de 2 dígitos separados por dos puntos (:)

    • OFFSET: la zona horaria con formato como una compensación del horario universal coordinado (UTC). Por ejemplo, para usar la hora estándar del Pacífico (PST), especifica -08:00. Como alternativa, para no usar compensación, especifica Z.

    La hora de inicio no puede ser posterior a un año a partir de la fecha y hora en que envías una solicitud de reserva futura para su revisión. Para tener tiempo suficiente para cancelar, borrar o modificar una solicitud de reserva futura después de que se apruebe y antes de que ingrese a la hora de bloqueo, especifica un valor recomendado para la hora de inicio.

  • END_TIME: La hora de finalización del período de reserva con un formato de marca de tiempo RFC 3339. El período de reserva debe durar al menos 24 horas. Como alternativa, puedes reemplazar el campo endTime por el campo duration para especificar una duración específica desde la hora de inicio del período de reserva:

    "duration": {
  "seconds": END_DURATION
}

    Reemplaza END_DURATION por una duración en segundos. Por ejemplo, especifica 1209600 para 1,209,600 segundos (14 días).

    Para aumentar la probabilidad de que a través de Google Cloud se apruebe una solicitud de reserva futura después de enviarla para su revisión, asegúrate de especificar uno de los valores recomendados para el período de la reserva.

Por ejemplo, supongamos que deseas crear un borrador de solicitud de reserva futura con el nombre fr-02 en la zona us-central1-a con las siguientes propiedades:

  • Un período de reserva que comienza a la medianoche del 10 de noviembre de 2024 a UTC y finaliza a la medianoche del 10 de diciembre de 2024 a UTC.

  • Un recuento total de 80 VMs.

  • Un tipo predefinido de máquina N2 con 4 CPUs virtuales.
  • La opción de eliminación automática está habilitada. Las reservas creadas de forma automática se borran al final del período de reserva.
  • La solicitud de reserva futura se comparte con project-1 y project-2.

Para modificar fr-02, realiza una solicitud POST de la siguiente manera:

POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-02",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "n2-standard-4"
    },
    "totalCount": 80
  },
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

De manera opcional, puedes hacer una o más de las siguientes acciones:

  • Para especificar un prefijo de nombre para las reservas creadas de forma automática, incluye el campo namePrefix.

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Reemplaza NAME_PREFIX por el prefijo del nombre de cada reserva creada de forma automática. Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, Google Cloud recomienda especificar un prefijo de nombre único.

  • Para adjuntar GPUs a tus VMs N1 reservadas, incluye la marca guestAccelerators.

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Reemplaza lo siguiente:

    • NUMBER_OF_ACCELERATORS: Es la cantidad de GPU que se agregará por VM reservada.

    • ACCELERATOR_TYPE: Un modelo de GPU compatible para las VMs N1. Para evitar errores, asegúrate de que el modelo de GPU que elegiste esté disponible en la zona en la que creas la solicitud de reserva futura.

  • Para agregar uno o más discos SSD locales a cada VM reservada, incluye el campo localSsds. Puedes especificar hasta 24 discos SSD locales. Cada disco SSD local es de 375 GB.

    Por ejemplo, para especificar dos discos SSD locales cuando creas un borrador de una solicitud de reserva futura, realiza una solicitud POST de la siguiente manera:

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Reemplaza INTERFACE_1 y INTERFACE_2 por el tipo de interfaz que deseas que use el SSD local.

    Asegúrate de que el tipo de máquina que especifiques para las VMs reservadas admita las interfaces de disco elegidas. De lo contrario, la creación de la solicitud de reserva futura fallará. Para obtener más información, consulta cómo elegir una interfaz de disco.

  • Para que las VMs reservadas usen una plataforma de CPU mínima específica en lugar de la plataforma de CPU predeterminada de la zona, incluye la marca minCpuPlatform.

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Reemplaza MIN_CPU_PLATFORM por una plataforma de CPU mínima. Para asegurarte de que una plataforma de CPU esté disponible en la zona en la que reservas recursos, consulta las plataformas de CPU disponibles por zona.

  • Para borrar las reservas creadas de forma automática después de la hora de finalización del período de reserva, selecciona uno de los siguientes métodos:

    • Para borrar las reservas creadas de forma automática en un momento específico después del final de tu período de reserva, configura autoDeleteAutoCreatedReservations como true y especifica el campo autoCreatedReservationsDeleteTime.

      POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

      Reemplaza DELETE_TIME por una fecha y hora en la que Compute Engine borre las reservas creadas de forma automática. La fecha y la hora deben tener el formato de una marca de tiempo RFC 3339.

    • Para borrar las reservas creadas de forma automática después de una duración específica desde la hora de inicio del período de reserva, configura autoDeleteAutoCreatedReservations como true y especifica el campo autoCreatedReservationsDuration.

      POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

      Reemplaza DURATION_BEFORE_DELETE por una duración en segundos. Por ejemplo, especifica 604800 para 604,800 segundos (7 días).

Después de crear un borrador de solicitud de reserva futura, puedes determinar la cantidad de VMs que Compute Engine aprovisionará para la solicitud.

Envía una solicitud de borrador

Después de enviar una solicitud de reserva futura, aprobada por Google Cloud y pasado su momento de bloqueo, puedes borrar la reserva futura y sus reservas creadas de forma automática solo después de la hora de finalización del período de reserva de la reserva futura. Borrar una reserva futura existente es útil si necesitas crear otra reserva futura con las mismas propiedades. Por lo tanto, antes de crear una solicitud de reserva futura, asegúrate de lo siguiente:

  • Cualquier reserva existente o futura en un proyecto restringe la configuración de uso compartido de las solicitudes de reserva futura que puedes crear. Para asegurarte de que puedas crear una solicitud de reserva futura de forma correcta y que esta no cause problemas en otros proyectos con los que compartas reservas o reservas futuras, consulta Restricciones.

  • Debes comprometerte a pagar los recursos reservados que Compute Engine aprovisiona durante todo el período de la reserva, independientemente de si se consumen las reservas creadas de forma automática o no. Para obtener más información, consulta Facturación.

Si quieres modificar una o más propiedades cuando envías el borrador de la solicitud de reserva futura para su revisión, consulta Modifica las solicitudes de reserva futuras.

Para enviar un borrador de solicitud de reserva futura a Google Cloud para su revisión, selecciona una de las siguientes opciones:

Console

  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. En la columna Nombre, haz clic en el nombre de una solicitud de reserva futura con el estado de adquisición Borrador.

    Se abrirá la página Reservas futuras con los detalles de la solicitud de reserva futura.

  4. Haz clic en Editar borrador.

    Se abrirá la página para actualizar el borrador de la solicitud de reserva futura.

  5. Para enviar el borrador de la solicitud de reserva futura para su revisión, haz clic en Enviar.

Se abrirá la página Reserva. En la columna Estado de la solicitud de reserva futura que acabas de enviar, el estado de adquisición se establece en Aprobación pendiente.

gcloud

Para enviar un borrador de solicitud de reserva futura, usa el comando gcloud beta compute future-reservations update con la marca --planning-status establecida en SUBMITTED.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --planning-status=SUBMITTED \
    --zone=ZONE

Reemplaza lo siguiente:

  • FUTURE_RESERVATION_NAME: el nombre de un borrador de solicitud de reserva futura.

  • ZONE: Es la zona en la que se encuentra la solicitud de reserva futura.

REST

Para enviar un borrador de solicitud de reserva futura, realiza una solicitud PATCH al método beta.futureReservations.update. En el cuerpo de la solicitud, incluye el campo planningStatus y configúralo como SUBMITTED.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=planningStatus

{
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "SUBMITTED"
}

Reemplaza lo siguiente:

  • PROJECT_ID es el ID del proyecto en el que se encuentra la solicitud de reserva futura.

  • ZONE: Es la zona en la que se encuentra la solicitud de reserva futura.

  • FUTURE_RESERVATION_NAME: el nombre de un borrador de solicitud de reserva futura.

Después de enviar un borrador de solicitud de reserva futura para su revisión, puedes hacer lo siguiente:

Solucionar problemas

Si te encuentras con errores cuando modificas una solicitud de reserva futura, consulta cómo solucionar problemas de solicitudes de reserva futura.

Si los problemas persisten después de solucionar el problema, comunícate con tu administrador técnico de cuentas o con el equipo de ventas.

¿Qué sigue?