Modifica reservas

En este documento, se explica cómo modificar las reservas en Compute Engine. Para modificar las reservas conectadas a los compromisos, consulta Reemplaza las reservas conectadas a los compromisos.

Modifica una reserva cuando cambien tus necesidades de capacidad o cuando quieras actualizar qué cargas de trabajo pueden consumir la capacidad reservada.

Limitaciones

Cuando modificas una reserva, se aplican las siguientes limitaciones:

Antes de comenzar

  • Si aún no lo hiciste, configura la autenticación. La autenticación verifica tu identidad para acceder a los servicios y las APIs 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:

    Selecciona la pestaña que corresponda a la forma en que planeas usar las muestras de esta página:

    Console

    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. Después de instalarla, inicializa Google Cloud CLI ejecutando el siguiente comando: 

      gcloud init

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

  • Configura una región y una zona predeterminadas.

    • REST

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

      Instala Google Cloud CLI.

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

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

Roles obligatorios

Si quieres obtener los permisos que necesitas para cambiar reservas, pídele a tu administrador que te otorgue el rol de IAM Administrador de Compute (roles/compute.admin) 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 los permisos necesarios para cambiar reservas. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para cambiar reservas:

  • Para cambiar la opción de eliminación automática en una reserva, el tipo de consumo o el tipo de uso compartido en una reserva, o si los trabajos de Vertex AI pueden consumir una reserva de instancias de procesamiento con GPUs adjuntas, usa compute.reservations.update en el proyecto.
  • Para cambiar la cantidad de instancias de Compute Engine en una reserva, usa compute.reservations.resize en el proyecto.

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

Modifica reservas

Según las propiedades que desees modificar en una reserva, usa uno de los siguientes métodos. Si deseas cambiar una propiedad que no se menciona en la siguiente lista, debes crear una reserva nueva con las actualizaciones que elijas y, luego, borrar la reserva original si ya no la necesitas.

Modifica la cantidad de instancias de procesamiento reservadas en una reserva

Puedes aumentar o disminuir la cantidad de instancias de procesamiento reservadas en una reserva. Sin embargo, antes de modificar la cantidad de instancias de procesamiento, ten en cuenta lo siguiente para evitar errores:

  • Para aumentar la cantidad de instancias de procesamiento en cualquier reserva, verifica que puedas cumplir con las siguientes condiciones:

  • Para disminuir la cantidad de instancias de procesamiento en una reserva con orientación específica, verifica que la cantidad de instancias de procesamiento que consumen la reserva no supere la nueva cantidad, que es menor. Si es así, realiza una de las siguientes acciones con las instancias de procesamiento que excedan el nuevo número:

    • Borra instancias de procesamiento

    • Detén o suspende instancias de procesamiento

Para cambiar la cantidad de instancias de procesamiento reservadas en una reserva, elige una de las siguientes opciones:

Console

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

    Ir a Reservas

  2. En la pestaña Reservas según demanda (predeterminada), en la columna Nombre, haz clic en el nombre de la reserva que deseas modificar. Se abrirá una página con los detalles de la reserva.

  3. Haz clic en Editar.

  4. En el campo Cantidad de instancias de VM, ingresa la cantidad actualizada de instancias de procesamiento que se reservarán.

  5. Para confirmar, haz clic en Guardar.

gcloud

Para cambiar la cantidad de instancias de procesamiento reservadas en una reserva, usa el comando gcloud compute reservations update.

gcloud compute reservations update RESERVATION_NAME \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

Reemplaza lo siguiente:

  • RESERVATION_NAME por el nombre de la reserva.

  • NUMBER_OF_VMS: Es la nueva cantidad de instancias de procesamiento que se reservarán.

  • ZONE: Es la zona en la que existe la reserva.

REST

Para modificar la cantidad de instancias de procesamiento reservadas en una reserva, realiza una solicitud POST al método reservations.resize.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/resize

