Crear solicitudes de reserva futuras compartidas

Este documento explica cómo crear solicitudes de reserva futuras compartidas.

Si Google Cloud aprueba su solicitud de reserva futura compartida y luego, a la hora de inicio especificada en su solicitud, Compute Engine crea automáticamente reservas que se comparten entre varios proyectos. Estas reservas compartidas creadas automáticamente se consumen al hacer coincidir las máquinas virtuales y las reservas existentes en el proyecto que aloja la reserva futura (proyecto propietario) y los proyectos con los que se comparte la reserva futura (proyectos de consumidor). Para obtener más información sobre cómo funcionan y se pueden consumir las reservas compartidas creadas automáticamente, consulte Crear reservas compartidas .

Antes de comenzar

  • Si aún no lo has hecho:
  • Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. 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. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    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.

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Roles requeridos

Para obtener los permisos que necesita para crear solicitudes de reserva futuras compartidas, solicite a su administrador que le otorgue el rol de IAM Compute Future Reservation User ( roles/compute.futureReservationUser ) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulte Administrar el acceso a proyectos, carpetas y organizaciones .

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

Permisos requeridos

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

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

Es posible que también pueda obtener estos permisos con roles personalizados u otros roles predefinidos .

Restricciones

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

  • El proyecto que utiliza para crear solicitudes de reserva futuras compartidas (el proyecto propietario) debe agregarse a la lista de permitidos para la restricción de política de organización de Proyectos de propietario de reservas compartidas ( compute.sharedReservationsOwnerProjects ) por parte de un administrador de políticas de organización. Para obtener más información, consulta Permitir y restringir proyectos para crear y modificar reservas compartidas en la documentación de reservas de Compute Engine.

  • Si mueve un proyecto que creó una solicitud de reserva futura compartida a una organización diferente, la reserva futura compartida se elimina. El proyecto no se elimina automáticamente de la restricción de política organizacional Proyectos de propietario de reservas compartidas ( compute.sharedReservationsOwnerProjects ), pero puede eliminar el proyecto de esta restricción si lo desea.

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

  • Para cada organización, puede crear hasta 100 solicitudes de reserva futuras compartidas para cada combinación única de propiedades de VM .

Crear un borrador de solicitud

Al crear una solicitud de reserva futura, puede guardar la solicitud como borrador y luego enviarla a Google Cloud para revisión, o enviar directamente la solicitud de revisión. Google recomienda crear primero un borrador de solicitud, ya que esto le permite determinar la cantidad de VM que Compute Engine aprovisionará para su solicitud en lugar de estimar manualmente esta cantidad y, opcionalmente, modificar la cantidad de VM reservadas en la solicitud antes de enviarla para su revisión.

Para consumir una reserva creada automáticamente para una reserva futura, una máquina virtual debe tener propiedades que coincidan exactamente con esa reserva. Para especificar las propiedades de las máquinas virtuales que desea solicitar reservar mediante la creación de un borrador de solicitud de reserva futura, utilice uno de los siguientes métodos:

  • Recomendado: especificar una plantilla de instancia

    Puede utilizar una plantilla de instancia existente para definir las propiedades de un borrador de futura solicitud de reserva. Al utilizar una plantilla de instancia, puede definir las propiedades de una futura solicitud de reserva y las máquinas virtuales que pueden consumir las reservas creadas automáticamente en el mismo lugar. Sin embargo, debido a que las plantillas son específicas del proyecto, no puede usar la misma plantilla para crear máquinas virtuales que puedan consumir las reservas creadas automáticamente fuera del proyecto que creó la solicitud de reserva futura. Para los proyectos con los que se comparte la reserva futura, debe crear plantillas similares en esos proyectos o crear máquinas virtuales especificando propiedades directamente.

  • Especificar una máquina virtual existente

    Puede utilizar una máquina virtual existente para definir las propiedades de una futura solicitud de reserva. Al utilizar las propiedades de una máquina virtual existente, puede consumir las reservas creadas automáticamente y aprovisionadas para la reserva futura creando máquinas virtuales con propiedades que coincidan con la máquina virtual de referencia.

  • Especificar propiedades directamente

    Puede definir directamente las propiedades de un borrador de solicitud de reserva futura. Este método requiere que se asegure manualmente de que las propiedades de sus máquinas virtuales y las reservas creadas automáticamente coincidan exactamente ; cualquier propiedad que no coincida impide el consumo.

Cualquier máquina virtual con propiedades coincidentes puede consumir automáticamente una reserva creada automáticamente para una reserva futura. Si desea evitar que una VM consuma cualquiera de estas reservas creadas automáticamente, consulte cómo crear VM sin consumir reservas .

Especificar una plantilla de instancia

