Modificar, cancelar o borrar futuras solicitudes de reserva


En este documento, se explica cómo administrar las solicitudes de reserva futuras. En particular, haz lo siguiente:

  • Modificar un borrador o una solicitud de reserva futura enviada para cambiar una o más de sus propiedades

  • Cancela una solicitud de reserva futura para evitar que Google Cloud la revise o impida que ingrese una hora de bloqueo para una reserva futura aprobada.

  • Borra una reserva futura antes de que ingrese al tiempo de bloqueo requerido o después de que finalice el período de la reserva.

Si deseas administrar las reservas creadas de forma automática para una reserva futura completada después del final de su período de reserva, consulta lo siguiente:

Antes de comenzar

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

    Selecciona la pestaña para saber cómo planeas usar las muestras en esta página:

    Consola

    Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud, no necesitas configurar la autenticación.

    gcloud

    1. Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando:

      gcloud init
    2. Configura una región y una zona predeterminadas.

    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.

      Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando:

      gcloud init

Funciones obligatorias

Para obtener los permisos que necesitas modificar, cancelar o borrar tus solicitudes de reserva futuras, pídele a tu administrador que te otorgue el administrador de reserva futura de Compute (roles/compute.futureReservationAdmin) rol de IAM en el proyecto. Para obtener más información sobre cómo otorgar funciones, consulta Administra el acceso.

Esta función predefinida contiene los permisos necesarios para modificar, cancelar o borrar tus solicitudes de reserva futuras. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para modificar, cancelar o borrar tus solicitudes de reserva futuras:

  • Para cancelar una reserva futura, usa compute.futureReservations.cancel en el proyecto
  • Para borrar una reserva futura, usa compute.futureReservations.delete en el proyecto.
  • Para modificar una reserva futura, usa compute.futureReservations.update en el proyecto.

También puedes obtener estos permisos con funciones personalizadas o con otras funciones predefinidas.

Restricciones

Además de las restricciones generales para las reservas futuras, cuando modificas, cancelas o borras solicitudes de reserva futuras, se aplican las siguientes restricciones:

  • Solo puedes modificar, cancelar o borrar una solicitud de reserva futura desde el proyecto en el que se creó la solicitud de reserva futura. Esto te permite compartir una solicitud de reserva futura con otros proyectos, pero los usuarios con permisos solo para otros proyectos no pueden modificar la solicitud de reserva futura.

  • Solo puedes modificar, cancelar o borrar una solicitud de reserva futura si su estado de adquisición lo permite. Para obtener más información, consulta la siguiente tabla:

    Estado de la adquisición Cancelar Borrar Modificar
    En borrador (DRAFTING)
    Aprobación pendiente (PENDING_APPROVAL)
    Aprobado (APPROVED)
    Rechazado (DECLINED)
    Cancelados (CANCELED)
    Obteniéndose (PROCURING)
    Suministro (PROVISIONING)
    Entregado (FULFILLED) *
    Parcialmente entregados (FAILED_PARTIALLY_FULFILLED) *
    Con errores (FAILED) *

    * Puedes borrar una reserva futura completada, parcialmente completada o con errores solo después de su hora de finalización.

Modifica solicitudes de reserva futuras

Puedes modificar una solicitud de reserva futura antes de que alcance el estado de adquisición Adquirido (PROVISIONING), siempre que no se cancele o esté pendiente de aprobación. Cuando modificas una solicitud de reserva futura, no puedes cambiar las siguientes propiedades:

  • Para cualquier reserva futura:

    • El nombre de la reserva futura.

    • El proyecto en el que se creó la solicitud de reserva futura.

    • : Es la zona en la que se encuentra la reserva.

  • Para solicitudes de reserva futuras creadas mediante la especificación de una plantilla de instancias:

    • No puedes anular las propiedades de la VM especificadas en la plantilla de instancias.

    • No puedes reemplazar la plantilla de instancias que se usa para crear una solicitud de reserva futura con otra plantilla.

Para modificar cualquiera de estas propiedades, debes crear una solicitud de reserva futura nueva con las actualizaciones deseadas.

Si deseas modificar otras propiedades, selecciona uno de los siguientes métodos:

  • Modifica un borrador o una solicitud de reserva futura rechazada.

    En esta sección, se explica cómo modificar una solicitud de reserva futura con un estado de adquisición establecido como Borrador (DRAFTING) o Rechazado (DECLINED).

  • Modifica una reserva futura aprobada o en curso.

    En esta sección, se explica cómo modificar una reserva futura con un estado de adquisición establecido como Aprobado (APPROVED) o Adquirido (PROCURING). Si deseas modificar la opción de eliminación automática, la descripción o el prefijo de nombre de una reserva futura, puedes modificarlos sin revisión. De lo contrario, si deseas modificar otras propiedades, necesitas la aprobación de Google Cloud.

Modifica un borrador o una solicitud de reserva futura rechazada

Si modificas un borrador de solicitud de reserva futura, puedes guardar los cambios o enviar la solicitud de reserva futura actualizada a Google Cloud. Si modificas una solicitud de reserva futura rechazada, debes enviar la solicitud para su revisión.

Para modificar las propiedades de un borrador o una solicitud de reserva futura rechazada, selecciona uno de los siguientes métodos:

Modifica un borrador o una reserva futura rechazada mediante la especificación de una plantilla de instancias

Para una solicitud de reserva futura creada a través de la especificación de una plantilla de instancias con un estado de adquisición de Borrador (DRAFTING) o Rechazado (DECLINED), puedes modificar las siguientes propiedades:

  • Eliminación automática

  • Descripción

  • Prefijo del nombre

  • Configuración de uso compartido

  • Hora de inicio y finalización del período de reserva

  • Recuento total (cantidad de VM)

Puedes modificar un borrador o una solicitud de reserva futura rechazado que se creó si especificas una plantilla de instancias con la consola de Google Cloud, gcloud CLI y REST.

Consola

Para solicitar a través de Google Cloud que se modifique un borrador o una solicitud de reserva futura rechazada mediante 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. En la columna Nombre, haz clic en el nombre de la solicitud de reserva futura que deseas modificar.

    Se abrirá la página de detalles de la solicitud de reserva futura seleccionada.

  4. Para modificar la solicitud de reserva futura, haz clic en Editar o Editar borrador.

    Se abrirá la página para editar la solicitud de reserva futura seleccionada.

  5. Tener conocimiento sobre uno o más de los siguientes temas:

    • En el campo Prefijo, ingresa un prefijo de nombre nuevo.

    • En el campo Descripción, ingresa una descripción nueva.

    • Modifica la Hora de inicio o la Hora de finalización de la solicitud de reserva futura. Asegúrate de que se den las siguientes condiciones:

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

      • Especifica un valor recomendado para la hora de inicio a fin de asegurarte de que tienes tiempo suficiente antes de que tu reserva futura ingrese a la hora de bloqueo.

      • Especifica un período de reserva mínimo recomendado para aumentar la probabilidad de que con Google Cloud se apruebe tu solicitud después de enviarla para su revisión.

    • En la sección Tipo de recurso compartido, puedes seleccionar Local o Compartido. Si seleccionas Compartido, puedes agregar o quitar proyectos para compartir la solicitud de reserva futura.

      Puedes seleccionar 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 consumir las reservas creadas de forma automática para esta solicitud de reserva futura.

    • 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 que se crearán para una reserva futura aprobada, primero se verifica con Compute Engine 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.

    • En la sección Reservas generadas automáticamente, puedes habilitar o inhabilitar la eliminación automática de las reservas creadas de forma automática para tu solicitud de reserva futura.

      Opcional. Si habilitas la opción de eliminación automática, puedes especificar la fecha y la hora en que Compute Engine borra 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.

  6. Según el estado de adquisición de la solicitud de reserva futura que modificas, realiza una de las siguientes acciones:

    • Para un borrador de solicitud de reserva futura, selecciona una de las siguientes opciones:

      • Para guardar los cambios, haz clic en Guardar.

      • Si deseas enviar el borrador de una solicitud de reserva futura a Google Cloud para su revisión, haz clic en Enviar.

    • En el caso de una solicitud de reserva futura rechazada, solo puedes enviarla para su revisión si haces clic en Enviar.

      Si envías una solicitud, se abrirá la página Reservas. De lo contrario, se abrirá la página de detalles de la solicitud de reserva futura.