{
  "specificSkuCount": "NUMBER_OF_VMS"
}

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto en el que existe la reserva.

  • ZONE: Es la zona en la que existe la reserva.

  • RESERVATION_NAME por el nombre de la reserva.

  • NUMBER_OF_VMS: Es la nueva cantidad de instancias de procesamiento que se reservarán.

Modifica el tipo de uso compartido de una reserva

Puedes convertir una reserva para un único proyecto en una reserva compartida, o una reserva compartida en una reserva para un único proyecto. Cuando modificas el tipo de uso compartido de una reserva, puedes compartir los recursos reservados con hasta 100 proyectos de tu organización o restringir el acceso solo al proyecto propietario.

Para evitar errores cuando modificas el tipo de uso compartido de una reserva, antes de comenzar la modificación, ten en cuenta lo siguiente:

  • Para convertir una reserva de un solo proyecto en una reserva compartida, verifica lo siguiente:

  • Para convertir una reserva compartida en una reserva para un único proyecto, verifica lo siguiente:

    • Instancias de procesamiento de consumidor: Para modificar una reserva segmentada de forma específica, debes detener, suspender o borrar cualquier instancia de procesamiento que consuma la reserva en cada proyecto de consumidor con el que se comparta la reserva. Este requisito no se aplica a las instancias de procesamiento en el proyecto del propietario.

Para modificar el tipo de uso compartido de una reserva, elige una de las siguientes opciones:

gcloud

Para modificar el tipo de uso compartido de una reserva, usa el comando gcloud compute reservations update.

Según cómo quieras modificar tu reserva, incluye una de las siguientes marcas:

  • Para convertir una reserva de un solo proyecto en una reserva compartida, incluye las marcas --add-share-with y --share-setting=projects:

    gcloud compute reservations update RESERVATION_NAME \
    --add-share-with=CONSUMER_PROJECT_IDS \
    --share-setting=projects \
    --zone=ZONE

  • Para convertir una reserva compartida en una reserva para un único proyecto, incluye la marca --share-setting=local:

    gcloud compute reservations update RESERVATION_NAME \
    --share-setting=local \
    --zone=ZONE

Reemplaza lo siguiente:

  • RESERVATION_NAME: Es el nombre de la reserva que deseas modificar.

  • CONSUMER_PROJECT_IDS: Es una lista separada por comas de los IDs de los proyectos con los que se debe compartir la reserva, por ejemplo, project-1,project-2. Puedes compartir una reserva con hasta 100 proyectos que se encuentren en la misma organización que el proyecto propietario.

  • ZONE: Es la zona en la que existe la reserva.

REST

Para modificar el tipo de uso compartido de una reserva, realiza una solicitud PATCH al método reservations.update.

Según cómo desees modificar tu reserva, realiza una de las siguientes solicitudes:

  • Para convertir una reserva para un único proyecto en una reserva compartida, realiza una solicitud de la siguiente manera. En la URL de la solicitud, incluye el parámetro de consulta paths=shareSettings.projectMap.PROJECT_ID_OR_NUMBER para cada proyecto con el que desees compartir la reserva.

    Por ejemplo, para compartir una reserva con dos proyectos, haz una solicitud de la siguiente manera. Puedes compartir una reserva con hasta 100 proyectos que se encuentren en la misma organización que el proyecto propietario.

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.shareType&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_2

{
  "name": "RESERVATION_NAME",
  "shareSettings": {
    "shareType": "SPECIFIC_PROJECTS",
    "projectMap": {
      "CONSUMER_PROJECT_ID_OR_NUMBER_1": {
        "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_1"
      },
      "CONSUMER_PROJECT_ID_OR_NUMBER_2": {
        "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_2"
      }
    }
  }
}

  • Para convertir una reserva compartida en una reserva para un único proyecto, realiza una solicitud de la siguiente manera:

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.shareType