Al crear una solicitud de reserva futura compartida especificando una plantilla de instancia, considere lo siguiente:

  • Una plantilla de instancia contiene configuraciones específicas del proyecto, por lo que solo puedes acceder y usar una plantilla de instancia dentro del mismo proyecto. Si crea una solicitud de reserva futura compartida especificando una plantilla de instancia, debe crear plantillas similares para crear VM, o crear VM especificando propiedades coincidentes directamente, para consumir las reservas creadas automáticamente en cada proyecto de consumidor.

  • Debe crear su futura solicitud de reserva en la misma región y zona que los recursos dentro de la plantilla de instancia. Cualquier recurso regional o zonal que se especifique en una plantilla de instancia, como un tipo de máquina o un disco persistente, restringe el uso de la plantilla a las ubicaciones donde se encuentran esos recursos. Por ejemplo, si su plantilla de instancia especifica un disco persistente existente en la zona us-central1-a , entonces debe crear su futura solicitud de reserva en la misma zona. De lo contrario, no se podrá crear la solicitud de reserva futura.

    Para comprobar si una plantilla existente especifica algún recurso que vincule la plantilla a una región o zona específica, vea los detalles de la plantilla y busque referencias a recursos regionales o zonales dentro de ella.

  • Si desea adjuntar las reservas creadas automáticamente y aprovisionadas para una reserva futura a un compromiso, debe desactivar la opción de eliminación automática. Para obtener más información, consulte Restricciones después de la creación .

Después de crear una solicitud de reserva futura, no puede modificarla para anular las propiedades de la máquina virtual de la plantilla ni especificar otra plantilla. En cambio, si necesita cambiar las propiedades de la VM especificadas en la solicitud, debe crear una nueva solicitud de reserva futura .

Para crear una reserva futura compartida especificando una plantilla de instancia existente, seleccione una de las siguientes opciones:

Consola

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

    Ir a Reservas

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

  3. Haga clic Crear reserva futura .

    Se abre la página Crear una reserva futura .

  4. Para Nombre , ingrese un nombre para su futura solicitud de reserva.

  5. Para Prefijo , ingrese un prefijo de nombre. El nombre de cada reserva creada automáticamente a partir de esta futura solicitud de reserva comienza con este prefijo.

  6. Para Región y Zona , seleccione la región y la zona en las que reservar recursos.

  7. Para Hora de inicio , ingrese una hora de inicio para el período de reserva. La hora de inicio no puede ser posterior a un año a partir de la fecha y hora en la que envíe una solicitud de reserva futura para su revisión. Para tener tiempo suficiente para modificar, cancelar o eliminar opcionalmente la reserva futura antes de que entre en su hora de bloqueo, especifique un valor recomendado para la hora de inicio .

  8. Para Hora de finalización , ingrese una hora de finalización para el período de reserva de al menos 14 días. En el apartado Resumen de duración podrás ver la duración del periodo de reserva. Para aumentar la probabilidad de que Google Cloudaprueba su futura solicitud de reserva después de enviarla para revisión, asegúrese de especificar un valor recomendado para el período de reserva .

  9. En la sección Tipo de recurso compartido , haga lo siguiente:

    1. Para especificar una solicitud de reserva futura compartida, seleccione Compartida .

    2. Haga clic en Agregar proyectos y luego seleccione los proyectos de la organización del proyecto actual con los que desea compartir la futura solicitud de reserva. Puede seleccionar hasta 100 proyectos.

  10. En Capacidad total necesaria , ingrese el recuento total de máquinas virtuales que desea reservar para el período, la configuración de la máquina virtual y los proyectos especificados en esta futura solicitud de reserva.

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

    1. Seleccione Usar plantilla de instancia .

    2. Para Plantilla de instancia , seleccione la plantilla de instancia de su elección. Si selecciona una plantilla de instancia regional, solo podrá reservar recursos dentro de la misma región que la región de la plantilla.

  12. En la sección Eliminación automática de reservas generadas automáticamente , realice una de las siguientes acciones:

    • Para permitir que Compute Engine elimine automáticamente las reservas creadas automáticamente para su futura solicitud de reserva, haga lo siguiente:

      1. Haga clic en el botón Habilitar eliminación automática para colocarlo en la posición de activado si aún no está configurado en esa posición.

      2. Opcional: en Hora de eliminación automática , ingrese una fecha y hora para eliminar las reservas creadas automáticamente. La fecha y hora deben ser posteriores a la hora de finalización del periodo de reserva. Si deja este campo vacío, las reservas creadas automáticamente se eliminan dentro de las dos horas posteriores a la hora de finalización del período de reserva.

    • De lo contrario, haga clic en el botón Habilitar eliminación automática para colocarlo en la posición de apagado.

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

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

nube de gcloud

Para crear una solicitud de reserva futura compartida especificando una plantilla de instancia, use el comando gcloud beta compute future-reservations create con las marcas --share-setting=projects y --share-with .

