Modifica solicitudes de reserva futuras


En este documento, se explica cómo modificar las solicitudes de reserva futura.

Puedes modificar una solicitud de reserva futura en cualquier momento antes de su hora de inicio, siempre que no se haya cancelado o no esté pendiente de aprobación. Modificar una solicitud de reserva futura es útil cuando tus necesidades de capacidad cambian, por ejemplo, cuando deseas aumentar la cantidad de instancias de máquina virtual (VM) reservadas o cambiar el período de reserva. Si deseas modificar una solicitud de reserva futura compartida, debes modificar la solicitud con el proyecto de propietario.

Para modificar una reserva creada de forma automática después de que finalice su período, consulta Cómo modificar reservas.

Antes de comenzar

  • Si aún no lo hiciste, configura la autenticación. 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 código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

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

      gcloud init
    2. Set a default region and zone.
    3. REST

      Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a la CLI de gcloud.

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

        gcloud init

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

Roles obligatorios

Para obtener el permiso que necesitas para modificar las solicitudes de reserva futura, pídele a tu administrador que te otorgue el rol de IAM Administrador de reserva futura de Compute (roles/compute.futureReservationAdmin) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene el permiso compute.futureReservations.update, que se requiere para modificar las solicitudes de reserva futura.

También puedes obtener este permiso con roles personalizados o con otros roles predefinidos.

Propiedades modificables

Una solicitud de reserva futura tiene varias propiedades que definen la reserva, determinan su comportamiento y especifican los recursos que se reservarán. Puedes modificar estas propiedades como se describe en las siguientes secciones.

Después de la creación

Después de crear una solicitud de reserva futura, no puedes modificar las siguientes propiedades:

  • El nombre de la solicitud de reserva futura.

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

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

  • La plantilla de instancias que se usará y las propiedades de VM especificadas en la plantilla de instancias.

Para modificar cualquiera de estas propiedades antes de que una solicitud de reserva futura llegue a su hora de bloqueo, crea una solicitud nueva.

Antes del envío

Antes de enviar una solicitud de reserva futura a Google Cloud para su revisión o después de haber enviado una solicitud de reserva futura para su revisión y que se haya rechazado la solicitud, puedes modificar las siguientes propiedades:

  • Opción de eliminación automática

  • Descripción

  • GPU y el tipo de GPU

  • Discos SSD locales y el tipo de interfaz de los discos

  • Series y tipos de máquinas

  • Plataforma de CPU mínima

  • Prefijo del nombre

  • Configuración de uso compartido

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

  • Recuento total (cantidad de VM)

La modificación del estado de una solicitud de reserva futura de borrador es inmediata y no hay límites para la cantidad de veces que puedes modificarlo. Si modificas una solicitud de reserva futura rechazada (DECLINED), solo puedes modificarla si la vuelves a enviar para su revisión.

Después de la aprobación

Después de que Google Cloud apruebe una reserva futura, puedes modificarla antes de que esta alcance como estado de adquisición el aprovisionamiento (PROVISIONING). En particular, puedes modificar las siguientes propiedades:

  • Modificando la reserva futura en cualquier momento:

    • Opción de eliminación automática

    • Descripción

    • Prefijo del nombre

  • Enviando una solicitud de modificación más 72 horas antes de la hora de inicio:

    • GPU y el tipo de GPU*

    • Discos SSD locales y el tipo de interfaz de los discos*

    • 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 significativamente el recuento total dentro de los 14 días anteriores a la hora de inicio de la reserva futura, es probable que Google Cloud rechace la solicitud.

Modifica solicitudes de reserva futuras

Antes de modificar una solicitud de reserva futura, revisa las propiedades que puedes modificar, si aún no lo has hecho.

Si deseas modificar una solicitud de reserva futura de un solo proyecto creada a través de una plantilla de instancias y convertirla en una solicitud de reserva futura compartida, no puedes usar la misma plantilla para crear VMs que puedan consumir las reservas creadas de forma automática fuera del proyecto que creó la solicitud de reserva futura compartida. Para los proyectos con los que se comparte una reserva futura, debes crear plantillas de instancias similares en ellos o crear VMs a través de la especificación directa de las propiedades.

Para modificar una solicitud de reserva futura, selecciona una de las siguientes opciones:

Console

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

    Ir a Reservas

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

  3. En la columna Nombre, haz clic en el nombre de la solicitud de reserva futura que deseas modificar.

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

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

    • Para modificar la opción de eliminación automática, en la fila Tiempo de eliminación automática de reservas creadas de forma automática, haz clic en Editar y, luego, haz lo siguiente:

      1. Especifica si deseas habilitar, inhabilitar o modificar la opción de eliminación automática mediante una de las siguientes opciones:

        • Para habilitar la opción de eliminación automática o cambiar la hora en que Compute Engine borra de forma automática las reservas creadas automáticamente, haz lo siguiente:

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

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

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

      2. Haz clic en Enviar.

    • Para modificar el prefijo del nombre, en la fila Prefijo, haz clic en Editar y, luego, haz lo siguiente:

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

      2. Haz clic en Enviar.

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

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

      2. Haz clic en Enviar.

  5. Haz clic en Editar o Editar borrador.

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

  6. Para modificar una solicitud de reserva futura y enviarla a Google Cloud para su revisión, o guardar el borrador de la solicitud, realiza una o más de las siguientes acciones:

    • En Prefijo, ingresa un prefijo de nombre nuevo para las reservas creadas de forma automática aprovisionadas para esta solicitud de reserva futura.

    • En 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 un 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 con los que compartir la solicitud de reserva futura. Puedes incluir hasta 100 proyectos.

    • En Cantidad de instancias de VM, ingresa el recuento total de VMs que deseas reservar.

    • Si modificas una reserva futura que no se creó a través de una plantilla de instancias, en la sección Configuración de la máquina, puedes cambiar lo siguiente:

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

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

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

    • En la sección Eliminación automática de 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.

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

    • Si modificas una solicitud de reserva futura de borrador, realiza una de las siguientes acciones:

      • Para guardar los cambios, haz clic en Guardar.

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

    • De lo contrario, haz clic en Enviar.

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

gcloud

Para modificar una solicitud de reserva futura, usa el comando 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 \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --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: Es el nombre de la solicitud de reserva futura.

  • PLANNING_STATUS: Es el estado de planificación de la solicitud de reserva futura. Especifica uno de los siguientes valores:

    • Para modificar un borrador de solicitud de reserva futura sin enviarlo para su revisión, usa DRAFT.

    • Para enviar la solicitud de reserva futura para su revisión, usa SUBMITTED.

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