{
  "name": "RESERVATION_NAME",
  "shareSettings": {
    "shareType": "LOCAL"
  }
}

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto en el que existe la reserva (el proyecto propietario).

  • ZONE: Es la zona en la que existe la reserva.

  • RESERVATION_NAME: Es el nombre de la reserva que deseas modificar.

  • CONSUMER_PROJECT_ID_OR_NUMBER_1 y CONSUMER_PROJECT_ID_OR_NUMBER_2: Son el ID o el número de los dos proyectos con los que deseas compartir la reserva.

Modifica los proyectos de consumidor en una reserva compartida

Para evitar errores cuando modificas los proyectos de consumidor que pueden consumir una reserva compartida, ten en cuenta lo siguiente:

  • Eliminación de proyectos: Puedes impedir que los proyectos de consumidor consuman una reserva compartida solo si ninguna instancia de procesamiento de esos proyectos consume la reserva. Para evitar que las instancias de procesamiento consuman una reserva, detén, suspende o borra las instancias de procesamiento.

  • Adición de proyectos: Solo puedes permitir que los proyectos de consumidor consuman una reserva compartida si estos proyectos se encuentran en la misma organización que el proyecto propietario. Para migrar un proyecto a la organización del proyecto de propietario, consulta Migra proyectos entre recursos de la organización.

Después de modificar los proyectos de consumidor para una reserva compartida, el consumo de la reserva podría cambiar. Por ejemplo, si configuraste la reserva para que la consuman todas las instancias de procesamiento que coincidan (la configuración predeterminada), es posible que los proyectos de consumidor agregados recientemente comiencen a consumir la reserva de inmediato. Para obtener más información sobre qué reservas coincidentes consumen primero los proyectos, consulta el orden de consumo de las reservas.

Para cambiar los proyectos de consumidor que pueden consumir una reserva compartida, elige una de las siguientes opciones:

Console

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

    Ir a Reservas

  2. En la pestaña Reservas según demanda (predeterminada), en la columna Nombre, haz clic en el nombre de la reserva que deseas describir.

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

  3. Haz clic en  Cambiar.

  4. En la sección Proyectos seleccionados, realiza una de las siguientes acciones:

    • Para dejar de compartir la reserva con un proyecto de consumidor específico, haz clic en Borrar.

    • Para empezar a compartir la reserva con uno o más proyectos específicos, haz lo siguiente:

      1. Haz clic en Agregar proyectos.

      2. Selecciona la casilla de verificación de cada proyecto de la organización del proyecto propietario con el que deseas compartir la reserva. Puedes compartir una reserva compartida con hasta 100 proyectos de consumidor.

      3. Haz clic en Seleccionar.

  5. Para confirmar los cambios, haz clic en Guardar.

    La modificación de tu reserva puede tomar unos segundos en completarse.

gcloud

Cuando modificas los proyectos de consumidor para una reserva compartida, debes especificar una lista separada por comas de los IDs de proyectos a los que que deseas permitirles, o dejar de permitirles, el consumo de la reserva compartida. Todos los proyectos de consumidor deben pertenecer a la misma organización que el proyecto de propietario. No especifiques el proyecto de propietario. De forma predeterminada, el proyecto de propietario de una reserva compartida siempre puede consumirla.

