Crea solicitudes de reserva futuras compartidas

---

Vista previa

Este producto o función está sujeto a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones específicas del Servicio. Los productos y las funciones que se encuentran en la fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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:
  • Revisa las prácticas recomendadas para las reservas compartidas según demanda.
  • Revisa cómo funcionan las reservas futuras.
  • A fin de asegurarte de que tienes suficiente cuota para los recursos que quieres reservar, verifica tu cuota.
• 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

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  2. Set a default region and zone.

  REST

  Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que 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.

Funciones obligatorias

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.

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 compartidas para cada combinación única de propiedades de la VM.

Crea una solicitud de reserva futura compartida.

En esta sección, se explica cómo crear una solicitud de reserva futura compartida.

Después de crear una solicitud de reserva futura compartida, solo el proyecto propietario puede cancelarla, borrarla o modificarla. Sin embargo, el proyecto de propietario puede utilizar las reservas creadas de forma automática y cualquier proyecto de consumidor con el que se comparta la solicitud de reserva futura compartida.

Advertencia: Después de enviar una solicitud de reserva futura, aprobada por Google Cloud y en el 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. Por lo tanto, antes de crear una solicitud de reserva futura, asegúrate de lo siguiente:

• Cualquier reserva existente o reserva futura en un proyecto restringe la configuración de uso compartido de las solicitudes de reserva futuras 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 por los recursos reservados que Compute Engine aprovisiona para todo el período de reserva, sin importar si se usan o no las reservas creadas de forma automática. Para obtener más información, consulta Facturació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 una solicitud de reserva futura, selecciona uno de los siguientes métodos:

• Recomendado: Especifica una plantilla de instancias

  En esta sección, se explica cómo usar una plantilla de instancias existente para definir las propiedades de una solicitud de reserva futura compartida. 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 las propiedades directamente

  En esta sección, se explica cómo definir de forma directa las propiedades de una solicitud de reserva futura compartida. 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

Puedes crear una reserva futura compartida si especificas una plantilla de instancias existente con la consola de Google Cloud, gcloud CLI y REST.

Precaución: antes de usar una plantilla de instancias para crear una solicitud de reserva futura, asegúrate de 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 un disco, 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 disco 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.

• 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, debes crear una solicitud de reserva futura nueva con las actualizaciones deseadas.

Consola

Para crear una solicitud de reserva futura compartida a través de la especificación de una plantilla de instancias, sigue estos pasos:

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 el campo Nombre, ingresa un nombre para tu solicitud de reserva futura.

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

   Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, se recomienda especificar un prefijo de nombre único.

6. Opcional: en el campo Descripción, ingresa una descripción para tu solicitud de reserva futura.

7. En el campo Región, elige la región en la que deseas reservar los recursos.

8. En el campo Zona, selecciona la zona en la que deseas reservar los recursos.

9. En el campo Hora de inicio, ingresa una hora de inicio para el período de la reserva. La hora de inicio no puede ser posterior a 1 año a partir de la fecha y hora en que envías una solicitud de reserva futura para su revisión.

   Asegúrate de especificar un valor recomendado para la hora de inicio para tener el tiempo suficiente antes de que la próxima reserva ingrese a su hora de bloqueo.

10. En el campo 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 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.

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

    1. Para especificar una solicitud de reserva futura compartida, haz clic en 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. No selecciones el proyecto actual. De forma predeterminada, ya se pueden utilizar las reservas creadas de forma automática para esta solicitud de reserva futura.

12. En el campo 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.

    Cuando se calcula la cantidad de reservas nuevas que se crearán para una solicitud de reserva futura aprobada poco antes de la hora de inicio, Compute Engine resta cualquier reserva existente que coincida con la solicitud de este total. Para obtener más información, consulta cómo se cuenta y produce recursos reservados con Compute Engine.

    Precaución: asegúrate de tener suficiente cuota para los recursos que solicitas reservar. De lo contrario, en Google Cloud se rechazará tu solicitud de reserva futura

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

    1. Para especificar las propiedades de tus VMs de una plantilla de instancias existente, selecciona Usar plantilla de instancias.

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

14. 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:

      Precaución: si la opción de eliminación automática está habilitada, todas las reservas creadas de forma automática se borran en el momento de la eliminación especificado, sin importar si se consumen por completo o no.

      1. Haz clic en el botón de activación Habilitar la eliminación automática para llevarlo a la posición activada (predeterminado).

      2. Opcional: en el campo 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 2 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.