Para crear un borrador de solicitud de reserva futura especificando una plantilla de instancia sin incluir ningún indicador opcional y eliminar automáticamente la reserva creada automáticamente al final del período de reserva, ejecute 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

Reemplace lo siguiente:

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

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

  • CONSUMER_PROJECT_IDS : una lista separada por comas de ID de proyectos que desea permitir que consuman las reservas creadas automáticamente para esta futura solicitud de reserva; por ejemplo, project-1,project-2 . Puede especificar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto donde se crea la futura solicitud de reserva (el proyecto propietario). No especifique el proyecto del propietario. De forma predeterminada, ya está permitido consumir las reservas creadas automáticamente para esta futura solicitud de reserva.

  • PROJECT_ID : el ID del proyecto donde desea reservar recursos y donde se encuentra la plantilla de instancia.

  • LOCATION : la ubicación de la plantilla de instancia. Especifique uno de los siguientes valores:

    • Para una plantilla de instancia regional: regions/ REGION . Reemplace REGION con la región donde se encuentra la plantilla de instancia. Si especifica una plantilla de instancia regional, solo podrá crear la solicitud de reserva futura dentro de la misma región que la región de la plantilla.

    • Para una plantilla de instancia global: global .

  • INSTANCE_TEMPLATE_NAME : el nombre de una plantilla de instancia existente.

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

    YYYY-MM-DDTHH:MM:SSOFFSET

    Reemplace lo siguiente:

    • YYYY-MM-DD : datos formateados como año de 4 dígitos, mes de 2 dígitos y día del mes de 2 dígitos, separados por guiones ( - ).

    • HH:MM:SS : una hora formateada como hora de 2 dígitos usando una hora de 24 horas, minutos de 2 dígitos y segundos de 2 dígitos, separados por dos puntos ( : ).

    • OFFSET : la zona horaria formateada como un desplazamiento de la hora universal coordinada (UTC) . Por ejemplo, para utilizar la hora estándar del Pacífico (PST), especifique -08:00 . Como alternativa, para no utilizar ningún desplazamiento, especifique Z .

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

  • END_TIME : la hora de finalización del período de reserva con formato de marca de tiempo RFC 3339. Para aumentar la probabilidad de queGoogle Cloud aprueba su solicitud después del envío, especifique un período mínimo de reserva . Para especificar una duración en lugar de una hora de finalización, reemplace la marca --end-time con la marca --duration= END_DURATION . Reemplace END_DURATION con una duración en segundos. Por ejemplo, especifique 1209600 para 1.209.600 segundos (14 días).

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

  • TOTAL_COUNT : el recuento total de máquinas virtuales que desea reservar.

  • ZONE : la zona en la que reservar recursos.

Por ejemplo, supongamos que desea crear un borrador de solicitud de reserva futura denominado 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 UTC y finaliza a la medianoche del 10 de diciembre de 2024 UTC.

  • Un recuento total de 80 VM.

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

Para crear fr-02 , ejecute 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

Opcionalmente, puede realizar una o más de las siguientes acciones:

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

    • Para eliminar las reservas creadas automáticamente en una fecha y hora específicas después de la hora de finalización del período de reserva, incluya 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

      Reemplace AUTO_CREATED_RESERVATIONS_DELETE_TIME con una fecha y hora formateadas como marca de tiempo RFC 3339.

    • Para eliminar las reservas creadas automáticamente después de una duración específica después de la hora de finalización del período de reserva, incluya 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

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

  • Para deshabilitar la opción de eliminación automática para las reservas creadas automáticamente, reemplace la marca --auto-delete-auto-created-reservations con 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 automáticamente, incluya 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

    Reemplace NAME_PREFIX con el prefijo de nombre para cada reserva creada automáticamente. Para ayudarle a identificar las reservas creadas automáticamente para esta futura solicitud de reserva, Google Cloud recomienda especificar un prefijo de nombre exclusivo.

DESCANSAR

Para crear una solicitud de reserva futura compartida especificando una plantilla de instancia, realice una solicitud POST al método beta.futureReservations.insert .