Para cambiar los proyectos de consumidor de una reserva compartida, realiza una de las siguientes acciones:

  • Para que uno o más proyectos consuman una reserva compartida, usa el comando gcloud compute reservations update con la marca --add-share-with.

    gcloud compute reservations update RESERVATION_NAME \
    --add-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

    Reemplaza lo siguiente:

    • RESERVATION_NAME: el nombre de una reserva compartida existente.

    • CONSUMER_PROJECT_IDS: Es una lista separada por comas de IDs de proyectos con los que se debe compartir la reserva, por ejemplo, project-1,project-2. Puedes compartir una reserva compartida con hasta 100 proyectos de consumidor.

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

  • Para dejar de permitir que uno o más proyectos consuman una reserva compartida, usa el comando gcloud compute reservations update con la marca --remove-share-with.

    gcloud compute reservations update RESERVATION_NAME \
    --remove-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

    Reemplaza lo siguiente:

    • RESERVATION_NAME: el nombre de una reserva compartida existente.

    • CONSUMER_PROJECT_IDS: Es una lista separada por comas de los IDs de los proyectos con los que deseas dejar de compartir la reserva, por ejemplo, project-1,project-2.

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

  • Para reemplazar la lista de proyectos que pueden consumir una reserva compartida, usa el comando gcloud beta compute reservations update con la marca --share-with.

    gcloud beta compute reservations update RESERVATION_NAME \
    --share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

    Reemplaza lo siguiente:

    • RESERVATION_NAME: el nombre de una reserva compartida existente.

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

    • CONSUMER_PROJECT_IDS: Es una lista separada por comas de IDs de proyectos con los que se debe compartir la reserva, por ejemplo, project-1,project-2. Puedes compartir una reserva compartida con hasta 100 proyectos de consumidor.

REST

Cuando modificas los proyectos de consumidor destinados a una reserva compartida, debes especificar los proyectos que deseas agregar o quitar. Para permitir que un proyecto consuma la reserva, especifica el ID del proyecto o el número del proyecto. Para impedir que un proyecto consuma la reserva, debes especificar el número del proyecto. Todos los proyectos de consumidor deben pertenecer a la misma organización que el proyecto de propietario. No especifiques el proyecto de propietario. De forma predeterminada, el proyecto de propietario de una reserva compartida siempre puede consumirla.

Para cambiar los proyectos de consumidor de una reserva compartida, realiza una de las siguientes acciones:

  • Para permitir que uno o más proyectos consuman una reserva compartida, debes llevar a cabo una solicitud PATCH al método reservations.update. En la URL de la solicitud, incluye el parámetro de consulta paths=shareSettings.projectMap.PROJECT_ID_OR_NUMBER para cada proyecto con el que desees compartir la reserva.

    Por ejemplo, para permitir que dos proyectos consuman una reserva compartida, debes hacer una solicitud PATCH de la siguiente manera. Puedes compartir una reserva compartida con hasta 100 proyectos de consumidor.

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_2

{
  "name": "RESERVATION_NAME",
  "shareSetting": {
    "projectMap": {
      "CONSUMER_PROJECT_ID_OR_NUMBER_1": {
        "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_1"
      },
      "CONSUMER_PROJECT_ID_OR_NUMBER_2": {
        "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_2"
      }
    }
  }
}

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto en el que existe la reserva compartida (el proyecto propietario).

    • ZONE: Es la zona en la que existe la reserva compartida.

    • RESERVATION_NAME: el nombre de una reserva compartida existente.

    • CONSUMER_PROJECT_ID_OR_NUMBER_1 y CONSUMER_PROJECT_ID_OR_NUMBER_2: Son el ID o el número de los dos proyectos con los que deseas compartir la reserva.

  • Para dejar de permitir que uno o más proyectos consuman una reserva compartida, debes hacer una solicitud PATCH al método reservations.update. En la URL de la solicitud, incluye el parámetro de búsqueda paths=shareSettings.projectMap.PROJECT_NUMBER para cada proyecto con el que deseas dejar de compartir la reserva. Además, debes omitir el campo shareSetting en el cuerpo de la solicitud.

    Por ejemplo, para dejar de permitir que dos proyectos consuman una reserva compartida, debes hacer una solicitud PATCH de la siguiente manera:

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_2

{
  "name": "RESERVATION_NAME"
}

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto en el que existe la reserva compartida (el proyecto propietario).

    • ZONE: Es la zona en la que existe la reserva compartida.

    • RESERVATION_NAME: el nombre de una reserva compartida existente.

    • CONSUMER_PROJECT_NUMBER_1 y CONSUMER_PROJECT_NUMBER_2: Son los números de los dos proyectos con los que deseas dejar de compartir la reserva.