Reemplaza uno o más de los siguientes marcadores de posición, o quítalos junto con sus marcas correspondientes:

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

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

      gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
          --auto-delete-auto-created-reservations \
          --planning-status=PLANNING_STATUS \
          --zone=ZONE
      
    • 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, incluye las marcas --auto-delete-auto-created-reservations y --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
          --auto-delete-auto-created-reservations \
          --planning-status=PLANNING_STATUS \
          --zone=ZONE
      

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

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

      gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
          --auto-delete-auto-created-reservations \
          --planning-status=PLANNING_STATUS \
          --zone=ZONE
      

      Reemplaza DURATION_BEFORE_DELETE por una duración en días, horas, minutos o segundos. Por ejemplo, especifica 30m para 30 minutos o 1d2h3m4s para 1 día, 2 horas, 3 minutos y 4 segundos.

  • Para inhabilitar la eliminación automática realizada por Compute Engine de las reservas creadas de forma automática aprovisionadas para esta solicitud de reserva futura, incluye la marca --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
        --no-auto-delete-auto-created-reservations \
        --planning-status=PLANNING_STATUS \
        --zone=ZONE
    
  • Para agregar o quitar GPU conectadas a las VMs N1 reservadas o actualizar el tipo de GPU, realiza una de las siguientes acciones:

    • Para cambiar la cantidad y el tipo de GPU, reemplaza 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 la GPU esté disponible en la zona en la que se encuentra la solicitud de reserva futura. De lo contrario, la modificación de la solicitud fallará.

    • Para quitar todas las GPU conectadas a las VMs N1 reservadas, reemplaza la marca --accelerator por la marca --clear-accelerator.

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

  • Para agregar o quitar discos SSD locales de tus VMs reservadas, o editar el tipo de interfaz de disco SSD local, haz una de las siguientes acciones:

    • Para agregar discos SSD locales o editar el tipo de interfaz de disco, reemplaza INTERFACE por uno de los siguientes valores:

      Incluye la marca --local-ssd para la cantidad de discos SSD locales que desees agregar. Puedes especificar un máximo de 24 discos SSD locales.

    • Para quitar todos los discos SSD locales conectados a las VMs reservadas, quita todas las marcas --local-ssd y, luego, incluye la marca --clear-local-ssd.

  • MACHINE_TYPE: Es el nuevo tipo de máquina que se usará para cada VM reservada. Si cambias el tipo de máquina, asegúrate de especificar también un período de reserva mínimo recomendado para la serie de máquinas nueva. De lo contrario, es probable que Google Cloud rechace tu solicitud de modificación.

  • MINIMUM_CPU_PLATFORM: Es una nueva plataforma de CPU mínima que se usará para cada VM reservada.

  • NAME_PREFIX: Es un nuevo prefijo de nombre para las reservas creadas automáticamente aprovisionadas para tu solicitud de reserva futura.

  • SHARE_SETTING: Es un tipo de recurso compartido nuevo para la solicitud de reserva futura. Especifica uno de los siguientes valores:

    • Para una solicitud de reserva futura de un solo proyecto, usa local. Para evitar errores, también debes reemplazar la marca --share-with por la marca --clear-share-settings.

    • Para una solicitud de reserva futura compartida, usa projects. Para evitar errores, también debes especificar al menos un proyecto de consumidor en la marca --share-with.

  • CONSUMER_PROJECT_IDS: Una lista separada por comas de los IDs de los proyectos con los que deseas compartir tu solicitud de reserva futura, por ejemplo, project-1,project-2. Puedes especificar hasta 100 proyectos de consumidor.

  • START_TIME: 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 un año a partir de la fecha y hora en que envías la solicitud de modificación para su revisión. Para tener tiempo suficiente para cancelar, borrar o modificar una reserva futura de forma opcional después de que se apruebe y antes de que empiece su hora de bloqueo, especifica una hora de inicio recomendada.

  • END_TIME: La nueva hora de finalización del período de reserva con un formato de marca de tiempo RFC 3339. El período de reserva debe durar al menos 24 horas. Como alternativa, puedes reemplazar la marca --end-time por la marca --duration=END_DURATION. Reemplaza END_DURATION por la duración del período de reserva en segundos. Para aumentar la probabilidad de que Google Cloud apruebe una solicitud de reserva futura después de enviarla para su revisión, especifica un período de reserva recomendado.

  • TOTAL_COUNT: La nueva cantidad total de VMs que deseas reservar para el período, la configuración de VM y los proyectos especificados en la solicitud de reserva futura. Si deseas aumentar el recuento total, asegúrate de tener suficiente cuota para los recursos que reservas. De lo contrario, Google Cloud rechazará tu solicitud de modificación.

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 quieres modificar esta solicitud de reserva futura compartida mediante los siguientes cambios:

  • Convierte la solicitud 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 revisió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 \
    --share-setting=local \
    --total-count=100 \
    --zone=us-central1-a

REST

Para modificar una solicitud de reserva futura, realiza una solicitud PATCH al método beta.futureReservations.update.

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 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: Es el nombre de la solicitud de reserva futura.

  • UPDATE_FIELDS: Es una lista separada por comas de los campos que se actualizarán en el cuerpo de la solicitud. Debes codificar cada coma como %2C. Si especificas un campo en el parámetros de consulta updateMask y en el cuerpo de la solicitud, se actualizará el valor del campo. De lo contrario, si especificas el campo solo en el parámetro de consulta updateMask, se borrará el campo.

    Por ejemplo, para actualizar los campos autoDeleteAutoCreatedReservations, totalCount y endTime en tu solicitud de reserva futura, especifica lo siguiente: siguiente:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
    
  • PLANNING_STATUS: Es el estado de planificación de la solicitud de reserva futura. Especifica uno de los siguientes valores:

    • Para modificar un borrador de solicitud de reserva futura sin enviarlo para su revisión, usa DRAFT.

    • Para enviar la solicitud de modificación para su revisión, especifica SUBMITTED.