gcloud

Para solicitar que se modifique un borrador o una solicitud de reserva futura con Google Cloud y creada mediante la especificación de una plantilla de instancias, usa el comando gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=SHARE_SETTING \
    --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 un borrador existente o una solicitud de reserva futura rechazada.
  • DESCRIPTION: Opcional Una descripción nueva para la solicitud de reserva futura.
  • NAME_PREFIX: Opcional Un nuevo prefijo de nombre para 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: Es el estado de planificación de la solicitud de reserva futura. Solo puedes especificar SUBMITTED que envía la solicitud de reserva futura a Google Cloud para su revisión.

  • PROJECT_ID: Opcional El ID del proyecto en el que se creó la solicitud de reserva futura. Si modificas una solicitud de reserva futura de un solo proyecto en una solicitud de reserva futura compartida, este proyecto se convierte en el proyecto propietario de la solicitud de reserva futura. Si omites la marca --project, el valor se establece en el ID del proyecto actual.
  • SHARE_SETTING: Opcional Para cambiar el tipo de solicitud de reserva futura, especifica uno de los siguientes valores:

    • Para cambiar una solicitud de reserva futura de un solo proyecto a una solicitud de reserva futura compartida, especifica projects. Asegúrate de especificar al menos un proyecto de consumidor en la marca --share-with. De lo contrario, la modificación de la reserva futura fallará.

    • De lo contrario, especifica local.

  • CONSUMER_PROJECT_IDS: Opcional Una lista separada por comas de los ID 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ó esta solicitud de reserva futura (el proyecto propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se pueden consumir las reservas creadas de forma automática para esta solicitud de reserva futura.

  • START_TIME: Opcional La hora de inicio del período de reserva con el formato de 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. A fin de tener tiempo suficiente para cancelar, borrar o modificar una reserva futura de forma opcional después de que se apruebe o antes de que ingrese a la hora de bloqueo, asegúrate de especificar una hora de inicio recomendada. .

  • END_TIME: Opcional : 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.

  • TOTAL_COUNT: Opcional : 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: La zona en la que se encuentra la solicitud de reserva futura.

También puedes cambiar si con Compute Engine se borran de forma automática las reservas creadas de forma automática para una solicitud de reserva futura si realizas una de las siguientes acciones:

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

    • Para borrar las reservas dentro de las 2 horas posteriores a la hora de finalización (predeterminada), especifica la marca --auto-delete-auto-created-reservations.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations
      
    • 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 update 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 update 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.

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

Por ejemplo, considera un borrador de solicitud de reserva futura compartida con el nombre fr-03 y ubicada en la zona us-central1-a. Supongamos que deseas modificar esta solicitud de reserva futura compartida mediante los siguientes cambios:

  • Convertirlo en una solicitud de reserva futura de un solo proyecto

  • Inhabilita la opción de eliminación automática.

  • Reserva 100 VM.

  • Envía la solicitud de reserva futura a Google Cloud para su aprobación.

Para modificar fr-03, ejecuta el siguiente comando:

gcloud beta compute future-reservations update fr-03 \
    --clear-share-settings \
    --no-auto-delete-auto-created-reservations \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=100 \
    --zone=us-central1-a

REST

Para solicitar que se modifique un borrador o una solicitud de reserva futura rechazada con Google Cloud y mediante la especificación de una plantilla de instancias, haz una PATCH solicitud al método beta.futureReservations.update. En el parámetro de búsqueda updateMask, especifica cada campo que deseas actualizar. Si necesitas borrar un campo opcional de tu reserva, incluye ese campo en el parámetro de consulta updateMask y omite ese campo del cuerpo de la solicitud.

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

{
  "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": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

Reemplaza lo siguiente:

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

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

  • FUTURE_RESERVATION_NAME: El nombre de un borrador existente o una solicitud de reserva futura rechazada. No puedes modificar el nombre de una solicitud de reserva futura.

  • UPDATE_FIELDS: Una lista de campos separados por comas que se actualizarán en esta solicitud PATCH. Debes codificar cada coma como %2C. Por ejemplo, si deseas actualizar los campos autoDeleteAutoCreatedReservations, totalCount y endTime en tu solicitud de reserva futura, especifica lo siguiente: haz lo siguiente:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
    
  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Opcional Si configuras este campo como true, se borra de forma automática a través de Compute Engine las reservas creadas de forma automática para esta solicitud de reserva de reserva futura. De forma predeterminada, la hora de eliminación se encuentra dentro de las 2 horas después 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 de la hora de finalización de tu período de reserva, configura autoDeleteAutoCreatedReservations como true y especifica el campo autoCreatedReservationsDeleteTime.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME"
      }
      

      Reemplaza DELETE_TIME por una fecha y hora en la que se borren las reservas con Compute Engine 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 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.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
      
      {
        "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 Para actualizar la descripción de esta solicitud de reserva futura, realiza una de las siguientes acciones:

    • Para agregar o actualizar una descripción, especifica una descripción.

    • Para quitar la descripción, borra el campo description del cuerpo de la solicitud y especifícalo en UPDATE_FIELDS.

  • NAME_PREFIX: Opcional Un nuevo prefijo de nombre para 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: Es el estado de planificación de la solicitud de reserva futura. Solo puedes especificar SUBMITTED que envía la solicitud de reserva futura a Google Cloud para su revisión.

  • SHARE_TYPE: Opcional Para cambiar el tipo de recurso compartido de esta solicitud de reserva futura, especifica uno de los siguientes valores:

    • Para cambiar una solicitud de reserva futura de un solo proyecto a una solicitud de reserva futura compartida, especifica SPECIFIC_PROJECTS. Además, debes especificar al menos un proyecto de consumidor en el campo projects. De lo contrario, la creación de la solicitud de reserva futura fallará.

    • De lo contrario, especifica LOCAL. Además, debes borrar el campo projects del cuerpo de la solicitud y especificarlo en UPDATE_FIELDS. De lo contrario, la creación de la solicitud de reserva futura fallará.

  • CONSUMER_PROJECT_ID_1 y CONSUMER_PROJECT_ID_2: opcional. Los ID de los proyectos con los que se puede compartir una 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ó la solicitud de reserva futura (el proyecto de propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se pueden consumir las reservas creadas de forma automática para esta solicitud de reserva futura.

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

  • START_TIME: Opcional La nueva hora de inicio del período de reserva con 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 una hora de inicio recomendada para garantizar que tienes tiempo suficiente antes de que una reserva futura ingrese a la hora de bloqueo.

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

    "duration": {
      "seconds": "END_DURATION"
    }
    

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

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

Por ejemplo, considera un borrador de solicitud de reserva futura compartida con el nombre fr-03 y ubicada en la zona us-central1-a. Supongamos que deseas modificar esta solicitud de reserva futura compartida mediante los siguientes cambios:

  • Convertirlo en una solicitud de reserva futura de un solo proyecto

  • Inhabilita la opción de eliminación automática.

  • Reserva 100 VM.

  • Envía la solicitud de reserva futura a Google Cloud para su aprobación.

Para modificar fr-03, realiza la siguiente solicitud PATCH:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount

{
  "autoDeleteAutoCreatedReservations": "false",
  "name": "fr-03",
  "planningStatus": "SUBMITTED",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "totalCount": "100"
  }
}

Después de enviar una solicitud de reserva futura a Google Cloud para su revisión, consulta los detalles para supervisar su estado de adquisición.

Modifica un borrador o una reserva futura rechazada mediante la especificación directa de las propiedades

Para una solicitud de reserva futura que crean las propiedades directamente con un estado de adquisición establecido en Borrador (DRAFTING) o Rechazado (DECLINED), puedes modificar las siguientes propiedades:

  • Eliminación automática

  • Descripción

  • Prefijo del nombre

  • GPU

  • SSD locales y el tipo de interfaz de disco

  • Series y tipos de máquinas

  • Plataforma de CPU mínima

  • Configuración de uso compartido

  • Hora de inicio y finalización del período de reserva

  • Recuento total (cantidad de VM)

Puedes modificar un borrador o una solicitud de reserva futura rechazada que se creó si especificaste las propiedades directamente con la consola de Google Cloud, gcloud CLI y REST.

Consola

Para solicitar que se modifique un borrador o una solicitud de reserva futura rechazada con Google Cloud y mediante 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. En la columna Nombre, haz clic en el nombre de la solicitud de reserva futura que deseas modificar.

    Se abrirá la página de detalles de la solicitud de reserva futura seleccionada.

  4. Para modificar la solicitud de reserva futura, haz clic en Editar o Editar borrador.

    Se abrirá la página para editar la solicitud de reserva futura seleccionada.

  5. Tener conocimiento sobre uno o más de los siguientes temas:

    • En el campo Prefijo, ingresa un prefijo de nombre nuevo.

    • En el campo Descripción, ingresa una descripción nueva.

    • Modifica la Hora de inicio o la Hora de finalización de la solicitud de reserva futura. Asegúrate de que se den las siguientes condiciones:

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

      • Especifica un valor recomendado para la hora de inicio a fin de asegurarte de que tienes tiempo suficiente antes de que tu reserva futura ingrese a la hora de bloqueo.

      • Especifica un período de reserva mínimo recomendado para aumentar la probabilidad de que con Google Cloud se apruebe tu solicitud después de enviarla para su revisión.

    • En la sección Tipo de recurso compartido, puedes seleccionar Local o Compartido. Si seleccionas Compartido, puedes agregar o quitar proyectos para compartir la solicitud de reserva futura.

      Puedes seleccionar 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 consumir las reservas creadas de forma automática para esta solicitud de reserva futura.

    • 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 que se crearán para una reserva futura aprobada, primero se verifica con Compute Engine 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.

    • En la sección Configuración de máquina, puedes cambiar lo siguiente:

      • La serie de máquinas y el tipo de máquina que se usa en las VMs reservadas.

      • Las GPU que se adjuntarán a las VM reservadas

      • Los SSD locales y el tipo de interfaz de disco de las VM reservadas

  6. Según el estado de adquisición de la solicitud de reserva futura que modificas, realiza una de las siguientes acciones:

    • Para un borrador de solicitud de reserva futura, selecciona una de las siguientes opciones:

      • Para guardar los cambios, haz clic en Guardar.

      • Si deseas enviar el borrador de una solicitud de reserva futura a Google Cloud para su revisión, haz clic en Enviar.

    • En el caso de una solicitud de reserva futura rechazada, solo puedes enviarla para su revisión si haces clic en Enviar.

      Si envías una solicitud, se abrirá la página Reservas. De lo contrario, se abrirá la página de detalles de la solicitud de reserva futura.

gcloud

Para solicitar a Google Cloud que modifique un borrador o una solicitud de reserva futura creada mediante la especificación directa de las propiedades, usa el gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --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=SHARE_SETTING \
    --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 un borrador existente o una solicitud de reserva futura rechazada.
  • Opcional. Realice una de las siguientes acciones:

    • Para agregar unidades de procesamiento de gráficos (GPU) 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.

    • Para quitar todas las GPU de esta solicitud de reserva futura, reemplaza la marca --accelerator por la marca --clear-accelerator.

  • DESCRIPTION: Opcional Una descripción nueva para la solicitud de reserva futura.
  • Opcional. Realice una de las siguientes acciones:

    • Para agregar o editar el tipo de interfaz que deseas que usen los SSD locales para cada VM, reemplaza INTERFACE_1 y INTERFACE_2. El valor debe ser uno de los siguientes:

      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.

    • Para quitar todos los SSD locales de esta reserva de solicitud futura, quita todas las marcas --local-ssd y especifica la marca --clear-local-ssd.

  • MACHINE_TYPE: Opcional Un tipo de máquina predefinido o personalizado para usar en cada VM. Antes de especificar un tipo personalizado de máquina, revisa las limitaciones para VMs con tipos personalizados de máquinas.

  • 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: Opcional Un nuevo prefijo de nombre para 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: Es el estado de planificación de la solicitud de reserva futura. Solo puedes especificar SUBMITTED que envía la solicitud de reserva futura a Google Cloud para su revisión.

  • PROJECT_ID: Opcional El ID del proyecto en el que se creó la solicitud de reserva futura. Si modificas una solicitud de reserva futura de un solo proyecto en una solicitud de reserva futura compartida, este proyecto se convierte en el proyecto propietario de la solicitud de reserva futura. Si omites la marca --project, el valor se establece en el ID del proyecto actual.
  • SHARE_SETTING: Opcional Para cambiar el tipo de solicitud de reserva futura, especifica uno de los siguientes valores:

    • Para cambiar una solicitud de reserva futura de un solo proyecto a una solicitud de reserva futura compartida, especifica projects. Asegúrate de especificar al menos un proyecto de consumidor en la marca --share-with. De lo contrario, la modificación de la reserva futura fallará.

    • De lo contrario, especifica local.

  • CONSUMER_PROJECT_IDS: Opcional Una lista separada por comas de los ID 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ó esta solicitud de reserva futura (el proyecto propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se pueden consumir las reservas creadas de forma automática para esta solicitud de reserva futura.

  • START_TIME: Opcional La hora de inicio del período de reserva con el formato de 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. A fin de tener tiempo suficiente para cancelar, borrar o modificar una reserva futura de forma opcional después de que se apruebe o antes de que ingrese a la hora de bloqueo, asegúrate de especificar una hora de inicio recomendada. .

  • END_TIME: Opcional : 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.

  • TOTAL_COUNT: Opcional : 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: La zona en la que se encuentra la solicitud de reserva futura.

También puedes cambiar si con Compute Engine se borran de forma automática las reservas creadas de forma automática para una solicitud de reserva futura si realizas una de las siguientes acciones:

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

    • Para borrar las reservas dentro de las 2 horas posteriores a la hora de finalización (predeterminada), especifica la marca --auto-delete-auto-created-reservations.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations
      
    • 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 update 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 update 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.

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

Por ejemplo, considera un borrador de solicitud de reserva futura compartida con el nombre fr-03 y ubicada en la zona us-central1-a. Supongamos que deseas modificar esta solicitud de reserva futura compartida mediante los siguientes cambios:

  • Convertirlo en una solicitud de reserva futura de un solo proyecto

  • Inhabilita la opción de eliminación automática.

  • Reserva 100 VM.

  • Envía la solicitud de reserva futura a Google Cloud para su aprobación.

Para modificar fr-03, ejecuta el siguiente comando:

gcloud beta compute future-reservations update fr-03 \
    --clear-share-settings \
    --no-auto-delete-auto-created-reservations \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=100 \
    --zone=us-central1-a

REST

Para solicitar que se modifique un borrador o una solicitud de reserva futura rechazada con Google Cloud mediante la especificación directa de las propiedades, haz lo siguiente:PATCH solicitud a labeta.futureReservations.update método. En el parámetro de búsqueda updateMask, especifica cada campo que deseas actualizar. Si necesitas borrar un campo opcional de tu reserva, incluye ese campo en el parámetro de consulta updateMask y omite ese campo del cuerpo de la solicitud.

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

{
  "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": "SHARE_TYPE"
  },
  "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": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

Reemplaza lo siguiente:

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

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

  • FUTURE_RESERVATION_NAME: El nombre de un borrador existente o una solicitud de reserva futura rechazada. No puedes modificar el nombre de una solicitud de reserva futura.

  • UPDATE_FIELDS: Una lista de campos separados por comas que se actualizarán en esta solicitud PATCH. Debes codificar cada coma como %2C. Por ejemplo, si deseas actualizar los campos autoDeleteAutoCreatedReservations, totalCount y endTime en tu solicitud de reserva futura, especifica lo siguiente: haz lo siguiente:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
    
  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Opcional Si configuras este campo como true, se borra de forma automática a través de Compute Engine las reservas creadas de forma automática para esta solicitud de reserva de reserva futura. De forma predeterminada, la hora de eliminación se encuentra dentro de las 2 horas después 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 de la hora de finalización de tu período de reserva, configura autoDeleteAutoCreatedReservations como true y especifica el campo autoCreatedReservationsDeleteTime.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME"
      }
      

      Reemplaza DELETE_TIME por una fecha y hora en la que se borren las reservas con Compute Engine 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 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.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
      
      {
        "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 Para actualizar la descripción de esta solicitud de reserva futura, realiza una de las siguientes acciones:

    • Para agregar o actualizar una descripción, especifica una descripción.

    • Para quitar la descripción, borra el campo description del cuerpo de la solicitud y especifícalo en UPDATE_FIELDS.

  • NAME_PREFIX: Opcional Un nuevo prefijo de nombre para 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: Es el estado de planificación de la solicitud de reserva futura. Solo puedes especificar SUBMITTED que envía la solicitud de reserva futura a Google Cloud para su revisión.

  • SHARE_TYPE: Opcional Para cambiar el tipo de recurso compartido de esta solicitud de reserva futura, especifica uno de los siguientes valores:

    • Para cambiar una solicitud de reserva futura de un solo proyecto a una solicitud de reserva futura compartida, especifica SPECIFIC_PROJECTS. Además, debes especificar al menos un proyecto de consumidor en el campo projects. De lo contrario, la creación de la solicitud de reserva futura fallará.

    • De lo contrario, especifica LOCAL. Además, debes borrar el campo projects del cuerpo de la solicitud y especificarlo en UPDATE_FIELDS. De lo contrario, la creación de la solicitud de reserva futura fallará.

  • CONSUMER_PROJECT_ID_1 y CONSUMER_PROJECT_ID_2: opcional. Los ID de los proyectos con los que se puede compartir una 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ó la solicitud de reserva futura (el proyecto de propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se pueden consumir las reservas creadas de forma automática para esta solicitud de reserva futura.

  • Opcional. Para actualizar las unidades de procesamiento de gráficos (GPU) conectadas a cada VM reservada, realiza una de las siguientes acciones:

    • Para agregar o modificar GPU, 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.

    • Para quitar todas las GPU de esta solicitud de reserva futura, borra el campo guestAccelerators del cuerpo de la solicitud y especifícalo en UPDATE_FIELDS.

  • Opcional. Para actualizar las SSD locales conectadas a cada VM reservada, realiza una de las siguientes acciones:

    • Para agregar o editar el tipo de interfaz que deseas que usen los SSD locales para cada VM, reemplaza INTERFACE_1 y INTERFACE_2. El valor debe ser uno de los siguientes:

      Repite los campos diskSizeGb y interface para cada SSD local que desees agregar o actualizar. Puedes especificar un máximo de 24 SSDs locales.

    • Para quitar todos los SSD locales de esta reserva de solicitud futura, borra el campo localSsds del cuerpo de la solicitud y especifícalo en UPDATE_FIELDS.

  • MACHINE_TYPE: Opcional Un tipo de máquina predefinido o personalizado para usar en cada VM. Antes de especificar un tipo personalizado de máquina, revisa las limitaciones para VMs con tipos personalizados de máquinas.

  • MINIMUM_CPU_PLATFORM: Opcional A fin de actualizar la plataforma de CPU mínima para usar en cada VM, realiza una de las siguientes acciones:

    • Para agregar o actualizar la plataforma de CPU mínima, especifica una plataforma de CPU mínima.

    • Para volver a la plataforma de CPU predeterminada de la zona, borra el campo minCpuPlatform del cuerpo de la solicitud y especifícalo en UPDATE_FIELDS.

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

  • START_TIME: Opcional La nueva hora de inicio del período de reserva con 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 una hora de inicio recomendada para garantizar que tienes tiempo suficiente antes de que una reserva futura ingrese a la hora de bloqueo.

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

    "duration": {
      "seconds": "END_DURATION"
    }
    

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

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

Por ejemplo, considera un borrador de solicitud de reserva futura compartida con el nombre fr-03 y ubicada en la zona us-central1-a. Supongamos que deseas modificar esta solicitud de reserva futura compartida mediante los siguientes cambios:

  • Convertirlo en una solicitud de reserva futura de un solo proyecto

  • Inhabilita la opción de eliminación automática.

  • Reserva 100 VM.

  • Envía la solicitud de reserva futura a Google Cloud para su aprobación.

Para modificar fr-03, realiza la siguiente solicitud PATCH:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount

{
  "autoDeleteAutoCreatedReservations": "false",
  "name": "fr-03",
  "planningStatus": "SUBMITTED",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "totalCount": "100"
  }
}

Después de enviar una solicitud de reserva futura a Google Cloud para su revisión, consulta los detalles para supervisar su estado de adquisición.

Modifica una reserva futura aprobada o en curso

Para modificar las propiedades de una reserva futura aprobada o en curso, selecciona uno de los siguientes métodos:

  • Modifica una reserva futura aprobada o en curso sin revisión.

    En esta sección, se explica cómo modificar la opción de eliminación automática, la descripción y el prefijo de nombre en una reserva futura aprobada o en proceso de revisión. La modificación de estas propiedades es inmediata y no hay límites para la cantidad de veces que puedes cambiarlas hasta que Google Cloud comience a crear las reservas.

  • Solicitud de una modificación de una reserva futura aprobada o en curso.

    En esta sección, se explica cómo solicitar a Google Cloud que modifique una o más propiedades en una reserva futura aprobada o en curso. Solo puedes enviar una solicitud para modificar una reserva futura con un estado de Adquirida (PROCURING).

Modifica una reserva futura aprobada o en proceso de adquisición sin revisión

Para una reserva futura con un estado de adquisición establecido en Aprobado (APPROVED) o Adquirido (PROCURING), puedes modificar los siguientes campos sin aprobación de Google Cloud:

  • Eliminación automática

  • Descripción

  • Prefijo del nombre

La modificación de estas propiedades es inmediata. Hasta la hora de inicio del período de reserva de una reserva futura, no hay límites para la cantidad de veces que puedes modificar estas propiedades.

Puedes modificar una reserva futura aprobada o en curso sin revisión con la consola de Google Cloud, gcloud CLI y REST.

Consola

Para modificar una reserva futura aprobada o en proceso de adquisición sin revisión, 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 la reserva futura que deseas modificar.

    Se abrirá la página de detalles de la reserva futura seleccionada.

  4. Si deseas modificar la opción de eliminación automática y la descripción de una reserva futura, realiza una o más de las siguientes acciones:

    • En la fila Tiempo de eliminación automática de reservas creadas de forma automática, haz clic en Editar y, luego, sigue estos pasos:

      1. Realice una de las siguientes acciones:

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

          1. Haz clic en el botón de activación Habilitar la eliminación automática.

          2. Opcional: En el campo Hora de borrado automático, 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 a la posición desactivada.

      2. Haz clic en Enviar.

    • En la fila Prefijo, haz clic en Editar y, luego, haz lo siguiente:

      1. En el campo Prefijo, ingresa un prefijo de nombre nuevo.

      2. Haz clic en Enviar.

    • En la fila Descripción, haz clic en Editar y, luego, haz lo siguiente:

      1. En el campo Descripción, ingresa una descripción nueva.

      2. Haz clic en Enviar.

gcloud

Para modificar una reserva aprobada o que adquiera recursos sin revisión, usa el comando gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --project=PROJECT_ID \
    --zone=ZONE

Reemplaza lo siguiente:

  • FUTURE_RESERVATION_NAME: El nombre de una reserva futura aprobada o adquirida
  • DESCRIPTION: Opcional Una descripción nueva para la reserva futura.
  • NAME_PREFIX: Opcional Un prefijo de nombre nuevo para la reserva futura. El nombre de cada reserva creada de forma automática para esta 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.
  • PROJECT_ID: Opcional El ID del proyecto en el que se creó la reserva futura.
  • ZONE: Es la zona en la que se encuentra la reserva.

De manera opcional, también puedes cambiar si quieres borrar de forma automática las reservas creadas de forma automática para una reserva futura con Compute Engine si realizas una de las siguientes acciones:

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

    • Para borrar las reservas dentro de las 2 horas posteriores a la hora de finalización (predeterminada), especifica la marca --auto-delete-auto-created-reservations.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations
      
    • 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 update 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 update 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.

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

Por ejemplo, considera una reserva futura aprobada llamada fr-04 y ubicada en la zona us-central1-a. Supongamos que deseas modificar esta reserva futura con los siguientes cambios:

  • Habilita la opción de eliminación automática.

  • Borra de forma automática las reservas creadas automáticamente después de 864,000 segundos (10 días).

  • Especifica un nuevo prefijo de nombre.

Para modificar fr-04, ejecuta el siguiente comando:

gcloud beta compute future-reservations update fr-04 \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=864000 \
    --name-prefix=new-prefix \
    --project=example-project \
    --zone=us-central1-a

REST

Para modificar una reserva aprobada o adquirida sin revisión, haz unaPATCH solicitud a labeta.futureReservations.update método. En el parámetro de búsqueda updateMask, especifica cada campo que deseas actualizar. Si necesitas borrar un campo opcional de tu reserva, incluye ese campo en el parámetro de consulta updateMask y omite ese campo del cuerpo de la solicitud.

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

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX"
}

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto en el que se encuentra la reserva futura.

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

  • FUTURE_RESERVATION_NAME: El nombre de una reserva futura aprobada o adquirida No puedes modificar el nombre de una reserva futura.

  • UPDATE_FIELDS: Una lista de campos separados por comas que se actualizarán en esta solicitud PATCH. Debes codificar cada coma como %2C. Por ejemplo, si deseas actualizar los campos description y namePrefix en tu reserva futura, especifica lo siguiente:

    description%2CnamePrefix
    

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Opcional Si configuras este campo como true, con Compute Engine podrás borrar de forma automática las reservas creadas de forma automática para esta reserva de reserva futura. De forma predeterminada, la hora de eliminación se encuentra dentro de las 2 horas después 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 de la hora de finalización de tu período de reserva, configura autoDeleteAutoCreatedReservations como true y especifica el campo autoCreatedReservationsDeleteTime.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME"
      }
      

      Reemplaza DELETE_TIME por una fecha y hora en la que se borren las reservas con Compute Engine 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 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.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
      
      {
        "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 Para actualizar la descripción de esta reserva futura, realiza una de las siguientes acciones:

    • Para agregar o actualizar una descripción, especifica una descripción.

    • Para quitar la descripción, borra el campo description del cuerpo de la solicitud y especifícalo en UPDATE_FIELDS.

  • NAME_PREFIX: Opcional Un prefijo de nombre nuevo para la reserva futura. El nombre de cada reserva creada de forma automática para esta 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.

Por ejemplo, considera una reserva futura aprobada llamada fr-04 y ubicada en la zona us-central1-a. Supongamos que deseas modificar esta reserva futura con los siguientes cambios:

  • Habilita la opción de eliminación automática.

  • Borra de forma automática las reservas creadas automáticamente después de 864,000 segundos (10 días).

  • Especifica un nuevo prefijo de nombre.

Para modificar fr-04, realiza la siguiente solicitud PATCH:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-04?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CnamePrefix

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "864000"
  },
  "name": "fr-04",
  "namePrefix": "new-prefix"
}

