Modificar reservas

Este documento explica cómo modificar las reservas. Para modificar las reservas adjuntas a los compromisos, consulte Reemplazar las reservas adjuntas a los compromisos .

Modifique una reserva cuando, por ejemplo, su capacidad necesite cambiar o desee cambiar qué cargas de trabajo pueden consumir una reserva.

Limitaciones

Antes de modificar una reserva, considere lo siguiente:

  • Solo puedes modificar una reserva compartida en el mismo proyecto donde la creaste.

  • Solo puede modificar una reserva creada automáticamente para una reserva futura después de que haya finalizado el período de reserva.

Antes de comenzar

  • Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

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

    Console

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

    gcloud

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

      gcloud init

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

    2. Set a default region and zone.

      3. REST

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

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

        gcloud init

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

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

Roles requeridos

Para obtener los permisos que necesita para modificar las reservas, solicite a su administrador que le otorgue el rol de IAM de Administrador de Compute ( roles/compute.admin ) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulte Administrar el acceso a proyectos, carpetas y organizaciones .

Este rol predefinido contiene los permisos necesarios para modificar las reservas. Para ver los permisos exactos que se requieren, expanda la sección Permisos requeridos :

Permisos requeridos

Se requieren los siguientes permisos para modificar reservas:

  • Para modificar la opción de eliminación automática en una reserva, los proyectos consumidores en una reserva compartida o si los trabajos de Vertex AI pueden consumir una reserva de instancias con GPU adjuntas: compute.reservations.update en el proyecto.
  • Para modificar el número de instancias en una reserva: compute.reservations.resize en el proyecto

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

Modificar reservas

Según las propiedades que desee modificar en una reserva, utilice uno de los siguientes métodos:

Para cambiar cualquier propiedad que no esté mencionada en esta lista, debe crear una nueva reserva. Para obtener instrucciones, consulte Cambiar otras propiedades en una reserva en este documento.

Modificar el borrado automático de una reserva

Puedes modificar cuándo Compute Engine elimina automáticamente una reserva existente realizando una de las siguientes acciones:

Para modificar el borrado automático de una reserva, seleccione una de las siguientes opciones:

Consola

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

    Ir a Reservas

  2. En la pestaña Reservas bajo demanda (predeterminada), en la columna Nombre , haga clic en el nombre de la reserva que desea modificar.

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

  3. En la fila Hora de eliminación automática , haga clic Editar hora de eliminación automática .

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

    • Para eliminar la reserva en una fecha y hora específica, haga lo siguiente:

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

      2. En el campo Hora de eliminación automática , ingresa una fecha y hora en la que Compute Engine elimine automáticamente la reserva.

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

  5. Haga clic en Enviar .

    La modificación de su reserva puede tardar unos segundos en completarse.

nube de gcloud

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

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

  • Para eliminar 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

    Reemplace lo siguiente:

    • RESERVATION_NAME : el nombre de una reserva existente.

    • DELETE_AT_TIME : fecha y hora formateadas como marca de tiempo RFC 3339 .

    • ZONE : la zona donde se encuentra la reserva.

  • Para eliminar 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

    Reemplace lo siguiente:

    • RESERVATION_NAME : el nombre de una reserva existente.

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

    • ZONE : la zona donde se encuentra la reserva.

Para deshabilitar la opción de eliminación automática, use 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

Reemplace lo siguiente:

  • RESERVATION_NAME : el nombre de una reserva existente.

  • ZONE : la zona donde se encuentra la reserva.

DESCANSAR

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

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

  • Para eliminar la reserva en una fecha y hora específica, realice una solicitud PATCH al método beta.reservations.update . En la URL de solicitud, incluya el parámetro de consulta de paths establecido en 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"
}

    Reemplace lo siguiente:

    • PROJECT_ID : el ID del proyecto donde se encuentra la reserva.

    • ZONE : la zona donde se encuentra la reserva.

    • RESERVATION_NAME : el nombre de una reserva existente.

    • DELETE_AT_TIME : fecha y hora formateadas como marca de tiempo RFC 3339 .

  • Para eliminar la reserva después de una duración específica, realice una solicitud PATCH al método beta.reservations.update . En la URL de solicitud, incluya el parámetro de consulta paths establecido en 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"
  }
}

    Reemplace lo siguiente:

    • PROJECT_ID : el ID del proyecto donde se encuentra la reserva.

    • ZONE : la zona donde se encuentra la reserva.

    • RESERVATION_NAME : el nombre de una reserva existente.

    • DELETE_AFTER_DURATION : una duración en segundos antes de que la reserva se elimine automáticamente. Por ejemplo, especifique 86400 durante 86.400 segundos (1 día).

Para deshabilitar la opción de eliminación automática, realice una solicitud PATCH al método beta.reservations.update . En la solicitud, especifique el parámetro de consulta paths=deleteAtTime&paths=deleteAfterDuration y omita el cuerpo de la solicitud.

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

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto donde se encuentra la reserva.

  • ZONE : la zona donde se encuentra la reserva.

  • RESERVATION_NAME : el nombre de una reserva existente.

Modificar los proyectos de consumidores en una reserva compartida.