Reemplaza uno o más de los siguientes marcadores de posición, o bien quítalos junto con sus campos correspondientes:

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: si configuras este campo como true, Compute Engine borrará automáticamente las reservas creadas de forma automática aprovisionadas para tu solicitud de reserva futura. De forma predeterminada, la eliminación se realiza dentro de las dos horas posteriores a 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/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime%2CplanningStatus
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME",
        "name": "FUTURE_RESERVATION_NAME",
        "planningStatus": "PLANNING_STATUS"
      }
      

      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.

    • 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/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CplanningStatus
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        },
        "name": "FUTURE_RESERVATION_NAME",
        "planningStatus": "PLANNING_STATUS"
      }
      

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

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

  • NAME_PREFIX: Es un nuevo prefijo de nombre para las reservas creadas automáticamente aprovisionadas para tu solicitud de reserva futura.

  • CONSUMER_PROJECT_ID_1 y CONSUMER_PROJECT_ID_2: Los IDs de los proyectos con los que deseas compartir tu solicitud de reserva futura. Los proyectos deben estar en la misma organización que el proyecto de propietario. Puedes especificar hasta 100 proyectos de consumidor.

  • SHARE_TYPE: Es un tipo de recurso compartido nuevo para la solicitud de reserva futura. Realiza una de las siguientes acciones:

    • Para especificar una solicitud de reserva futura de un solo proyecto, haz lo siguiente:

      • Especifica LOCAL.

      • Quita el campo shareSettings.projects.

    • Para especificar una solicitud de reserva futura compartida, haz lo siguiente:

      • Especifica SPECIFIC_PROJECTS.

      • Especifica al menos un proyecto de consumidor en el campo shareSettings.projects. Los proyectos de consumidor deben estar en la misma organización que el proyecto de propietario. Puedes especificar hasta 100 proyectos de consumidor.

  • Para cambiar la cantidad y el tipo de GPU que se adjuntarán a las VMs N1 reservadas, reemplaza 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 la GPU esté disponible en la zona en la que se encuentra la solicitud de reserva futura. De lo contrario, la modificación de la solicitud fallará.

  • INTERFACE_1 y INTERFACE_2: Es el tipo de tipo de interfaz de disco para los discos SSD locales conectados a cada VM reservada. Especifica uno de los siguientes valores:

  • MACHINE_TYPE: Es el nuevo tipo de máquina que se usará para cada VM reservada. Si cambias el tipo de máquina, asegúrate de especificar también un período de reserva mínimo recomendado para la serie de máquinas nueva. De lo contrario, es menos probable que Google Cloud apruebe tu solicitud de modificación.

  • MINIMUM_CPU_PLATFORM: Es una nueva plataforma de CPU mínima que se usará para cada VM reservada.

  • TOTAL_COUNT: La nueva 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. Si deseas aumentar el recuento total, asegúrate de tener suficiente cuota para los recursos que reservas. De lo contrario, Google Cloud rechazará tu solicitud de modificación.

  • START_TIME: 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 un año a partir de la fecha y hora en que envías la solicitud de modificación para su revisión. Para tener tiempo suficiente para cancelar, borrar o modificar una reserva futura de forma opcional después de que se apruebe y antes de que empiece su hora de bloqueo, especifica una hora de inicio recomendada.

  • END_TIME: La nueva 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:

    PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=timeWindow.duration%2CplanningStatus
    
    {
      "name": "FUTURE_RESERVATION_NAME",
      "planningStatus": "PLANNING_STATUS",
      "timeWindow": {
        "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 Google Cloud apruebe una solicitud de reserva futura después de enviarla para su revisión, especifica un período de reserva recomendado.

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 quieres modificar esta solicitud de reserva futura compartida mediante los siguientes cambios:

  • Convierte la solicitud 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 revisión.

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

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 modificar una solicitud de reserva futura, puedes supervisar sus estados de adquisición o actualización a través de la visualización de los detalles de la solicitud de reserva futura.

Cambia otras propiedades en una solicitud de reserva futura

Para cambiar las propiedades que no puedes modificar después de crear una solicitud de reserva futura, antes de que se apruebe la solicitud y empiece su hora de bloqueo, haz lo siguiente:

  1. Para evitar que la solicitud de reserva futura restrinja el tipo de solicitudes de reserva futura que puedes crear en tu proyecto o en los proyectos con los que se comparte la solicitud de reserva futura, borra la solicitud de reserva futura.

  2. Crea una nueva solicitud de reserva futura de un solo proyecto o compartida con las actualizaciones que desees.

Solucionar problemas

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

Si los problemas persisten después de solucionar el problema, comunícate con tu representante de cuenta o con el servicio de Asistencia de Google Cloud.

¿Qué sigue?