Para crear un borrador de solicitud de reserva futura especificando una plantilla de instancia sin incluir ningún campo opcional, realice 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"
  }
}

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto en el que desea reservar recursos y donde se encuentra la plantilla de instancia.

  • ZONE : la zona en la que reservar recursos.

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS : si configura este campo en true , Compute Engine elimina automáticamente las reservas creadas automáticamente para esta reserva futura dentro de las dos horas posteriores a la hora de finalización del período de reserva. Si desea adjuntar sus reservas creadas automáticamente a un compromiso, establezca este campo en false .

  • CONSUMER_PROJECT_ID_1 y CONSUMER_PROJECT_ID_2 : los ID de los proyectos con los que se puede compartir esta futura solicitud de reserva. Puede especificar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto donde se crea la futura solicitud de reserva (el proyecto propietario). No especifique el proyecto del propietario. De forma predeterminada, ya está permitido consumir las reservas creadas automáticamente para esta futura solicitud de reserva.

  • LOCATION : la ubicación de la plantilla de instancia. Especifique uno de los siguientes valores:

    • Para una plantilla de instancia regional: regions/ REGION . Reemplace REGION con la región donde se encuentra la plantilla de instancia. Si especifica una plantilla de instancia regional, solo podrá crear la solicitud de reserva futura dentro de la misma región que la región de la plantilla.

    • Para una plantilla de instancia global: global .

  • INSTANCE_TEMPLATE_NAME : el nombre de una plantilla de instancia existente.

  • TOTAL_COUNT : el recuento total de máquinas virtuales que desea reservar.

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

    YYYY-MM-DDTHH:MM:SSOFFSET

    Reemplace lo siguiente:

    • YYYY-MM-DD : datos formateados como año de 4 dígitos, mes de 2 dígitos y día del mes de 2 dígitos, separados por guiones ( - ).

    • HH:MM:SS : una hora formateada como hora de 2 dígitos usando una hora de 24 horas, minutos de 2 dígitos y segundos de 2 dígitos, separados por dos puntos ( : ).

    • OFFSET : la zona horaria formateada como un desplazamiento de la hora universal coordinada (UTC) . Por ejemplo, para utilizar la hora estándar del Pacífico (PST), especifique -08:00 . Como alternativa, para no utilizar ningún desplazamiento, especifique Z .

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

  • END_TIME : la hora de finalización del período de reserva con formato de marca de tiempo RFC 3339. Para aumentar la probabilidad de queGoogle Cloud aprueba su solicitud después del envío, especifique un período mínimo de reserva . Para especificar una duración en lugar de una hora de finalización, puede reemplazar el campo endTime con el campo duration : 

    "duration": {
  "seconds": END_DURATION
}

    Reemplace END_DURATION con una duración en segundos. Por ejemplo, especifique 1209600 para 1.209.600 segundos (14 días).

Por ejemplo, supongamos que desea crear un borrador de solicitud de reserva futura denominado 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 UTC y finaliza a la medianoche del 10 de diciembre de 2024 UTC.

  • Un recuento total de 80 VM.

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

Para crear fr-02 , realice 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"
  }
}

Opcionalmente, puede realizar una o más de las siguientes acciones:

  • Para especificar un prefijo de nombre para las reservas creadas automáticamente, incluya 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"
  }
}

    Reemplace NAME_PREFIX con el prefijo de nombre para cada reserva creada automáticamente. Para ayudarle a identificar las reservas creadas automáticamente para esta futura solicitud de reserva, Google Cloud recomienda especificar un prefijo de nombre exclusivo.

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

    • Para eliminar las reservas creadas automáticamente después de un tiempo específico después del final de su período de reserva, establezca autoDeleteAutoCreatedReservations en true e incluya 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"
  }
}

      Reemplace DELETE_TIME con una fecha y hora en la que Compute Engine elimine las reservas creadas automáticamente. La fecha y la hora deben tener el formato de marca de tiempo RFC 3339.

    • Para eliminar las reservas creadas automáticamente después de una duración específica desde la hora de inicio del período de reserva, establezca autoDeleteAutoCreatedReservations en true e incluya 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"
  }
}

      Reemplace DURATION_BEFORE_DELETE con una duración en segundos. Por ejemplo, especifique 604800 para 604.800 segundos (7 días).

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

Especificar una máquina virtual existente

Solo puede crear un borrador de solicitud de reserva futura basada en una máquina virtual existente en el mismo proyecto y zona que la máquina virtual.

Después de que la futura solicitud de reserva sea aprobada por Google Cloud y entra en su período de reserva, puede consumir sus reservas creadas automáticamente creando máquinas virtuales con propiedades que coincidan con la máquina virtual de referencia. Puede hacerlo realizando una de las siguientes acciones:

  • Cree y utilice una plantilla de instancia de la siguiente manera:

    1. Cree una plantilla de instancia basada en la VM de referencia sin anular las propiedades de la VM de referencia.

    2. Cree máquinas virtuales utilizando la plantilla recién creada realizando una o ambas de las siguientes acciones:

  • Cree una máquina virtual con propiedades que coincidan exactamente con la máquina virtual de referencia de la siguiente manera:

Para crear una solicitud de reserva futura compartida que utilice las propiedades de una máquina virtual existente, haga lo siguiente:

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

    Ir a Reservas

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

  3. Haga clic Crear reserva futura .

    Se abre la página Crear una reserva futura .

  4. Para Nombre , ingrese un nombre para su futura solicitud de reserva.

  5. Para Prefijo , ingrese un prefijo de nombre. El nombre de cada reserva creada automáticamente a partir de esta futura solicitud de reserva comienza con este prefijo.

  6. Para Región y Zona , seleccione la región y la zona en las que reservar recursos.

  7. Para Hora de inicio , ingrese una hora de inicio para el período de reserva. La hora de inicio no puede ser posterior a un año a partir de la fecha y hora en la que envíe una solicitud de reserva futura para su revisión. Para tener tiempo suficiente para modificar, cancelar o eliminar opcionalmente la reserva futura antes de que entre en su hora de bloqueo, especifique un valor recomendado para la hora de inicio .

  8. Para Hora de finalización , ingrese una hora de finalización para el período de reserva de al menos 14 días. En el apartado Resumen de duración podrás ver la duración del periodo de reserva. Para aumentar la probabilidad de que Google Cloudaprueba su futura solicitud de reserva después de enviarla para revisión, asegúrese de especificar un valor recomendado para el período de reserva .

  9. En la sección Tipo de recurso compartido , haga lo siguiente:

    1. Para especificar una solicitud de reserva futura compartida, seleccione Compartida .

    2. Haga clic en Agregar proyectos y luego seleccione los proyectos de la organización del proyecto actual con los que desea compartir la futura solicitud de reserva. Puede seleccionar hasta 100 proyectos.

  10. En Capacidad total necesaria , ingrese el recuento total de máquinas virtuales que desea reservar para el período, la configuración de la máquina virtual y los proyectos especificados en esta futura solicitud de reserva.

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

    1. Seleccione Usar VM existente .

    2. Para VM existente , seleccione la VM cuyas propiedades desea usar para crear la reserva.

  12. En la sección Eliminación automática de reservas generadas automáticamente , realice una de las siguientes acciones:

    • Para permitir que Compute Engine elimine automáticamente las reservas creadas automáticamente para su futura solicitud de reserva, haga lo siguiente:

      1. Haga clic en el botón Habilitar eliminación automática para colocarlo en la posición de activado si aún no está configurado en esa posición.

      2. Opcional: en Hora de eliminación automática , ingrese una fecha y hora para eliminar las reservas creadas automáticamente. La fecha y hora deben ser posteriores a la hora de finalización del periodo de reserva. Si deja este campo vacío, las reservas creadas automáticamente se eliminan dentro de las dos horas posteriores a la hora de finalización del período de reserva.

    • De lo contrario, haga clic en el botón Habilitar eliminación automática para colocarlo en la posición de apagado.

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

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

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

Especificar propiedades directamente

Si desea adjuntar las reservas creadas automáticamente y aprovisionadas para una reserva futura a un compromiso, debe desactivar la opción de eliminación automática. Para obtener más información, consulte Restricciones después de la creación .

Para crear una solicitud de reserva futura compartida especificando propiedades directamente, seleccione una de las siguientes opciones:

Consola

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

    Ir a Reservas

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

  3. Haga clic Crear reserva futura .

    Se abre la página Crear una reserva futura .

  4. Para Nombre , ingrese un nombre para su futura solicitud de reserva.

  5. Para Prefijo , ingrese un prefijo de nombre. El nombre de cada reserva creada automáticamente a partir de esta futura solicitud de reserva comienza con este prefijo.

  6. Para Región y Zona , seleccione la región y la zona en las que reservar recursos.

  7. Para Hora de inicio , ingrese una hora de inicio para el período de reserva. La hora de inicio no puede ser posterior a un año a partir de la fecha y hora en la que envíe una solicitud de reserva futura para su revisión. Para tener tiempo suficiente para modificar, cancelar o eliminar opcionalmente la reserva futura antes de que entre en su hora de bloqueo, especifique un valor recomendado para la hora de inicio .

  8. Para Hora de finalización , ingrese una hora de finalización para el período de reserva de al menos 14 días. En el apartado Resumen de duración podrás ver la duración del periodo de reserva. Para aumentar la probabilidad de que Google Cloudaprueba su futura solicitud de reserva después de enviarla para revisión, asegúrese de especificar un valor recomendado para el período de reserva .

  9. En la sección Tipo de recurso compartido , haga lo siguiente:

    1. Para especificar una solicitud de reserva futura compartida, seleccione Compartida .

    2. Haga clic en Agregar proyectos y luego seleccione los proyectos de la organización del proyecto actual con los que desea compartir la futura solicitud de reserva. Puede seleccionar hasta 100 proyectos.

  10. En Capacidad total necesaria , ingrese el recuento total de máquinas virtuales que desea reservar para el período, la configuración de la máquina virtual y los proyectos especificados en esta futura solicitud de reserva.

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

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

    2. Especifique el tipo de máquina que se utilizará para las máquinas virtuales reservadas.

  12. En la sección Eliminación automática de reservas generadas automáticamente , realice una de las siguientes acciones:

    • Para permitir que Compute Engine elimine automáticamente las reservas creadas automáticamente para su futura solicitud de reserva, haga lo siguiente:

      1. Haga clic en el botón Habilitar eliminación automática para colocarlo en la posición de activado si aún no está configurado en esa posición.

      2. Opcional: en Hora de eliminación automática , ingrese una fecha y hora para eliminar las reservas creadas automáticamente. La fecha y hora deben ser posteriores a la hora de finalización del periodo de reserva. Si deja este campo vacío, las reservas creadas automáticamente se eliminan dentro de las dos horas posteriores a la hora de finalización del período de reserva.

    • De lo contrario, haga clic en el botón Habilitar eliminación automática para colocarlo en la posición de apagado.

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

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