15. Realice una de las siguientes acciones:

    • Para crear una solicitud de reserva futura y enviarla para su revisión en Google Cloud, haz clic en Enviar.

      Precaución: asegúrate de que una solicitud de reserva futura esté lista para su revisión antes de enviarla. Una vez que se envía, no puedes volver a la etapa de borrador.

    • Para crear un borrador de solicitud de reserva futura, haz clic en Guardar borrador.

    • Para salir sin guardar, haz clic en Cancelar.

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 la marca --source-instance-template.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --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: El nombre de la solicitud de reserva futura que se creará.

• DESCRIPTION: Opcional Una descripción nueva para la solicitud de reserva futura.

• NAME_PREFIX: El prefijo del nombre de la solicitud de reserva futura. El nombre de cada reserva creada de forma automática para esta solicitud de reserva futura comienza con el prefijo del nombre. Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, se recomienda especificar un prefijo de nombre único.

• PLANNING_STATUS: Opcional El estado de planificación de la solicitud de reserva futura, que debe ser uno de los siguientes:

  • Para crear el borrador de una solicitud de reserva futura, especifica DRAFT.

  • Para crear la solicitud de reserva futura y enviarla para su aprobación en Google Cloud, especifica SUBMITTED.

    Precaución: después de enviar una solicitud de reserva futura para su revisión, no podrás volver a cambiar su estado de planificación a DRAFT.

  Si omites la marca --planning-status, su valor se establece en DRAFT.

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