Solo puedes permitir que los proyectos consuman una reserva compartida si estos proyectos están ubicados en la misma organización que el proyecto propietario. Para saber cómo migrar un proyecto a la organización del proyecto propietario, consulte Migración de proyectos entre recursos de la organización en la documentación del Administrador de recursos.

Después de modificar qué proyectos consumidores pueden consumir una reserva compartida, el consumo de la reserva podría cambiar. Por ejemplo, cualquier proyecto de consumidor eliminado deja de consumir recursos de la reserva. Además, si la reserva se configuró para ser consumida automáticamente por cualquier máquina virtual que coincida con las propiedades de la reserva (el comportamiento predeterminado), cualquier proyecto de consumidor agregado podría comenzar a consumir recursos de la reserva. Si desea monitorear el consumo de una reserva, consulte cómo verificar el consumo de las reservas .

Para modificar los proyectos consumidores que pueden consumir una reserva compartida, seleccione una de las siguientes opciones:

Consola

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

    Ir a Reservas

  2. En la pestaña Reservas bajo demanda (predeterminada), en la columna Nombre , haga clic en el nombre de la reserva que desea describir.

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

  3. Haga clic en Editar .

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

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

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

      1. Haga clic Agregar proyectos .

      2. Seleccione la casilla de verificación para cada proyecto de la organización del proyecto propietario con el que desea compartir la reserva.

      3. Haga clic en Seleccionar .

  5. Para confirmar sus cambios, haga clic en Guardar .

    La modificación de su reserva puede tardar unos segundos en completarse.

nube de gcloud

Cuando modifica los proyectos de consumo para una reserva compartida, debe especificar una lista separada por comas de ID de proyectos que desea permitir, o dejar de permitir, que consuman la reserva compartida. Estos proyectos deben estar en la misma organización que el proyecto propietario. No especifique el proyecto propietario en la lista. Por defecto ya está permitido consumir la reserva compartida.

Para modificar los proyectos de consumidores para una reserva compartida, seleccione uno de los siguientes métodos:

  • Para permitir que uno o más proyectos consuman una reserva compartida, use 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

    Reemplace lo siguiente:

    • RESERVATION_NAME : el nombre de una reserva compartida existente.

    • CONSUMER_PROJECT_IDS : una lista separada por comas de ID de proyectos con los que compartir la reserva. Por ejemplo, especifique project-1,project-2 .

    • ZONE : la zona donde se encuentra la reserva compartida.

  • 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

    Reemplace lo siguiente:

    • RESERVATION_NAME : el nombre de una reserva compartida existente.

    • CONSUMER_PROJECT_IDS : una lista separada por comas de ID de proyectos con los que desea dejar de compartir la reserva. Por ejemplo, especifique project-1,project-2 .

    • ZONE : la zona donde se encuentra la reserva compartida.

  • 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

    Reemplace lo siguiente:

    • RESERVATION_NAME : el nombre de una reserva compartida existente.

    • ZONE : la zona donde se encuentra la reserva compartida.

    • CONSUMER_PROJECT_IDS : una lista separada por comas de ID de proyectos con los que compartir la reserva. Por ejemplo, especifique project-1,project-2 .

DESCANSAR

Cuando modifica los proyectos de consumo para una reserva compartida, debe especificar los ID de los proyectos que desea permitir, o dejar de permitir, que consuman la reserva compartida. Estos proyectos deben estar en la misma organización que el proyecto propietario. No especifique el proyecto del propietario. Por defecto ya está permitido consumir la reserva compartida.

Para modificar los proyectos de consumidores para una reserva compartida, seleccione uno de los siguientes métodos:

  • Para permitir que uno o más proyectos consuman una reserva compartida, realice una solicitud PATCH al método reservations.update . En la URL de solicitud, incluya paths=shareSettings.projectMap. PROJECT_ID Parámetro de consulta paths=shareSettings.projectMap. PROJECT_ID para cada proyecto con el que desea compartir la reserva.

    Por ejemplo, para permitir que dos proyectos consuman una reserva compartida, realice la siguiente solicitud PATCH : 

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

{
  "name": "RESERVATION_NAME",
  "shareSetting": {
    "projectMap": {
      "CONSUMER_PROJECT_ID_1": {
        "projectId": "CONSUMER_PROJECT_ID_1"
      },
      "CONSUMER_PROJECT_ID_2": {
        "projectId": "CONSUMER_PROJECT_ID_2"
      }
    }
  }
}

    Reemplace lo siguiente:

    • PROJECT_ID : el ID del proyecto propietario, que es el proyecto utilizado para crear la reserva compartida.

    • ZONE : la zona donde se encuentra la reserva compartida.

    • RESERVATION_NAME : el nombre de una reserva compartida existente.

    • CONSUMER_PROJECT_ID_1 y CONSUMER_PROJECT_ID_2 : los ID de dos proyectos con los que desea compartir la reserva.

  • Para dejar de permitir que uno o más proyectos consuman una reserva compartida, realice una solicitud PATCH al método reservations.update . En la URL de solicitud, incluya paths=shareSettings.projectMap. PROJECT_ID Parámetro de consulta paths=shareSettings.projectMap. PROJECT_ID para cada proyecto con el que desea dejar de compartir la reserva. Además, debe omitir el campo shareSetting del cuerpo de la solicitud.

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

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