Solicitud para modificar una reserva futura aprobada o en proceso de adquisición

Puedes solicitar a Google Cloud que modifique una reserva futura con un estado de adquisición establecido como Aprobado (APPROVED) o Adquirido (PROCURING) de la siguiente manera:

  • Si solicitas modificar una reserva futura aprobada, Google Cloud realiza una de las siguientes acciones:

    • Aprueba la solicitud y establece el estado de adquisición en Aprobado (APPROVED). Si la hora de inicio del período de reserva es dentro de los 56 días (8 semanas), Compute Engine establece el estado de adquisición como Adquirido (PROCURING) en unos minutos.

    • Rechaza la solicitud y establece el estado de adquisición en Rechazada (DECLINED). Si deseas volver a modificar la reserva futura, consulta Modifica un borrador o una reserva futura rechazada en este documento.

  • Si solicitas modificar una reserva futura de adquisición, Compute Engine crea el estado de actualización en la reserva futura y lo configura como Actualizar aprobación pendiente (AMENDMENT_PENDING_APPROVAL). Luego, Google Cloud revisa tu solicitud y realiza una de las siguientes acciones:

    • Aprueba la solicitud y establece el estado de la actualización en Actualización aprobada (AMENDMENT_APPROVED).

    • Rechaza la solicitud, establece el estado de la actualización en Actualización rechazada (AMENDMENT_DECLINED) y sigue usando las propiedades aprobadas con anterioridad para las reservas creadas de forma automática.

    Durante el tiempo que se revisa tu solicitud en Google Cloud para modificar una reserva futura, no puedes modificar ninguna propiedad, incluidas las propiedades que normalmente puedes modificar sin aprobación, hasta que en Google Cloud se apruebe o rechace la solicitud.