• CONSUMER_PROJECT_IDS: Una lista separada por comas de los IDs de los proyectos con los que se puede compartir esta solicitud de reserva futura. Por ejemplo, especifica 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ó la solicitud de reserva futura (el proyecto de 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 global: global.

  • 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 se pueden reservar las VMs dentro de la región en la que se encuentra la plantilla de instancias.

• INSTANCE_TEMPLATE_NAME: Es nombre de una plantilla de instancias existente. Si especificas una plantilla de instancias, no puedes anular sus propiedades cuando creas la solicitud de reserva futura. De lo contrario, se encuentran errores.

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

  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 1 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 o antes de que ingrese a la hora de bloqueo, asegúrate de especificar 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, en la que END_DURATION es 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 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.

  Importante: Asegúrate de que el período de reserva no se superponga con el período de reserva de otra solicitud de reserva futura existente con las mismas propiedades y zona de VM, y que se haya creado en tu proyecto actual o se comparta con él. De lo contrario, la creación de la solicitud de reserva futura fallará.

• TOTAL_COUNT: La cantidad 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.

  Cuando se calcula la cantidad de reservas que se crearán para una reserva futura aprobada, Compute Engine primero verifica las reservas existentes. Si hay reservas existentes que coinciden con la reserva futura aprobada, la cantidad de reservas existentes se resta de la cantidad total solicitada de reservas en la solicitud para determinar la cantidad de reservas nuevas creadas con Compute Engine Para obtener más información, consulta cómo se cuenta y produce recursos reservados con Compute Engine.

  Precaución: Asegúrate de tener suficiente cuota para los recursos que solicitas reservar. De lo contrario, en Google Cloud se rechazará tu solicitud de reserva futura

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

Cuando especificas la marca --auto-delete-auto-created-reservations, Compute Engine borra de forma automática las reservas creadas automáticamente para tu solicitud de reserva futura. De forma predeterminada, la hora de eliminación es dentro de las 2 horas posteriores de la hora de finalización del período de reserva. De manera opcional, puedes cambiar esto si realizas una 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:

  Precaución: Si habilitas la opción de eliminación automática, todas las reservas creadas de forma automática se borran en el momento de la eliminación especificado, sin importar si se consumen por completo o no.

  • Para borrar las reservas creadas de forma automática en un momento específico después de la hora de finalización del período de reserva, especifica las marcas --auto-delete-auto-created-reservations y --auto-created-reservations-delete-time.

    gcloud beta compute future-reservations create example-future-reservation \
        --auto-delete-auto-created-reservations \
        --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
        ...
    

    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 después de la hora de finalización del período de reserva, especifica las marcas --auto-delete-auto-created-reservations y --auto-created-reservations-duration.

    gcloud beta compute future-reservations create example-future-reservation \
        --auto-delete-auto-created-reservations \
        --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
        ...
    

    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 1 día, 2 horas, 3 minutos y 4 segundos.

• Para inhabilitar Compute Engine de modo que se borren de forma automática las reservas creadas de forma automática, especifica la marca --no-auto-delete-auto-created-reservations. Debes inhabilitar la opción de eliminación automática si deseas conectar la reserva creada de forma automática a un compromiso.

  gcloud beta compute future-reservations create example-future-reservation \
      --no-auto-delete-auto-created-reservations \
      ...
  

Por ejemplo, con el siguiente comando, se crea un borrador de solicitud de reserva futura con la plantilla de instancias global example-template para 80 VMs. La solicitud de reserva futura se comparte con project-1 y project-2. El período de reserva comienza a la medianoche del 10 de noviembre de 2023 a UTC y finaliza a la medianoche del 10 de diciembre de 2023 UTC. Las reservas creadas de forma automática para la reserva futura se crean en la zona us-central1-a, tienen un nombre que comienza con fr-02-reservation y se borran de forma automática a la medianoche del 13 de diciembre de 2023 UTC. .

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

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.

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

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "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: 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 deseas reservar 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 solicitud de reserva futura, sin importar si se consumen por completo o no. Establece este campo en false si deseas conectar tu reserva creada de forma automática a un compromiso.

  De forma predeterminada, la hora de eliminación es dentro de las 2 horas posteriores de la hora de finalización del período de reserva. Para cambiar esto, realiza una de las siguientes acciones:

  • 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/example-project/zones/us-central1-a/futureReservations
    
    {
      "autoDeleteAutoCreatedReservations": "true",
      "autoCreatedReservationsDeleteTime": "DELETE_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, que debe ser de la siguiente manera:

    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 zona horaria de la hora estándar del Pacífico (PST), especifica -08:00. Como alternativa, para no usar compensación, especifica Z.

  • 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/example-project/zones/us-central1-a/futureReservations
    
    {
      "autoDeleteAutoCreatedReservations": "true",
      "autoCreatedReservationsDuration": {
        "seconds": "DURATION_BEFORE_DELETE"
      },
      ...
    }
    

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

• DESCRIPTION: Opcional Una descripción nueva para la solicitud de reserva futura.

• FUTURE_RESERVATION_NAME: El nombre de la solicitud de reserva futura que se creará.

• NAME_PREFIX: El prefijo del nombre de la solicitud de reserva futura. El nombre de cada reserva creada de forma automática para esta solicitud de reserva futura comienza con el prefijo del nombre. Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, se recomienda especificar un prefijo de nombre único.

• 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.

• PLANNING_STATUS: Opcional El estado de planificación de la solicitud de reserva futura, que debe ser uno de los siguientes:

  • Para crear el borrador de una solicitud de reserva futura, especifica DRAFT.

  • Para crear la solicitud de reserva futura y enviarla para su aprobación en Google Cloud, especifica SUBMITTED.

    Precaución: después de enviar una solicitud de reserva futura para su revisión, no podrás volver a cambiar su estado de planificación a DRAFT.

  Si omites el campo planningStatus, su valor se establece en DRAFT.

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

  • Para una plantilla de instancias global: global.

  • 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 se pueden reservar las VMs dentro de la región en la que se encuentra la plantilla de instancias.

• INSTANCE_TEMPLATE_NAME: Es nombre de una plantilla de instancias existente. Si especificas una plantilla de instancias, no puedes anular sus propiedades cuando creas la solicitud de reserva futura. De lo contrario, se encuentran errores.

• TOTAL_COUNT: La cantidad 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.

  Cuando se calcula la cantidad de reservas que se crearán para una reserva futura aprobada, Compute Engine primero verifica las reservas existentes. Si hay reservas existentes que coinciden con la reserva futura aprobada, la cantidad de reservas existentes se resta de la cantidad total solicitada de reservas en la solicitud para determinar la cantidad de reservas nuevas creadas con Compute Engine Para obtener más información, consulta cómo se cuenta y produce recursos reservados con Compute Engine.

  Precaución: Asegúrate de tener suficiente cuota para los recursos que solicitas reservar. De lo contrario, en Google Cloud se rechazará tu solicitud de reserva futura

• START_TIME: La hora de inicio del período de reserva con un formato de marca de tiempo RFC 3339. La hora de inicio no puede ser posterior a 1 año a partir de la fecha y hora en que envías una solicitud de reserva futura para su revisión. Además, asegúrate de especificar un valor recomendado para la hora de inicio para tener el tiempo suficiente antes de que una reserva futura ingrese a su hora de bloqueo.

• 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.

  Importante: Asegúrate de que el período de reserva no se superponga con el período de reserva de otra solicitud de reserva futura existente con las mismas propiedades y zona de VM, y que se haya creado en tu proyecto actual o se comparta con él. De lo contrario, la creación de la solicitud de reserva futura fallará.

Por ejemplo, con el siguiente comando, se crea un borrador de solicitud de reserva futura con la plantilla de instancias global example-template para 80 VMs. La solicitud de reserva futura se comparte con project-1 y project-2. El período de reserva comienza a la medianoche del 10 de noviembre de 2023 a UTC y finaliza a la medianoche del 10 de diciembre de 2023 UTC. Las reservas creadas de forma automática para la reserva futura se crean en la zona us-central1-a, tienen un nombre que comienza con fr-02-reservation y se borran de forma automática a la medianoche del 13 de diciembre de 2023 UTC.

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

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "2023-12-13T00:00:00Z",
  "name": "fr-02",
  "namePrefix": "fr-02-reservation",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/example-project/global/instanceTemplates/example-template",
    "totalCount": "80"
  },
  "planningStatus": "DRAFT",
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2023-11-10T00:00:00Z",
    "endTime": "2023-12-10T00:00:00Z"
  }
}