nube de gcloud

Para crear una solicitud de reserva futura compartida especificando propiedades directamente, use el comando gcloud beta compute future-reservations create con las marcas --share-setting=projects y --share-with .

Para crear un borrador de solicitud de reserva futura especificando propiedades directamente sin incluir ninguna marca opcional y eliminar automáticamente la reserva creada automáticamente al final del período de reserva, ejecute 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

Reemplace lo siguiente:

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

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

  • CONSUMER_PROJECT_IDS : una lista separada por comas de ID de proyectos que desea permitir que consuman las reservas creadas automáticamente para esta futura solicitud de reserva; por ejemplo, project-1,project-2 . Puede especificar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto donde se crea la futura solicitud de reserva (el proyecto propietario). No especifique el proyecto del propietario. De forma predeterminada, ya está permitido consumir las reservas creadas automáticamente para esta futura solicitud de reserva.

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

    YYYY-MM-DDTHH:MM:SSOFFSET

    Reemplace lo siguiente:

    • YYYY-MM-DD : datos formateados como año de 4 dígitos, mes de 2 dígitos y día del mes de 2 dígitos, separados por guiones ( - ).

    • HH:MM:SS : una hora formateada como hora de 2 dígitos usando una hora de 24 horas, minutos de 2 dígitos y segundos de 2 dígitos, separados por dos puntos ( : ).

    • OFFSET : la zona horaria formateada como un desplazamiento de la hora universal coordinada (UTC) . Por ejemplo, para utilizar la hora estándar del Pacífico (PST), especifique -08:00 . Como alternativa, para no utilizar ningún desplazamiento, especifique Z .

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

  • END_TIME : la hora de finalización del período de reserva con formato de marca de tiempo RFC 3339. Para aumentar la probabilidad de queGoogle Cloud aprueba su solicitud después del envío, especifique un período mínimo de reserva . Para especificar una duración en lugar de una hora de finalización, reemplace la marca --end-time con la marca --duration= END_DURATION . Reemplace END_DURATION con una duración en segundos. Por ejemplo, especifique 1209600 para 1.209.600 segundos (14 días).

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

  • TOTAL_COUNT : el recuento total de máquinas virtuales que desea reservar.

  • ZONE : la zona en la que reservar recursos.

Por ejemplo, supongamos que desea crear un borrador de solicitud de reserva futura denominado 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 UTC y finaliza a la medianoche del 10 de diciembre de 2024 UTC.

  • Un recuento total de 80 VM.

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

Para crear fr-02 , ejecute 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

Opcionalmente, puede realizar una o más de las siguientes acciones:

  • Para conectar GPU a sus máquinas virtuales N1 reservadas, incluya el indicador --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

    Reemplace lo siguiente:

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

    • ACCELERATOR_TYPE : un modelo de GPU compatible con máquinas virtuales N1 . Para evitar errores, asegúrese de que el modelo de GPU elegido esté disponible en la zona donde está creando la futura solicitud de reserva.

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

    • Para eliminar las reservas creadas automáticamente en una fecha y hora específicas después de la hora de finalización del período de reserva, incluya 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

      Reemplace AUTO_CREATED_RESERVATIONS_DELETE_TIME con una fecha y hora formateadas como marca de tiempo RFC 3339.

    • Para eliminar las reservas creadas automáticamente después de una duración específica después de la hora de finalización del período de reserva, incluya 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

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

  • Para deshabilitar la opción de eliminación automática para las reservas creadas automáticamente, reemplace la marca --auto-delete-auto-created-reservations con 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 conectar discos SSD locales a un tipo de máquina que no incluye discos SSD locales de forma predeterminada , incluya la marca --local-ssd . Sólo puede adjuntar un disco SSD local de 375 GB. 

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --local-ssd=count=NUMBER_OF_LOCAL_SSD_DISKS,size=375,interface=INTERFACE_TYPE \
    --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

    Reemplace lo siguiente:

    • NUMBER_OF_LOCAL_SSD_DISKS : la cantidad de discos SSD locales que se conectarán.

    • INTERFACE_TYPE : el tipo de interfaz de disco que desea que utilicen los discos SSD locales y que admite el tipo de máquina especificado . Especifique uno de los siguientes valores:

      • Para la interfaz de disco NVME: nvme

      • Para la interfaz de disco SCSI: scsi

  • Para que las máquinas virtuales reservadas utilicen una plataforma de CPU mínima específica en lugar de la plataforma de CPU predeterminada de la zona, incluya 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

    Reemplace MIN_CPU_PLATFORM con una plataforma de CPU mínima. Para asegurarse de que haya una plataforma de CPU disponible en la zona donde está reservando recursos, vea las plataformas de CPU disponibles por zona .

  • Para especificar un prefijo de nombre para las reservas creadas automáticamente, incluya 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

    Reemplace NAME_PREFIX con el prefijo de nombre para cada reserva creada automáticamente. Para ayudarle a identificar las reservas creadas automáticamente para esta futura solicitud de reserva, Google Cloud recomienda especificar un prefijo de nombre exclusivo.