Para solicitar a Google Cloud que se modifiquen las propiedades de una reserva futura aprobada o seleccionada, selecciona uno de los siguientes métodos:

Solicitud para modificar una reserva futura creada mediante la especificación de una plantilla de instancias

Para una reserva futura creada a través de la especificación de una plantilla de instancias con un estado de adquisición de Aprobado (APPROVED) o Adquirido (PROCURING), puedes solicitar modificar las siguientes propiedades:

  • Eliminación automática

  • Descripción

  • Prefijo del nombre

  • Configuración de uso compartido

  • Hora de inicio y finalización del período de reserva

  • Recuento total (cantidad de VMs)

Si solicitas aumentar o disminuir en gran medida el recuento total dentro de los 14 días posteriores a la hora de inicio de la reserva futura, es probable que Google Cloud rechace tu solicitud.

Puedes solicitar a Google Cloud que modifique una reserva futura creada si especificas una plantilla de instancias con gcloud CLI y REST.

Consola

Para solicitar a Google Cloud que se modifique una reserva futura aprobada o en proceso de creación mediante 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. En la columna Nombre, haz clic en el nombre de la reserva futura que deseas modificar.

    Se abrirá la página de detalles de la reserva futura seleccionada.

  4. Si deseas modificar la opción de eliminación automática y la descripción de una reserva futura, realiza una o más de las siguientes acciones:

    • En la fila Tiempo de eliminación automática de reservas creadas de forma automática, haz clic en Editar y, luego, sigue estos pasos:

      1. Realice una de las siguientes acciones:

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

          1. Haz clic en el botón de activación Habilitar la eliminación automática.

          2. Opcional: En el campo Hora de borrado automático, 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 a la posición desactivada.

      2. Haz clic en Enviar.

    • En la fila Prefijo, haz clic en Editar y, luego, haz lo siguiente:

      1. En el campo Prefijo, ingresa un prefijo de nombre nuevo.

      2. Haz clic en Enviar.

    • En la fila Descripción, haz clic en Editar y, luego, haz lo siguiente:

      1. En el campo Descripción, ingresa una descripción nueva.

      2. Haz clic en Enviar.

  5. Haz clic en  Editar.

    Se abrirá la página para editar la reserva futura seleccionada.

  6. Si deseas modificar otras propiedades, realiza una o más de las siguientes acciones:

    • Modifica la Hora de inicio o la Hora de finalización de la reserva futura. Asegúrate de que se den las siguientes condiciones:

      • La hora de inicio no puede ser posterior a 1 año a partir de la fecha y hora en que envías una reserva futura para su revisión.

      • Especifica un valor recomendado para la hora de inicio a fin de asegurarte de que tienes tiempo suficiente antes de que tu reserva futura ingrese a la hora de bloqueo.

      • Especifica un período de reserva mínimo recomendado para aumentar la probabilidad de que con Google Cloud se apruebe tu solicitud después de enviarla para su revisión.

    • En la sección Tipo de recurso compartido, puedes seleccionar Local o Compartido. Si seleccionas Compartido, puedes agregar o quitar proyectos para compartir la reserva futura.

      Puedes seleccionar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto en el que se creó la reserva futura (el proyecto propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se permite consumir las reservas compartidas creadas de forma automática para esta reserva futura.

    • 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 que se crearán para una reserva futura aprobada, primero se verifica con Compute Engine 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.

  7. Si deseas enviar una solicitud de modificación a Google Cloud para su revisión, haz clic en Enviar.

    Si envías una solicitud, se abrirá la página Reservas. De lo contrario, se abrirá la página de detalles de la reserva futura.

gcloud

Para solicitar a Google Cloud que se modifique una reserva aprobada o una reserva futura adquirida mediante la especificación de una plantilla de instancias, usa el Comando gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=SHARE_SETTING \
    --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 una reserva futura aprobada o adquirida
  • DESCRIPTION: Opcional Una descripción nueva para la reserva futura.
  • NAME_PREFIX: Opcional Un prefijo de nombre nuevo para la reserva futura. El nombre de cada reserva creada de forma automática para esta 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: Es el estado de planificación de la reserva futura. Solo puedes especificar SUBMITTED, que envía la reserva futura a Google Cloud para su revisión.

  • PROJECT_ID: Opcional El ID del proyecto en el que se creó la reserva futura. Si modificas una reserva futura de un solo proyecto en una reserva compartida, este proyecto se convierte en el proyecto propietario de la reserva futura. Si omites la marca --project, el valor se establece en el ID del proyecto actual.
  • SHARE_SETTING: Opcional Para cambiar el tipo de reserva futura, especifica uno de los siguientes valores:

    • Para cambiar una reserva futura de un solo proyecto a una reserva futura compartida, especifica projects. Asegúrate de especificar al menos un proyecto de consumidor en la marca --share-with. De lo contrario, la creación de la solicitud de reserva futura fallará.

    • De lo contrario, especifica local.

  • CONSUMER_PROJECT_IDS: Opcional : Una lista separada por comas de los ID 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ó esta reserva futura (el proyecto propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se permite consumir las reservas compartidas creadas de forma automática para esta reserva futura.

  • START_TIME: Opcional La hora de inicio del período de reserva con el formato de 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 reserva futura para su revisión. A fin de tener tiempo suficiente para cancelar, borrar o modificar una reserva futura de forma opcional después de que se apruebe o antes de que ingrese a la hora de bloqueo, asegúrate de especificar una hora de inicio recomendada. .

  • END_TIME: Opcional : 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.

  • TOTAL_COUNT: Opcional : 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: Si deseas aumentar la cantidad de VM que se reservarán, asegúrate de tener suficiente cuota para los recursos adicionales que solicitas reservar. De lo contrario, en Google Cloud se rechazará tu solicitud de modificación.

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

De manera opcional, también puedes cambiar si quieres borrar de forma automática las reservas creadas de forma automática para una reserva futura con Compute Engine si realizas una de las siguientes acciones:

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

    • Para borrar las reservas dentro de las 2 horas posteriores a la hora de finalización (predeterminada), especifica la marca --auto-delete-auto-created-reservations.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations
      
    • 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 update 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 update 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.

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

Por ejemplo, considera una reserva futura aprobada llamada fr-05 y ubicada en la zona us-central1-a. Supongamos que deseas solicitar a Google Cloud que se modifique esta reserva futura mediante los siguientes cambios:

  • Cambia la hora de finalización de su período de reserva a la medianoche del 31 de diciembre de 2023 UTC.

  • Reserva 10 VM.

  • Especifica un nuevo prefijo de nombre.

Para solicitar a Google Cloud que se modifique fr-05, ejecuta el siguiente comando:

gcloud beta compute future-reservations update fr-05 \
    --end-time=2024-12-31T00:00:00Z \
    --name-prefix=new-prefix \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=10 \
    --zone=us-central1-a

REST

Para solicitar a Google Cloud que se modifique una reserva aprobada o reserva futura adquirida mediante la especificación de una plantilla de instancias, realiza una solicitud PATCH al método beta.futureReservations.update. En el parámetro de búsqueda updateMask, especifica cada campo que deseas actualizar. Si necesitas borrar un campo opcional de tu reserva, incluye ese campo en el parámetro de consulta updateMask y omite ese campo del cuerpo de la solicitud.

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

{
  "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": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto en el que se encuentra la reserva futura.

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

  • FUTURE_RESERVATION_NAME: El nombre de una reserva futura aprobada o adquirida No puedes modificar el nombre de una reserva futura.

  • UPDATE_FIELDS: Una lista de campos separados por comas que se actualizarán en esta solicitud PATCH. Debes codificar cada coma como %2C. Por ejemplo, si deseas actualizar los campos autoDeleteAutoCreatedReservations, totalCount y endTime en tu reserva futura, especifica lo siguiente: siguiente:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
    
  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Opcional Si configuras este campo como true, con Compute Engine podrás borrar de forma automática las reservas creadas de forma automática para esta reserva de reserva futura. De forma predeterminada, la hora de eliminación se encuentra dentro de las 2 horas después 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 de la hora de finalización de tu período de reserva, configura autoDeleteAutoCreatedReservations como true y especifica el campo autoCreatedReservationsDeleteTime.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME"
      }
      

      Reemplaza DELETE_TIME por una fecha y hora en la que se borren las reservas con Compute Engine 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 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.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
      
      {
        "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 Para actualizar la descripción de esta reserva futura, realiza una de las siguientes acciones:

    • Para agregar o actualizar una descripción, especifica una descripción.

    • Para quitar la descripción, borra el campo description del cuerpo de la solicitud y especifícalo en UPDATE_FIELDS.

  • NAME_PREFIX: Opcional Un prefijo de nombre nuevo para la reserva futura. El nombre de cada reserva creada de forma automática para esta 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: Es el estado de planificación de la reserva futura. Solo puedes especificar SUBMITTED, que envía la reserva futura a Google Cloud para su revisión.

  • SHARE_TYPE: Opcional Para cambiar el tipo de recurso compartido de esta reserva futura, especifica uno de los siguientes valores:

    • Para cambiar una reserva futura de un solo proyecto a una reserva futura compartida, especifica SPECIFIC_PROJECTS. Además, debes especificar al menos un proyecto de consumidor en el campo projects. De lo contrario, la modificación de la reserva futura fallará.

    • De lo contrario, especifica LOCAL. Además, debes borrar el campo projects del cuerpo de la solicitud y especificarlo en UPDATE_FIELDS. De lo contrario, la modificación de la reserva futura fallará.

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

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

  • START_TIME: Opcional La nueva hora de inicio del período de reserva con 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 reserva futura para su revisión. Además, asegúrate de especificar una hora de inicio recomendada para garantizar que tienes tiempo suficiente antes de que una reserva futura ingrese a la hora de bloqueo.

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

    "duration": {
      "seconds": "END_DURATION"
    }
    

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

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

Por ejemplo, considera una reserva futura aprobada llamada fr-05 y ubicada en la zona us-central1-a. Supongamos que deseas solicitar a Google Cloud que se modifique esta reserva futura mediante los siguientes cambios:

  • Cambia la hora de finalización de su período de reserva a la medianoche del 31 de diciembre de 2023 UTC.

  • Reserva 10 VM.

  • Especifica un nuevo prefijo de nombre.

Para solicitar a Google Cloud que se modifique fr-05, realiza la siguiente solicitud PATCH:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-05?updateMask=namePrefix%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

{
  "name": "fr-05",
  "namePrefix": "new-prefix",
  "planningStatus": "SUBMITTED",
  "specificSkuProperties": {
    "totalCount": "10"
  },
  "timeWindow": {
    "endTime": "2023-12-31T00:00:00Z"
  }
}

Después de enviar una solicitud para modificar una reserva futura a Google Cloud, puedes supervisar el estado de la solicitud si visualizas los detalles de la reserva futura.

Solicitud para modificar una reserva futura creada directamente mediante la especificación de propiedades

Para una reserva futura creada a través de la especificación directa de las propiedades con un estado de adquisición de Aprobado (APPROVED) o Adquirido (Procuring), puedes solicitar modificar las siguientes propiedades:

  • Eliminación automática

  • Descripción

  • Prefijo del nombre

  • GPU

  • SSD locales y el tipo de interfaz de disco

  • Serie y tipos de máquinas

  • Plataforma de CPU mínima

  • Configuración de uso compartido

  • Hora de inicio y finalización del período de reserva

  • Recuento total (cantidad de VMs)

Si solicitas cambiar alguna propiedad de la VM, o aumentas o disminuyes en gran medida el recuento total dentro de los 14 días posteriores a la hora de inicio de la reserva futura, es probable que Google Cloud rechace la solicitud.

Puedes solicitar a Google Cloud que modifique una reserva futura creada si especificas propiedades directamente a través de la consola de Google Cloud, gcloud CLI y REST.

Consola

Para solicitar a Google Cloud que se modifique una reserva aprobada o en curso de creación futura mediante 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. En la columna Nombre, haz clic en el nombre de la reserva futura que deseas modificar.

    Se abrirá la página de detalles de la reserva futura seleccionada.

  4. Si deseas modificar la opción de eliminación automática y la descripción de una reserva futura, realiza una o más de las siguientes acciones:

    • En la fila Tiempo de eliminación automática de reservas creadas de forma automática, haz clic en Editar y, luego, sigue estos pasos:

      1. Realice una de las siguientes acciones:

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

          1. Haz clic en el botón de activación Habilitar la eliminación automática.

          2. Opcional: En el campo Hora de borrado automático, 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 a la posición desactivada.

      2. Haz clic en Enviar.

    • En la fila Prefijo, haz clic en Editar y, luego, haz lo siguiente:

      1. En el campo Prefijo, ingresa un prefijo de nombre nuevo.

      2. Haz clic en Enviar.

    • En la fila Descripción, haz clic en Editar y, luego, haz lo siguiente:

      1. En el campo Descripción, ingresa una descripción nueva.

      2. Haz clic en Enviar.

  5. Haz clic en  Editar.

    Se abrirá la página para editar la reserva futura seleccionada.

  6. Si deseas modificar otras propiedades, realiza una o más de las siguientes acciones:

    • Modifica la Hora de inicio o la Hora de finalización de la reserva futura. Asegúrate de que se den las siguientes condiciones:

      • La hora de inicio no puede ser posterior a 1 año a partir de la fecha y hora en que envías una reserva futura para su revisión.

      • Especifica un valor recomendado para la hora de inicio a fin de asegurarte de que tienes tiempo suficiente antes de que tu reserva futura ingrese a la hora de bloqueo.

      • Especifica un período de reserva mínimo recomendado para aumentar la probabilidad de que con Google Cloud se apruebe tu solicitud después de enviarla para su revisión.

    • En la sección Tipo de recurso compartido, puedes seleccionar Local o Compartido. Si seleccionas Compartido, puedes agregar o quitar proyectos para compartir la reserva futura.

      Puedes seleccionar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto en el que se creó la reserva futura (el proyecto propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se permite consumir las reservas compartidas creadas de forma automática para esta reserva futura.

    • 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 que se crearán para una reserva futura aprobada, primero se verifica con Compute Engine 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.

    • En la sección Configuración de máquina, puedes cambiar lo siguiente:

      • La serie de máquinas y el tipo de máquina que se usa en las VMs reservadas.

      • Las GPU que se adjuntarán a las VM reservadas

      • Los SSD locales y el tipo de interfaz de disco de las VM reservadas

  7. Si deseas enviar una solicitud de modificación a Google Cloud para su revisión, haz clic en Enviar.

    Si envías una solicitud, se abrirá la página Reservas. De lo contrario, se abrirá la página de detalles de la reserva futura.

gcloud

Para solicitar a Google Cloud que se modifique una reserva futura aprobada o en curso mediante la especificación directa de las propiedades, usa lo siguiente:gcloud beta compute future-reservations update comando.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --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=SHARE_SETTING \
    --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 una reserva futura aprobada o adquirida
  • Opcional. Realice una de las siguientes acciones:

    • Para agregar unidades de procesamiento de gráficos (GPU) 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.

    • Para quitar todas las GPU de esta solicitud futura, reemplaza la marca --accelerator por la marca --clear-accelerator.

  • DESCRIPTION: Opcional Una descripción nueva para la reserva futura.
  • Opcional. Realice una de las siguientes acciones:

    • Para agregar o editar el tipo de interfaz que deseas que usen los SSD locales para cada VM, reemplaza INTERFACE_1 y INTERFACE_2. El valor debe ser uno de los siguientes:

      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.

    • Para quitar todos los SSD locales de esta reserva futura, quita todas las marcas --local-ssd y especifica la marca --clear-local-ssd.

  • MACHINE_TYPE: Opcional Un tipo de máquina predefinido o personalizado para usar en cada VM. Antes de especificar un tipo personalizado de máquina, revisa las limitaciones para VMs con tipos personalizados de máquinas.

  • 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: Opcional Un prefijo de nombre nuevo para la reserva futura. El nombre de cada reserva creada de forma automática para esta 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: Es el estado de planificación de la reserva futura. Solo puedes especificar SUBMITTED, que envía la reserva futura a Google Cloud para su revisión.

  • PROJECT_ID: Opcional El ID del proyecto en el que se creó la reserva futura. Si modificas una reserva futura de un solo proyecto en una reserva compartida, este proyecto se convierte en el proyecto propietario de la reserva futura. Si omites la marca --project, el valor se establece en el ID del proyecto actual.
  • SHARE_SETTING: Opcional Para cambiar el tipo de reserva futura, especifica uno de los siguientes valores:

    • Para cambiar una reserva futura de un solo proyecto a una reserva futura compartida, especifica projects. Asegúrate de especificar al menos un proyecto de consumidor en la marca --share-with. De lo contrario, la creación de la solicitud de reserva futura fallará.

    • De lo contrario, especifica local.

  • CONSUMER_PROJECT_IDS: Opcional : Una lista separada por comas de los ID 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ó esta reserva futura (el proyecto propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se permite consumir las reservas compartidas creadas de forma automática para esta reserva futura.

  • START_TIME: Opcional La hora de inicio del período de reserva con el formato de 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 reserva futura para su revisión. A fin de tener tiempo suficiente para cancelar, borrar o modificar una reserva futura de forma opcional después de que se apruebe o antes de que ingrese a la hora de bloqueo, asegúrate de especificar una hora de inicio recomendada. .

  • END_TIME: Opcional : 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.

  • TOTAL_COUNT: Opcional : 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: Si deseas aumentar la cantidad de VM que se reservarán, asegúrate de tener suficiente cuota para los recursos adicionales que solicitas reservar. De lo contrario, en Google Cloud se rechazará tu solicitud de modificación.

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

De manera opcional, también puedes cambiar si quieres borrar de forma automática las reservas creadas de forma automática para una reserva futura con Compute Engine si realizas una de las siguientes acciones:

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

    • Para borrar las reservas dentro de las 2 horas posteriores a la hora de finalización (predeterminada), especifica la marca --auto-delete-auto-created-reservations.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations
      
    • 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 update 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 update 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.

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

Por ejemplo, considera una reserva futura aprobada llamada fr-05 y ubicada en la zona us-central1-a. Supongamos que deseas solicitar a Google Cloud que se modifique esta reserva futura mediante los siguientes cambios:

  • Cambia la hora de finalización de su período de reserva a la medianoche del 31 de diciembre de 2023 UTC.

  • Reserva 10 VM.

  • Especifica un nuevo prefijo de nombre.

Para solicitar a Google Cloud que se modifique fr-05, ejecuta el siguiente comando:

gcloud beta compute future-reservations update fr-05 \
    --end-time=2024-12-31T00:00:00Z \
    --name-prefix=new-prefix \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=10 \
    --zone=us-central1-a

REST

Para solicitar a Google Cloud que se modifique una reserva futura aprobada o reserva futura adquirida mediante la especificación directa de las propiedades, haz lo siguiente:PATCH solicitud a labeta.futureReservations.update método. En el parámetro de búsqueda updateMask, especifica cada campo que deseas actualizar. Si necesitas borrar un campo opcional de tu reserva, incluye ese campo en el parámetro de consulta updateMask y omite ese campo del cuerpo de la solicitud.

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

{
  "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": "SHARE_TYPE"
  },
  "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": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto en el que se encuentra la reserva futura.

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

  • FUTURE_RESERVATION_NAME: El nombre de una reserva futura aprobada o adquirida No puedes modificar el nombre de una reserva futura.

  • UPDATE_FIELDS: Una lista de campos separados por comas que se actualizarán en esta solicitud PATCH. Debes codificar cada coma como %2C. Por ejemplo, si deseas actualizar los campos autoDeleteAutoCreatedReservations, totalCount y endTime en tu reserva futura, especifica lo siguiente: siguiente:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
    
  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Opcional Si configuras este campo como true, con Compute Engine podrás borrar de forma automática las reservas creadas de forma automática para esta reserva de reserva futura. De forma predeterminada, la hora de eliminación se encuentra dentro de las 2 horas después 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 de la hora de finalización de tu período de reserva, configura autoDeleteAutoCreatedReservations como true y especifica el campo autoCreatedReservationsDeleteTime.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME"
      }
      

      Reemplaza DELETE_TIME por una fecha y hora en la que se borren las reservas con Compute Engine 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 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.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
      
      {
        "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 Para actualizar la descripción de esta reserva futura, realiza una de las siguientes acciones:

    • Para agregar o actualizar una descripción, especifica una descripción.

    • Para quitar la descripción, borra el campo description del cuerpo de la solicitud y especifícalo en UPDATE_FIELDS.

  • NAME_PREFIX: Opcional Un prefijo de nombre nuevo para la reserva futura. El nombre de cada reserva creada de forma automática para esta 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: Es el estado de planificación de la reserva futura. Solo puedes especificar SUBMITTED, que envía la reserva futura a Google Cloud para su revisión.

  • SHARE_TYPE: Opcional Para cambiar el tipo de recurso compartido de esta reserva futura, especifica uno de los siguientes valores:

    • Para cambiar una reserva futura de un solo proyecto a una reserva futura compartida, especifica SPECIFIC_PROJECTS. Además, debes especificar al menos un proyecto de consumidor en el campo projects. De lo contrario, la modificación de la reserva futura fallará.

    • De lo contrario, especifica LOCAL. Además, debes borrar el campo projects del cuerpo de la solicitud y especificarlo en UPDATE_FIELDS. De lo contrario, la modificación de la reserva futura fallará.

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

  • Opcional. Para actualizar las unidades de procesamiento de gráficos (GPU) conectadas a cada VM reservada, realiza una de las siguientes acciones:

    • Para agregar o modificar GPU, 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.

    • Para quitar todas las GPU de esta solicitud futura, borra el campo guestAccelerators en el cuerpo de la solicitud y especifícalo en UPDATE_FIELDS.

  • Opcional. Para actualizar las SSD locales conectadas a cada VM reservada, realiza una de las siguientes acciones:

    • Para agregar o editar el tipo de interfaz que deseas que usen los SSD locales para cada VM, reemplaza INTERFACE_1 y INTERFACE_2. El valor debe ser uno de los siguientes:

      Repite los campos diskSizeGb y interface para cada SSD local que desees agregar o actualizar. Puedes especificar un máximo de 24 SSDs locales.

    • Para quitar todos los SSD locales de esta reserva futura, borra el campo localSsds del cuerpo de la solicitud y especifícalo en UPDATE_FIELDS.

  • MACHINE_TYPE: Opcional Un tipo de máquina predefinido o personalizado para usar en cada VM. Antes de especificar un tipo personalizado de máquina, revisa las limitaciones para VMs con tipos personalizados de máquinas.

  • MINIMUM_CPU_PLATFORM: Opcional A fin de actualizar la plataforma de CPU mínima para usar en cada VM, realiza una de las siguientes acciones:

    • Para agregar o actualizar la plataforma de CPU mínima, especifica una plataforma de CPU mínima.

    • Para volver a la plataforma de CPU predeterminada de la zona, borra el campo minCpuPlatform del cuerpo de la solicitud y especifícalo en UPDATE_FIELDS.

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

  • START_TIME: Opcional La nueva hora de inicio del período de reserva con 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 reserva futura para su revisión. Además, asegúrate de especificar una hora de inicio recomendada para garantizar que tienes tiempo suficiente antes de que una reserva futura ingrese a la hora de bloqueo.

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

    "duration": {
      "seconds": "END_DURATION"
    }
    

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

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

Por ejemplo, considera una reserva futura aprobada llamada fr-05 y ubicada en la zona us-central1-a. Supongamos que deseas solicitar a Google Cloud que se modifique esta reserva futura mediante los siguientes cambios:

  • Cambia la hora de finalización de su período de reserva a la medianoche del 31 de diciembre de 2023 UTC.

  • Reserva 10 VM.

  • Especifica un nuevo prefijo de nombre.

Para solicitar a Google Cloud que se modifique fr-05, realiza la siguiente solicitud PATCH:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-05?updateMask=namePrefix%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

{
  "name": "fr-05",
  "namePrefix": "new-prefix",
  "planningStatus": "SUBMITTED",
  "specificSkuProperties": {
    "totalCount": "10"
  },
  "timeWindow": {
    "endTime": "2023-12-31T00:00:00Z"
  }
}

Después de enviar una solicitud para modificar una reserva futura a Google Cloud, puedes supervisar el estado de la solicitud si visualizas los detalles de la reserva futura.

Cambia cualquier otra propiedad en una solicitud de reserva futura

Si deseas cambiar cualquier otra propiedad en una solicitud de reserva futura antes de que alcance un estado de adquisición Adquirido (PROCURING), sigue estos pasos:

  1. Tener conocimiento sobre uno o más de los siguientes temas:

  2. Crea un nuevo proyecto único o una solicitud de reserva futura compartida con las actualizaciones deseadas.

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 representante de cuenta o con el servicio de Asistencia de Google Cloud.

Cancela solicitudes de reserva futuras

Puedes cancelar una solicitud de reserva futura aprobada, rechazada o adquirida para que a través de Google Cloud no se suministre la capacidad solicitada. Después de cancelar una reserva futura, solo podrás ver sus detalles o borrarla.

Puedes cancelar una solicitud de reserva futura con gcloud CLI y REST.

gcloud

Para cancelar una solicitud de reserva futura, usa el comando gcloud beta compute future-reservations cancel.

gcloud beta compute future-reservations cancel FUTURE_RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Reemplaza lo siguiente:

  • FUTURE_RESERVATION_NAME: El nombre de una solicitud de reserva futura existente.

  • PROJECT_ID: Opcional El ID del proyecto en el que se encuentra la solicitud de reserva futura. Si omites la marca --project, se usa el ID del proyecto actual.

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

REST

Para cancelar una solicitud de reserva futura, realiza una solicitud POST al método beta.futureReservations.cancel.

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

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 una solicitud de reserva futura existente.

Borrar solicitudes de reserva futuras

Puedes borrar una solicitud de reserva futura solo en uno de los siguientes casos:

  • La solicitud de reserva futura se canceló.

  • Antes de que la reserva futura haya alcanzado la hora de inicio del período de reserva.

  • Después de que la reserva futura haya alcanzado la hora de finalización del período de reserva.

Borrar una reserva futura no borra las reservas creadas de forma automática para la reserva futura. Si deseas borrar una reserva creada de forma automática después del final del período de reserva, consulta Borra reservas en su lugar.

Puedes borrar una solicitud de reserva futura con la consola de Google Cloud, gcloud CLI y REST.

Consola

Para borrar una 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. Selecciona la casilla de verificación junto a cada solicitud de reserva futura que desees borrar.

  4. Haz clic en Borrar reserva.

  5. Para confirmar la acción, haz clic en Borrar.

    Borrar una solicitud de reserva futura puede tomar hasta un minuto en completarse.

gcloud

Para borrar una solicitud de reserva futura, usa el comando gcloud beta compute future-reservations delete.

gcloud beta compute future-reservations delete FUTURE_RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Reemplaza lo siguiente:

  • FUTURE_RESERVATION_NAME: El nombre de una solicitud de reserva futura existente.

  • PROJECT_ID: Opcional El ID del proyecto en el que se encuentra la solicitud de reserva futura. Si omites la marca --project, se usa el ID del proyecto actual.

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

REST

Para borrar una solicitud de reserva futura, realiza una solicitud DELETE al método beta.futureReservations.delete.

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

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 una solicitud de reserva futura existente.

¿Qué sigue?