Especifica las propiedades de la VM de forma directa

Puedes crear una solicitud de reserva futura compartida si especificas las propiedades de forma directa con la consola de Google Cloud, gcloud CLI y REST.

Consola

Para crear una solicitud de reserva futura compartida a través de la especificación directa de las propiedades, sigue estos pasos:

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 el campo Nombre, ingresa un nombre para tu solicitud de reserva futura.

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

   Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, se recomienda especificar un prefijo de nombre único.

6. Opcional: en el campo Descripción, ingresa una descripción para tu solicitud de reserva futura.

7. En el campo Región, elige la región en la que deseas reservar los recursos.

8. En el campo Zona, selecciona la zona en la que deseas reservar los recursos.

9. En el campo Hora de inicio, ingresa una hora de inicio para el período de la reserva. La hora de inicio no puede ser posterior a 1 año a partir de la fecha y hora en que envías una solicitud de reserva futura para su revisión.

   Asegúrate de especificar un valor recomendado para la hora de inicio para tener el tiempo suficiente antes de que la próxima reserva ingrese a su hora de bloqueo.

10. En el campo 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 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.

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

    1. Para especificar una solicitud de reserva futura compartida, haz clic en 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. No selecciones el proyecto actual. De forma predeterminada, ya se pueden utilizar las reservas creadas de forma automática para esta solicitud de reserva futura.

12. En el campo 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.

    Cuando se calcula la cantidad de reservas nuevas que se crearán para una solicitud de reserva futura aprobada poco antes de la hora de inicio, Compute Engine resta cualquier reserva existente que coincida con la solicitud de este total. Para obtener más información, consulta cómo se cuenta y produce recursos reservados con Compute Engine.

    Precaución: asegúrate de tener suficiente cuota para los recursos que solicitas reservar. De lo contrario, en Google Cloud se rechazará tu solicitud de reserva futura

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

    1. Selecciona Especificar tipo de máquina (configuración predeterminada).

    2. Selecciona una de las opciones siguientes:

       • Para cargas de trabajo comunes, haz clic en la pestaña Uso general (predeterminada).

       • Para cargas de trabajo de rendimiento intensivo, haz clic en la pestaña Optimizado para procesamiento.

       • Para las cargas de trabajo de proporciones de memoria a CPU virtuales altas, haz clic en la pestaña Memoria optimizada.

       • Para las cargas de trabajo que usan unidades de procesamiento de gráficos (GPU), haz clic en la pestaña GPUs.

    3. Realice una de las siguientes acciones:

       • Si especificaste Uso general, Optimizado para procesamiento u Optimización de memoria en el paso anterior, haz lo siguiente:

         1. En la lista Series, selecciona una serie de máquinas.

         2. En la sección Tipo de máquina, selecciona un tipo de máquina.

         3. Opcional: Para personalizar aún más la máquina de las VMs que solicitas reservar, expande Configuraciones avanzadas y sigue las indicaciones.

       • Si especificaste GPUs en el paso anterior, haz lo siguiente:

         1. En el menú Tipo de GPU, selecciona un tipo de GPU.

         2. En el menú Cantidad de GPU, selecciona la cantidad.

         3. Opcional: Si el tipo de GPU lo permite y deseas usar los recursos reservados para ejecutar cargas de trabajo de alto contenido gráfico, selecciona la casilla de verificación Habilitar Virtual Workstation (NVIDIA GRID).

         4. En la sección Tipo de máquina, selecciona un tipo de máquina.

         5. En la lista Plataforma de CPU, selecciona una plataforma de CPU para las VMs que solicitas reservar.

    4. Si el tipo de máquina lo permite y deseas agregar SSDs locales, haz lo siguiente (opcional):

       1. En el campo Cantidad de discos, selecciona la cantidad de discos para tus SSDs locales.

       2. En la sección Tipo de interfaz, selecciona una de las siguientes interfaces:

          • SCSI (predeterminada)

          • NVMe