DESCANSAR

Para crear una solicitud de reserva futura compartida especificando propiedades directamente, realice una solicitud POST al método beta.futureReservations.insert .

Para crear un borrador de solicitud de reserva futura especificando propiedades directamente sin incluir ningún campo opcional, realice 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"
  }
}

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto en el que desea reservar recursos.

  • ZONE : la zona en la que reservar recursos.

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS : si configura este campo en true , Compute Engine elimina automáticamente las reservas creadas automáticamente para esta reserva futura dentro de las dos horas posteriores a la hora de finalización del período de reserva. Si desea adjuntar sus reservas creadas automáticamente a un compromiso, establezca este campo en false .

  • CONSUMER_PROJECT_ID_1 y CONSUMER_PROJECT_ID_2 : los ID de los proyectos con los que se puede compartir esta futura solicitud de reserva. Puede especificar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto donde se crea la futura solicitud de reserva (el proyecto propietario). No especifique el proyecto del propietario. De forma predeterminada, ya está permitido consumir las reservas creadas automáticamente para esta futura solicitud de reserva.

  • TOTAL_COUNT : el recuento total de máquinas virtuales que desea reservar.

  • START_TIME : la hora de inicio del período de reserva como una marca de tiempo RFC 3339 , que debe formatearse de la siguiente manera: 

    YYYY-MM-DDTHH:MM:SSOFFSET

    Reemplace lo siguiente:

    • YYYY-MM-DD : Un datos formateados como un año de 4 dígitos, mes de 2 dígitos y un día de 2 dígitos del mes, separados por guiones ( - ).

    • HH:MM:SS : una hora formateada como hora de 2 dígitos usando una hora de 24 horas, minutos de 2 dígitos y segundos de 2 dígitos, separados por dos puntos ( : ).

    • OFFSET : la zona horaria formateada como un desplazamiento de la hora universal coordinada (UTC) . Por ejemplo, para utilizar la hora estándar del Pacífico (PST), especifique -08:00 . Como alternativa, para no utilizar ningún desplazamiento, especifique Z .

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

  • END_TIME : el tiempo de finalización del período de reserva formateado como una marca de tiempo RFC 3339. Para aumentar la probabilidad de queGoogle Cloud Aprueba su solicitud después del envío, especifique un período de reserva mínimo . Para especificar una duración en lugar de una hora de finalización, puede reemplazar el campo de endTime con el campo duration : 

    "duration": {
  "seconds": END_DURATION
}

    Reemplace END_DURATION con una duración en segundos. Por ejemplo, especifique 1209600 por 1,209,600 segundos (14 días).

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

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

  • Un recuento total de 80 VM.

  • Un tipo de máquina predefinida N2 con 4 VCPU.
  • La opción Auto-Delete habilitada. Las reservas creadas automáticamente se eliminan al final del período de reserva.
  • La solicitud de reserva futura se comparte con project-1 y project-2 .

Para crear fr-02 , haga 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"
  }
}