Modifica la política de uso compartido de una reserva

Cuando modificas la política de uso compartido de una reserva de instancias de procesamiento con GPU, controlas si los trabajos de entrenamiento o predicción de Vertex AI consumen la reserva.

Antes de impedir que los trabajos de Vertex AI consuman una reserva, detén todos los trabajos de Vertex AI que la usen. De lo contrario, tendrás errores.

Para modificar la política de uso compartido de una reserva de instancias de GPU, selecciona una de las siguientes opciones:

Console

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

    Ir a Reservas

  2. En la pestaña Reservas según demanda (predeterminada), en la columna Nombre, haz clic en el nombre de la reserva de instancias de GPU que deseas modificar. Aparecerá una página con los detalles de la reserva.

  3. En la fila Compartir con otros servicios de Google Cloud, haz clic en Editar configuración de uso compartido de servicios.

  4. En el panel Uso compartido de reservas, realiza una de las siguientes acciones:

    • Para permitir que los trabajos de Vertex AI consuman la reserva, selecciona Compartir reserva.

    • Para no permitir que los trabajos de Vertex AI consuman la reserva, selecciona No compartir reserva.

  5. Haz clic en Guardar.

    La modificación de tu reserva puede tomar unos segundos en completarse.

gcloud

Para modificar la política de uso compartido de una reserva de instancias de GPU, usa el comando gcloud compute reservations update con la marca --reservation-sharing-policy.

gcloud compute reservations update RESERVATION_NAME \
    --reservation-sharing-policy=SHARING_POLICY \
    --zone=ZONE

Reemplaza lo siguiente:

  • RESERVATION_NAME: Es el nombre de una reserva existente.

  • SHARING_POLICY: Es la política de uso compartido de la reserva. Especifica uno de los siguientes valores:

    • Para permitir que los trabajos de Vertex AI consuman la reserva, haz lo siguiente: ALLOW_ALL

    • Para impedir que los trabajos de Vertex AI consuman la reserva, haz lo siguiente: DISALLOW_ALL

  • ZONE: Es la zona en la que existe la reserva.

REST

Para modificar la política de uso compartido de una reserva de instancias de GPU, realiza una solicitud PATCH al método reservations.update. En la URL de la solicitud, incluye el parámetro de consulta paths configurado como reservationSharingPolicy.serviceShareType.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=reservationSharingPolicy.serviceShareType

{
  "name": "RESERVATION_NAME",
  "reservationSharingPolicy": {
    "serviceShareType": "SHARING_POLICY"
  }
}

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto en el que existe la reserva.

  • ZONE: Es la zona en la que existe la reserva.

  • RESERVATION_NAME: Es el nombre de una reserva existente.

  • SHARING_POLICY: Es la política de uso compartido de la reserva. Especifica uno de los siguientes valores:

    • Para permitir que los trabajos de Vertex AI consuman la reserva, haz lo siguiente: ALLOW_ALL

    • Para impedir que los trabajos de Vertex AI consuman la reserva, haz lo siguiente: DISALLOW_ALL

Modifica la eliminación automática de una reserva

Puedes cambiar cuándo Compute Engine borra de forma automática una reserva existente mediante una de las siguientes acciones:

Para cambiar la eliminación automática de una reserva, elige una de las siguientes opciones:

Console

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

    Ir a Reservas

  2. En la pestaña Reservas según demanda (predeterminada), en la columna Nombre, haz clic en el nombre de la reserva que deseas modificar.

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

  3. En la fila Hora de eliminación automática, haz clic en Cambiar tiempo de eliminación automática.

  4. En el panel Actualizar reserva, realiza una de las siguientes acciones:

    • Para borrar la reserva en una fecha y hora específicas, haz lo siguiente:

      1. Si la opción de eliminación automática aún no está habilitada, haz clic en el botón de activación Habilitar eliminación automática.

      2. En el campo Hora de eliminación automática, escribe una fecha y hora en la que Compute Engine debe borrar la reserva de forma automática.

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

  5. Haz clic en Enviar.

    La modificación de tu reserva puede tomar unos segundos en completarse.