14. 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:

      Precaución: si la opción de eliminación automática está habilitada, todas las reservas creadas de forma automática se borran en el momento de la eliminación especificado, sin importar si se consumen por completo o no.

      1. Haz clic en el botón de activación Habilitar la eliminación automática para llevarlo a la posición activada (predeterminado).

      2. Opcional: en el campo 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 2 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.

15. Realice una de las siguientes acciones:

    • Para crear una solicitud de reserva futura y enviarla para su revisión en Google Cloud, haz clic en Enviar.

      Precaución: asegúrate de que una solicitud de reserva futura esté lista para su revisión antes de enviarla. Una vez que se envía, no puedes volver a la etapa de borrador.

    • Para crear un borrador de solicitud de reserva futura, haz clic en Guardar borrador.

    • Para salir sin guardar, haz clic en Cancelar.

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.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --auto-delete-auto-created-reservations \
    --description="DESCRIPTION" \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --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: El nombre de la solicitud de reserva futura que se creará.

• Opcional: para agregar unidades de procesamiento de gráficos (GPUs) a cada VM reservada, especifica lo siguiente:

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

  • ACCELERATOR_TYPE: Es el tipo de GPU que se agregará a las VMs reservadas.

  Asegúrate de que el tipo de máquina que especifiques en la solicitud de reserva futura admita los tipos de GPU que especifiques y que la GPU esté disponible en la zona en la que quieras reservar los recursos. De lo contrario, tendrás errores.

• DESCRIPTION: Opcional Una descripción nueva para la solicitud de reserva futura.

• INTERFACE_1 y INTERFACE_2: opcional. El tipo de interfaz que deseas que usen los SSDs locales para cada VM. El valor debe ser uno de los siguientes:

  • Si tu imagen de disco de arranque tiene controladores NVMe optimizados, especifica nvme.

  • De lo contrario, especifica scsi.

  Cada SSD local es de 375 GB. Repite la marca --local-ssd para cada SSD local que desees agregar. Puedes especificar un máximo de 24 SSDs locales.

• MACHINE_TYPE: Un tipo de máquina que se usará para cada VM. Especifica uno de los siguientes valores:

  • Para un tipo predefinido de máquina: MACHINE_FAMILY-standard-CPUS

  • Para un tipo personalizado de máquina: MACHINE_FAMILY-custom-CPUS-MEMORY. Antes de especificar un tipo personalizado de máquina, revisa las limitaciones para VMs con tipos personalizados de máquinas.

  Reemplaza lo siguiente:

  • MACHINE_FAMILY: la familia de máquinas.

  • CPUS: Es la cantidad de CPU virtuales.

  • MEMORY: la memoria total para una VM reservada. La memoria debe ser un múltiplo de 256 MB y se debe proporcionar en MB.

  Por ejemplo, para especificar un tipo personalizado de máquina N2 con 4 CPU virtuales y 5 GB de memoria, que son 5,120 MB, especifica n2-custom-4-5120.

• MINIMUM_CPU_PLATFORM: Opcional La plataforma de CPU mínima para usar en cada VM. Si omites la marca --min-cpu-platform, su valor se establece en la plataforma de CPU predeterminada de la zona.

• NAME_PREFIX: El prefijo del nombre de la solicitud de reserva futura. El nombre de cada reserva creada de forma automática para esta solicitud de reserva futura comienza con el prefijo del nombre. Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, se recomienda especificar un prefijo de nombre único.