{
  "name": "RESERVATION_NAME"
}

    Reemplace lo siguiente:

    • PROJECT_ID : el ID del proyecto propietario, que es el proyecto utilizado para crear la reserva compartida.

    • ZONE : la zona donde se encuentra la reserva compartida.

    • RESERVATION_NAME : el nombre de una reserva compartida existente.

    • CONSUMER_PROJECT_ID_1 y CONSUMER_PROJECT_ID_2 : los ID de dos proyectos con los que deseas dejar de compartir la reserva.

Modificar el número de instancias reservadas en una reserva

Puede aumentar o disminuir la cantidad de instancias informáticas reservadas en una reserva. Sin embargo, antes de modificar el número de instancias, considere lo siguiente para evitar errores:

  • Para aumentar el número de instancias en cualquier reserva, asegúrese de lo siguiente:

  • Para disminuir la cantidad de instancias en una reserva específica , asegúrese de que la cantidad de instancias que consumen la reserva no exceda la nueva cantidad más pequeña. Si es así, realice una de las siguientes acciones con las instancias que excedan el nuevo número:

    • Eliminar instancias

    • Detener o suspender las instancias

Para modificar el número de instancias reservadas en una reserva, seleccione una de las siguientes opciones:

Consola

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

    Ir a Reservas

  2. En la pestaña Reservas bajo demanda (predeterminada), en la columna Nombre , haga clic en el nombre de la reserva que desea modificar.

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

  3. Haga clic en Editar .

  4. En el campo Número de instancias de VM , ingrese el número actualizado de instancias para reservar.

  5. Para confirmar, haga clic en Guardar .

    La modificación de su reserva puede tardar unos segundos en completarse.

nube de gcloud

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

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

Reemplace lo siguiente:

  • RESERVATION_NAME : el nombre de una reserva existente.

  • NUMBER_OF_VMS : el nuevo número de instancias para reservar.

  • ZONE : la zona donde se encuentra la reserva.

DESCANSAR

Para modificar la cantidad de instancias reservadas en una reserva, realice 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"
}

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto donde se encuentra la reserva.

  • ZONE : la zona donde se encuentra la reserva.

  • RESERVATION_NAME : el nombre de una reserva existente.

  • NUMBER_OF_VMS : el nuevo número de instancias para reservar.

Modificar la política de compartir de una reserva

Cuando modifica la política de uso compartido de una reserva de instancias informáticas de GPU, puede permitir o no permitir que trabajos de entrenamiento personalizados o trabajos de predicción en Vertex AI consuman la reserva.

Si desea impedir que Vertex AI consuma una reserva, antes de modificar la reserva, asegúrese de que no haya trabajos de entrenamiento personalizados ni trabajos de predicción que consuman la reserva. De lo contrario, encontrará errores.

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

Consola

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

    Ir a Reservas

  2. En la pestaña Reservas bajo demanda (predeterminada), en la columna Nombre , haga clic en el nombre de la reserva de instancias de GPU que desea modificar.

    Se abre la página de 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 Compartir reserva , realice una de las siguientes acciones:

    • Para permitir que Vertex AI consuma la reserva, seleccione Compartir reserva .

    • Para impedir que Vertex AI consuma la reserva, seleccione No compartir reserva .

  5. Haga clic en Guardar .

    La modificación de su reserva puede tardar unos segundos en completarse.

nube de gcloud

Para modificar la política de uso compartido de una reserva de instancias de GPU, use 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

Reemplace lo siguiente:

  • RESERVATION_NAME : el nombre de una reserva existente.

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

    • Para permitir que Vertex AI consuma la reserva: ALLOW_ALL

    • Para impedir que Vertex AI consuma la reserva: DISALLOW_ALL

  • ZONE : la zona donde se encuentra la reserva.

DESCANSAR

Para modificar la política de uso compartido de una reserva de instancias de GPU, realice una solicitud PATCH al método reservations.update . En la URL de solicitud, incluya el parámetro de consulta paths establecido en 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"
  }
}

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto donde se encuentra la reserva.

  • ZONE : la zona donde se encuentra la reserva.

  • RESERVATION_NAME : el nombre de una reserva existente.

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

    • Para permitir que Vertex AI consuma la reserva: ALLOW_ALL

    • Para impedir que Vertex AI consuma la reserva: DISALLOW_ALL

Cambiar otras propiedades en una reserva

Si desea modificar una propiedad que no se menciona en la sección Modificar reservas , debe crear una reserva de reemplazo.

Para reemplazar una reserva sin correr el riesgo de una reducción no deseada en su capacidad reservada, haga lo siguiente:

  1. Cree un nuevo proyecto único o una reserva compartida con propiedades actualizadas.

  2. Si ya no necesitas la reserva original, elimina la reserva .

Solucionar problemas

Aprenda cómo solucionar problemas con las actualizaciones de reservas .

¿Qué sigue?