gcloud

Cuando habilitas la opción de eliminación automática en una reserva, puedes especificar una fecha y hora en la que se debe borrar la reserva o especificar una duración después de la cual se debe borrar la reserva.

Para habilitar la opción de eliminación automática o cambiar cuándo se debe borrar la reserva, realiza una de las siguientes acciones:

  • Para borrar la reserva en una fecha y hora específicas, usa el comando gcloud beta compute reservations update con la marca --delete-at-time.

    gcloud beta compute reservations update RESERVATION_NAME \
    --delete-at-time=DELETE_AT_TIME \
    --zone=ZONE

    Reemplaza lo siguiente:

    • RESERVATION_NAME: Es el nombre de una reserva existente.

    • DELETE_AT_TIME: Una fecha y una hora con el formato de una marca de tiempo RFC 3339.

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

  • Para borrar la reserva después de una duración específica, usa el comando gcloud beta compute reservations update con la marca --delete-after-duration.

    gcloud beta compute reservations update RESERVATION_NAME \
    --delete-after-duration=DELETE_AFTER_DURATION \
    --zone=ZONE

    Reemplaza lo siguiente:

    • RESERVATION_NAME: Es el nombre de una reserva existente.

    • DELETE_AFTER_DURATION: Es una duración en días, horas, minutos o segundos antes de que la reserva se borre de forma automática. Por ejemplo, especifica 30m para 30 minutos o 1d2h3m4s para 1 día, 2 horas, 3 minutos y 4 segundos.

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

Para inhabilitar la opción de eliminación automática, usa el comando gcloud beta compute reservations update con la marca --disable-auto-delete.

gcloud beta compute reservations update RESERVATION_NAME \
    --disable-auto-delete \
    --zone=ZONE

Reemplaza lo siguiente:

  • RESERVATION_NAME: Es el nombre de una reserva existente.

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

REST

Cuando habilitas la opción de eliminación automática en una reserva, puedes especificar una fecha y hora en la que se debe borrar la reserva o especificar cuánto tiempo debe existir una reserva antes de que se borre.

Para habilitar la opción de eliminación automática o cambiar cuándo se debe borrar la reserva, realiza una de las siguientes acciones:

  • Para borrar la reserva en una fecha y hora específicas, realiza una solicitud PATCH al método beta.reservations.update. En la URL de la solicitud, incluye el parámetro de consulta paths configurado como deleteAtTime.

    PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime

{
  "name": "RESERVATION_NAME",
  "deleteAtTime": "DELETE_AT_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.

    • RESERVATION_NAME: Es el nombre de una reserva existente.

    • DELETE_AT_TIME: Una fecha y una hora con el formato de una marca de tiempo RFC 3339.

  • Para borrar la reserva después de una duración específica, haz una solicitud PATCH al método beta.reservations.update. En la URL de la solicitud, incluye el parámetro de consulta paths configurado como deleteAfterDuration.seconds.

    PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAfterDuration.seconds

{
  "name": "RESERVATION_NAME",
  "deleteAfterDuration": {
    "seconds": "DELETE_AFTER_DURATION"
  }
}

    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.

    • RESERVATION_NAME: Es el nombre de una reserva existente.

    • DELETE_AFTER_DURATION: Es una duración en segundos antes de que la reserva se borre de forma automática. Por ejemplo, especifica 86400 para 86,400 segundos (1 día).

Para inhabilitar la opción de eliminación automática, realiza una solicitud PATCH al método beta.reservations.update. En la solicitud, especifica el parámetro de búsqueda paths=deleteAtTime&paths=deleteAfterDuration y omite el cuerpo de la solicitud.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime&paths=deleteAfterDuration

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.

  • RESERVATION_NAME: Es el nombre de una reserva existente.

¿Qué sigue?