• PLANNING_STATUS: Opcional El estado de planificación de la solicitud de reserva futura, que debe ser uno de los siguientes:

  • Para crear el borrador de una solicitud de reserva futura, especifica DRAFT.

  • Para crear la solicitud de reserva futura y enviarla para su aprobación en Google Cloud, especifica SUBMITTED.

    Precaución: después de enviar una solicitud de reserva futura para su revisión, no podrás volver a cambiar su estado de planificación a DRAFT.

  Si omites la marca --planning-status, su valor se establece en DRAFT.

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

• CONSUMER_PROJECT_IDS: Una lista separada por comas de los IDs de los proyectos con los que se puede compartir esta solicitud de reserva futura. Por ejemplo, especifica 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ó la solicitud de reserva futura (el proyecto de 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 con el formato de una marca de tiempo RFC 3339, que debe ser la siguiente:

  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 1 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 o antes de que ingrese a la hora de bloqueo, asegúrate de especificar 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, en la que END_DURATION es 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 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.

  Importante: Asegúrate de que el período de reserva no se superponga con el período de reserva de otra solicitud de reserva futura existente con las mismas propiedades y zona de VM, y que se haya creado en tu proyecto actual o se comparta con él. De lo contrario, la creación de la solicitud de reserva futura fallará.

• TOTAL_COUNT: La cantidad 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.

  Cuando se calcula la cantidad de reservas que se crearán para una reserva futura aprobada, Compute Engine primero verifica las reservas existentes. Si hay reservas existentes que coinciden con la reserva futura aprobada, la cantidad de reservas existentes se resta de la cantidad total solicitada de reservas en la solicitud para determinar la cantidad de reservas nuevas creadas con Compute Engine Para obtener más información, consulta cómo se cuenta y produce recursos reservados con Compute Engine.

  Precaución: Asegúrate de tener suficiente cuota para los recursos que solicitas reservar. De lo contrario, en Google Cloud se rechazará tu solicitud de reserva futura

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

Cuando especificas la marca --auto-delete-auto-created-reservations, Compute Engine borra de forma automática las reservas creadas automáticamente para tu solicitud de reserva futura. De forma predeterminada, la hora de eliminación es dentro de las 2 horas posteriores de la hora de finalización del período de reserva. De manera opcional, puedes cambiar esto si realizas una 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:

  Precaución: Si habilitas la opción de eliminación automática, todas las reservas creadas de forma automática se borran en el momento de la eliminación especificado, sin importar si se consumen por completo o no.

  • Para borrar las reservas creadas de forma automática en un momento específico después de la hora de finalización del período de reserva, especifica las marcas --auto-delete-auto-created-reservations y --auto-created-reservations-delete-time.

    gcloud beta compute future-reservations create example-future-reservation \
        --auto-delete-auto-created-reservations \
        --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
        ...
    

    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 después de la hora de finalización del período de reserva, especifica las marcas --auto-delete-auto-created-reservations y --auto-created-reservations-duration.

    gcloud beta compute future-reservations create example-future-reservation \
        --auto-delete-auto-created-reservations \
        --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
        ...
    

    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 1 día, 2 horas, 3 minutos y 4 segundos.

• Para inhabilitar Compute Engine de modo que se borren de forma automática las reservas creadas de forma automática, especifica la marca --no-auto-delete-auto-created-reservations. Debes inhabilitar la opción de eliminación automática si deseas conectar la reserva creada de forma automática a un compromiso.

  gcloud beta compute future-reservations create example-future-reservation \
      --no-auto-delete-auto-created-reservations \
      ...
  

Por ejemplo, con el siguiente comando, se crea un borrador de solicitud de reserva futura para 80 VMs. La solicitud de reserva futura se comparte con project-1 y project-2. El período de reserva comienza a la medianoche del 10 de noviembre de 2023 a UTC y finaliza a la medianoche del 10 de diciembre de 2023 UTC. Las VMs reservadas especifican un tipo de máquina n2-standard-4, una plataforma de CPU mínima skylake y 1 SSD local con la interfaz scsi y 375 GB cada uno. Las reservas creadas de forma automática para la reserva futura se crean en la zona us-central1-a, tienen un nombre que comienza con fr-02-reservation y se borran de forma automática a la medianoche del 13 de diciembre de 2023 UTC. .

gcloud beta compute future-reservations create fr-02 \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=2023-12-13T00:00:00Z \
    --local-ssd=size=375,interface=scsi \
    --machine-type=n2-standard-4 \
    --min-cpu-platform=skylake \
    --name-prefix=fr-02-reservation \
    --planning-status=DRAFT \
    --project=example-project \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --start-time=2023-11-10T00:00:00Z \
    --end-time=2023-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

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.

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

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Reemplaza lo siguiente:

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

• ZONE: Es la zona en la que deseas reservar 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 solicitud de reserva futura, sin importar si se consumen por completo o no. Establece este campo en false si deseas conectar tu reserva creada de forma automática a un compromiso.

  De forma predeterminada, la hora de eliminación es dentro de las 2 horas posteriores de la hora de finalización del período de reserva. Para cambiar esto, realiza una de las siguientes acciones:

  • 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/example-project/zones/us-central1-a/futureReservations
    
    {
      "autoDeleteAutoCreatedReservations": "true",
      "autoCreatedReservationsDeleteTime": "DELETE_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, que debe ser de la siguiente manera:

    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 zona horaria de la hora estándar del Pacífico (PST), especifica -08:00. Como alternativa, para no usar compensación, especifica Z.

  • 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/example-project/zones/us-central1-a/futureReservations
    
    {
      "autoDeleteAutoCreatedReservations": "true",
      "autoCreatedReservationsDuration": {
        "seconds": "DURATION_BEFORE_DELETE"
      },
      ...
    }
    

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

• DESCRIPTION: Opcional Una descripción nueva para la solicitud de reserva futura.

• FUTURE_RESERVATION_NAME: El nombre de la solicitud de reserva futura que se creará.

• NAME_PREFIX: El prefijo del nombre de la solicitud de reserva futura. El nombre de cada reserva creada de forma automática para esta solicitud de reserva futura comienza con el prefijo del nombre. Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, se recomienda especificar un prefijo de nombre único.

• 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.

• PLANNING_STATUS: Opcional El estado de planificación de la solicitud de reserva futura, que debe ser uno de los siguientes:

  • Para crear el borrador de una solicitud de reserva futura, especifica DRAFT.

  • Para crear la solicitud de reserva futura y enviarla para su aprobación en Google Cloud, especifica SUBMITTED.

    Precaución: después de enviar una solicitud de reserva futura para su revisión, no podrás volver a cambiar su estado de planificación a DRAFT.

  Si omites el campo planningStatus, su valor se establece en DRAFT.

• Opcional: para agregar unidades de procesamiento de gráficos (GPUs) a cada VM reservada, especifica lo siguiente:

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

  • ACCELERATOR_TYPE: Es el tipo de GPU que se agregará a las VMs reservadas.

  Asegúrate de que el tipo de máquina que especifiques en la solicitud de reserva futura admita los tipos de GPU que especifiques y que la GPU esté disponible en la zona en la que quieras reservar los recursos. De lo contrario, tendrás errores.

• INTERFACE_1 y INTERFACE_2: opcional. El tipo de interfaz que deseas que usen los SSDs locales para cada VM. El valor debe ser uno de los siguientes:

  • Si tu imagen de disco de arranque tiene controladores NVMe optimizados, especifica NVME.

  • De lo contrario, especifica SCSI.

  Cada SSD local es de 375 GB. Repite la marca --local-ssd para cada SSD local que desees agregar. Puedes especificar un máximo de 24 SSDs locales.

• MACHINE_TYPE: Un tipo de máquina que se usará para cada VM. Especifica uno de los siguientes valores:

  • Para un tipo predefinido de máquina: MACHINE_FAMILY-standard-CPUS

  • Para un tipo personalizado de máquina: MACHINE_FAMILY-custom-CPUS-MEMORY. Antes de especificar un tipo personalizado de máquina, revisa las limitaciones para VMs con tipos personalizados de máquinas.

  Reemplaza lo siguiente:

  • MACHINE_FAMILY: la familia de máquinas.

  • CPUS: Es la cantidad de CPU virtuales.

  • MEMORY: la memoria total para una VM reservada. La memoria debe ser un múltiplo de 256 MB y se debe proporcionar en MB.

  Por ejemplo, para especificar un tipo personalizado de máquina N2 con 4 CPU virtuales y 5 GB de memoria, que son 5,120 MB, especifica n2-custom-4-5120.

• MINIMUM_CPU_PLATFORM: Opcional La plataforma de CPU mínima para usar en cada VM. Si omites la marca --min-cpu-platform, su valor se establece en la plataforma de CPU predeterminada de la zona.

• TOTAL_COUNT: La cantidad 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.

  Cuando se calcula la cantidad de reservas que se crearán para una reserva futura aprobada, Compute Engine primero verifica las reservas existentes. Si hay reservas existentes que coinciden con la reserva futura aprobada, la cantidad de reservas existentes se resta de la cantidad total solicitada de reservas en la solicitud para determinar la cantidad de reservas nuevas creadas con Compute Engine Para obtener más información, consulta cómo se cuenta y produce recursos reservados con Compute Engine.

  Precaución: Asegúrate de tener suficiente cuota para los recursos que solicitas reservar. De lo contrario, en Google Cloud se rechazará tu solicitud de reserva futura

• START_TIME: La hora de inicio del período de reserva con un formato de marca de tiempo RFC 3339. La hora de inicio no puede ser posterior a 1 año a partir de la fecha y hora en que envías una solicitud de reserva futura para su revisión. Además, asegúrate de especificar un valor recomendado para la hora de inicio para tener el tiempo suficiente antes de que una reserva futura ingrese a su hora de bloqueo.

• 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.

  Importante: Asegúrate de que el período de reserva no se superponga con el período de reserva de otra solicitud de reserva futura existente con las mismas propiedades y zona de VM, y que se haya creado en tu proyecto actual o se comparta con él. De lo contrario, la creación de la solicitud de reserva futura fallará.

Por ejemplo, con el siguiente comando, se crea un borrador de solicitud de reserva futura para 80 VMs. La solicitud de reserva futura se comparte con project-1 y project-2. El período de reserva comienza a la medianoche del 10 de noviembre de 2023 a UTC y finaliza a la medianoche del 10 de diciembre de 2023 UTC. Las VMs reservadas especifican un tipo de máquina n2-standard-4, una plataforma de CPU mínima skylake y 1 SSD local con la interfaz SCSI y 375 GB cada uno. Las reservas creadas de forma automática para la reserva futura se crean en la zona us-central1-a, tienen un nombre que comienza con fr-02-reservation y se borran de forma automática a la medianoche del 13 de diciembre de 2023 UTC. .

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

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "2023-12-13T00:00:00Z",
  "name": "fr-02",
  "namePrefix": "fr-02-reservation",
  "specificSkuProperties": { 
    "instanceProperties": {
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "SCSI"
        }
      ],
      "machineType": "n2-standard-4",
      "minCpuPlatform": "Skylake"
    },
    "totalCount": "80"
  },
  "planningStatus": "DRAFT",
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2023-11-10T00:00:00Z",
    "endTime": "2023-12-10T00:00:00Z"
  }
}