Opcionalmente, puede realizar una o más de las siguientes acciones:

  • Para especificar un prefijo de nombre para las reservas creadas automáticamente, incluya 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"
  }
}

    Reemplace NAME_PREFIX con el prefijo de nombre para cada reserva creada automáticamente. Para ayudarlo a identificar las reservas creadas automáticamente para esta solicitud de reserva futura, Google Cloud recomienda especificar un prefijo de nombre único.

  • Para adjuntar GPU a sus VMS reservadas, incluya el campo 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"
  }
}

    Reemplace lo siguiente:

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

    • ACCELERATOR_TYPE : un modelo de GPU compatible con máquinas virtuales N1 . Para evitar errores, asegúrese de que su modelo de GPU elegido esté disponible en la zona donde está creando la solicitud de reserva futura.

  • Para conectar discos SSD locales a un tipo de máquina que no incluye discos SSD locales de forma predeterminada , incluya el campo localSsds en el cuerpo de la solicitud. Sólo puedes conectar discos SSD locales de 375 GB.

    Por ejemplo, para especificar dos discos SSD locales al crear un borrador de solicitud de reserva futura, haga 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_TYPE"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_TYPE"
        }
      ],
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Reemplace INTERFACE_TYPE con el tipo de interfaz de disco que desea que use los discos SSD locales y que admite su tipo de máquina especificada . Especifique uno de los siguientes valores:

    • Para la interfaz de disco NVME: NVME

    • Para la interfaz de disco SCSI: SCSI

  • Para que las máquinas virtuales reservadas usen una plataforma mínima de CPU específica en lugar de la plataforma CPU predeterminada de la zona, incluya la 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"
  }
}

    Reemplace MIN_CPU_PLATFORM con una plataforma de CPU mínima. Para garantizar que haya una plataforma CPU disponible en la zona donde esté reservando recursos, vea las plataformas de CPU disponibles por zona .

  • Para eliminar las reservas creadas automáticamente después de la hora final del período de reserva, seleccione uno de los siguientes métodos:

    • Para eliminar las reservas creadas automáticamente después de un tiempo específico después del final de su período de reserva, establezca las autoDeleteAutoCreatedReservations en true e incluya 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"
  }
}

      Reemplace DELETE_TIME con una fecha y hora cuando el motor calcule elimine las reservas creadas automáticamente. La fecha y la hora deben formatearse como una marca de tiempo RFC 3339.

    • Para eliminar las reservas creadas automáticamente después de una duración específica desde la hora de inicio del período de reserva, true las autoDeleteAutoCreatedReservations e incluya 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"
  }
}

      Reemplace DURATION_BEFORE_DELETE con una duración en segundos. Por ejemplo, especifique 604800 para 604,800 segundos (7 días).

Después de crear un borrador de solicitud de reserva futura, puede determinar el número de máquinas virtuales que el motor de cálculo se proporcionará para la solicitud .

Enviar un borrador de solicitud

Después de que se presente una solicitud de reserva futura, aprobada por Google Cloudy más allá de su tiempo de bloqueo, puede eliminar la reserva futura y sus reservas creadas automáticamente solo después del final del período de reserva de la reserva futura. Eliminar una reserva futura existente es útil si necesita crear otra reserva futura con las mismas propiedades. Por lo tanto, antes de crear una solicitud de reserva futura, asegúrese de lo siguiente:

  • Cualquier reserva existente o reservas futuras en un proyecto restringe la configuración de acciones de las futuras solicitudes de reserva que puede crear. Para asegurarse de que puede crear con éxito una solicitud de reserva futura, y su solicitud no causa problemas en otros proyectos con los que comparta solicitudes o reservas futuras de reserva, consulte Restricciones .

  • Debe comprometerse a pagar los recursos reservados que calculan las disposiciones del motor para todo el período de reserva, independientemente de si las reservas creadas automáticamente se consumen o no. Para obtener más información, consulte Facturación .

Si desea modificar una o más propiedades al enviar el borrador de la solicitud de reserva futura de revisión, consulte Modifique las solicitudes de reserva futuras en su lugar.

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

Consola

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

    Ir a Reservas

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

  3. En la columna de nombre , haga clic en el nombre de la solicitud de reserva futura con un estado de adquisición de la redacción .

    Se abre la página de reservas futuras con los detalles de la solicitud de reserva futura.

  4. Haga clic borrador .

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

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

Se abre la página de reserva . En la columna de estado de la solicitud de reserva futura que acaba de presentar, el estado de adquisición se establece en la aprobación pendiente .

nube de gcloud

Para enviar un borrador de la solicitud de revisión futura de reserva, use el comando gcloud beta compute future-reservations update con el indicador --planning-status establecido en SUBMITTED . 

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

Reemplace lo siguiente:

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

  • ZONE : la zona donde se encuentra la solicitud de reserva futura.

DESCANSAR

Para enviar un borrador de la solicitud de revisión futura de reserva, haga una solicitud PATCH al método beta.futureReservations.update . En el cuerpo de solicitud, incluya el campo planningStatus y configúrelo en 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"
}

Reemplace lo siguiente:

  • PROJECT_ID : la ID del proyecto donde se encuentra la solicitud de reserva futura.

  • ZONE : la zona donde se encuentra la solicitud de reserva futura.

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

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

Solucionar problemas

Si se encuentra con errores al crear una solicitud de reserva futura, consulte cómo solucionar problemas de solicitudes de reserva futuras .

Si aún se encuentra con problemas después de la resolución de problemas, comuníquese con su gerente de cuenta técnica o el equipo de ventas .

¿Qué sigue?