Envía un borrador de solicitud de reserva futura para su revisión

Puedes enviar un borrador de solicitud de reserva futura a Google Cloud para su revisión mediante la consola de Google Cloud, gcloud CLI y REST. Si también deseas modificar una o más propiedades cuando envías el borrador de la solicitud de reserva futura para su revisión, consulta Modifica un borrador o una solicitud de reserva futura rechazada.

Consola

Para enviar un borrador de solicitud de reserva futura, sigue estos pasos:

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 de detalles del borrador de la solicitud de reserva futura.

5. Para enviar el borrador de solicitud de reserva futura a Google Cloud, 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 \
    --project=PROJECT_ID \
    --zone=ZONE

Reemplaza lo siguiente:

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

• 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.

REST

Para enviar un borrador de solicitud de reserva futura, realiza una solicitud PATCH al método beta.futureReservations.update con el campo planningStatus configurado 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, puedes hacer lo siguiente:

• Para supervisar el estado de adquisición de la solicitud y ver si Google Cloud aprobó o rechazó tu solicitud, consulta los detalles de tu solicitud de reserva futura.

• Para evitar que Google Cloud revise tu solicitud y evitar que Compute Engine aprovisione la capacidad solicitada, cancela o borra tu solicitud de reserva futura

Solución de problemas

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

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?

• Aprende cómo ver solicitudes de reserva futuras.

• Obtén información para cambiar, cancelar o borrar solicitudes de reserva futuras.

• Después de llegar a la hora de inicio del período de reserva, obtén información para utilizar las reservas creadas de forma automática.