En este documento, se explica cómo cambiar una reserva existente.
Si deseas modificar una reserva compartida, debes usar el proyecto de propietario.
Si deseas cambiar una reserva vinculada a un compromiso, consulta Reemplaza las reservas adjuntas a los compromisos.
Antes de comenzar
- Revisa los requisitos y las y las restricciones para las reservas.
-
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 un código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera.
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
Para cambiar la opción de eliminación automática en una reserva o los proyectos de consumidor en una reserva compartida, usa
compute.reservations.update
en el proyecto. -
Para cambiar la cantidad de VMs en una reserva, usa
compute.reservations.resize
en el proyecto. Modifica la eliminación automática de una reserva.
Puedes habilitar la opción de eliminación automática para una reserva, cambiar la fecha y la hora en que Compute Engine borra una reserva de forma automática o inhabilitar la eliminación automática de la reserva.
Modifica los proyectos de consumidor en una reserva compartida.
Puedes agregar o quitar los proyectos de consumidor que pueden consumir una reserva compartida.
Modifica la cantidad de VMs reservadas en una reserva.
Puedes aumentar o disminuir la cantidad de instancias de máquina virtual (VM) reservadas en una reserva.
Habilita la opción de eliminación automática o cambia cuando se borra la reserva de forma automática.
Inhabilita la opción de eliminación automática.
En la consola de Google Cloud, ve a la página Reservas.
En la columna Nombre, haz clic en el nombre de la reserva futura que deseas cambiar.
Se abrirá la página de detalles de la reserva futura elegida
En la fila Hora de eliminación automática, haz clic en
Cambiar tiempo de eliminación automática.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:
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.
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.
Haz clic en Enviar.
La modificación de tu reserva puede tomar unos segundos en completarse.
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 \ --project=PROJECT_ID \ --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, 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, especificaZ
.
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.
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 \ --project=PROJECT_ID \ --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, especifica30m
para 30 minutos o1d2h3m4s
para 1 día, 2 horas, 3 minutos y 4 segundos.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.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.Para borrar la reserva en una fecha y hora específicas, realiza una solicitud
PATCH
al métodobeta.reservations.update
con el parámetro de consultapaths
configurado comodeleteAtTime
.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, 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, especificaZ
.
Para borrar la reserva después de un período específico, realiza una solicitud
PATCH
al métodobeta.reservations.update
con el parámetro de consultapaths
configurado comodeleteAfterDuration
.PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAfterDuration { "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, especifica86400
para 86,400 segundos (1 día).
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.En la consola de Google Cloud, ve a la página Reservas.
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.
Haz clic en
Cambiar.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:
Haz clic en
Agregar proyectos.Selecciona la casilla de verificación de cada proyecto de la organización del proyecto propietario con el que deseas compartir la reserva.
Haz clic en Seleccionar.
Para confirmar los cambios, haz clic en Guardar.
La modificación de tu reserva puede tomar unos segundos en completarse.
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 \ --project=PROJECT_ID \ --add-share-with=CONSUMER_PROJECT_IDS \ --zone=ZONE
Reemplaza lo siguiente:
RESERVATION_NAME
: por el nombre de una reserva compartida existente.PROJECT_ID
: el ID del proyecto propietario, que es el proyecto que se usa para crear la reserva compartida.CONSUMER_PROJECT_IDS
: una lista separada por comas de IDs de proyectos con los que se debe compartir la reserva. Por ejemplo, especificaproject-1,project-2
.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 \ --project=PROJECT_ID \ --remove-share-with=CONSUMER_PROJECT_IDS \ --zone=ZONE
Reemplaza lo siguiente:
RESERVATION_NAME
: por el nombre de una reserva compartida existente.PROJECT_ID
: el ID del proyecto propietario, que es el proyecto que se usa para crear la reserva compartida.CONSUMER_PROJECT_IDS
: una lista separada por comas de los IDs de los proyectos con los que deseas dejar de compartir la reserva. Por ejemplo, especificaproject-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 \ --project=PROJECT_ID \ --share-with=CONSUMER_PROJECT_IDS \ --zone=ZONE
Reemplaza lo siguiente:
RESERVATION_NAME
: por el nombre de una reserva compartida existente.PROJECT_ID
: el ID del proyecto propietario, que es el proyecto que se usa para crear la reserva compartida.ZONE
: Es la zona en la que se encuentra la reserva.CONSUMER_PROJECT_IDS
: una lista separada por comas de IDs de proyectos con los que se debe compartir la reserva. Por ejemplo, especificaproject-1,project-2
.
Para permitir que uno o más proyectos consuman una reserva compartida, debes llevar a cabo una solicitud
PATCH
al métodoreservations.update
. En la URL de la solicitud, incluye el parámetro de búsquedapaths=shareSettings.projectMap.PROJECT_ID
para cada proyecto con el que desees compartir la reserva.Por ejemplo, para permitir que dos proyectos consuman una reserva compartida, debes hacer 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" } } } }
Reemplaza lo siguiente:
PROJECT_ID
: el ID del proyecto propietario, que es el proyecto que se usa para crear la reserva compartida.ZONE
: Es la zona en la que se encuentra la reserva.RESERVATION_NAME
: el nombre de una reserva compartida existente.CONSUMER_PROJECT_ID_1
yCONSUMER_PROJECT_ID_2
: Son los IDs de 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étodoreservations.update
. En la URL de la solicitud, incluye el parámetro de consultapaths=shareSettings.projectMap.PROJECT_ID
para cada proyecto con el que deseas dejar de compartir la reserva. Además, debes omitir el camposhareSetting
en el cuerpo de la solicitud.Por ejemplo, para dejar de permitir que dos proyectos consuman una reserva compartida, debes hacer 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" }
Reemplaza lo siguiente:
PROJECT_ID
: el ID del proyecto propietario, que es el proyecto que se usa para crear la reserva compartida.ZONE
: Es la zona en la que se encuentra la reserva.RESERVATION_NAME
: el nombre de una reserva compartida existente.CONSUMER_PROJECT_ID_1
yCONSUMER_PROJECT_ID_2
: Son los IDs de dos proyectos con los que deseas dejar de compartir la reserva.
Si deseas aumentar la cantidad de VMs reservadas en una reserva, se aplican las siguientes restricciones:
Debe haber suficientes recursos en la zona en la que se encuentra la reserva.
Debes tener una cuota suficiente para los recursos adicionales que reservas.
Si el tipo de consumo de tu reserva es específico y deseas disminuir la cantidad de VMs reservadas, asegúrate de que la cantidad de VMs que consume la reserva no exceda el tamaño de la reserva que deseas. Puedes hacerlo con los siguientes métodos:
De lo contrario, se encuentranerrores.
En la consola de Google Cloud, ve a la página Reservas.
En la columna Nombre, haz clic en el nombre de la reserva futura que deseas cambiar.
Se abrirá la página de detalles de la reserva.
Haz clic en
Cambiar.En el campo Cantidad de instancias de VMs, escribe la cantidad actualizada de VM que se reservarán.
Para confirmar, haz clic en Guardar.
La modificación de tu reserva puede tomar unos segundos en completarse.
RESERVATION_NAME
: Es el nombre de una reserva existente.PROJECT_ID
: El ID del proyecto en el que se encuentra la reserva futura.NUMBER_OF_VMS
: La nueva cantidad de VMs que se reservarán.ZONE
: Es la zona en la que se encuentra la reserva.PROJECT_ID
: El ID del proyecto en el que se encuentra la reserva.ZONE
: Es la zona en la que se encuentra la reserva.RESERVATION_NAME
: Es el nombre de una reserva existente.NUMBER_OF_VMS
: La nueva cantidad de VMs que se reservarán.Crea un proyecto único o una reserva compartida con propiedades actualizadas.
Si ya no necesitas la reserva original, borra la reserva.
Obtén información sobre cómo ver tus reservas.
Obtén información sobre cómo consumir reservas.
Obtén más información sobre cómo borrar reservas.
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
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.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:
También puedes obtener estos permisos con funciones personalizadas o con otras funciones predefinidas
Modifica reservas
Para modificar una reserva existente directamente, puedes realizar una o más de las siguientes acciones:
Si deseas cambiar alguna propiedad que no se menciona en esta lista, consulta Cambia otras propiedades en una reserva en este documento.
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
Para cambiar la eliminación automática de una reserva, sigue estos pasos:
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 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 \ --project=PROJECT_ID \ --zone=ZONE
Reemplaza lo siguiente:
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 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 inhabilitar la opción de eliminación automática, realiza una solicitud
PATCH
al métodobeta.reservations.update
. En la solicitud, especifica el parámetro de búsquedapaths=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:
Modifica los proyectos de consumidor en una reserva compartida
Solo puedes permitir que los proyectos consuman una reserva compartida si estos proyectos se encuentran en la misma organización que el proyecto propietario. Si deseas obtener información para migrar un proyecto a la organización del proyecto de propietario, consulta Migra proyectos entre recursos de la organización en la documentación de Resource Manager.
Después de cambiar qué proyectos de consumidor pueden consumir una reserva compartida, el consumo de la reserva puede cambiar. Por ejemplo, cualquier proyecto de consumidor que se quitó dejó de consumir recursos de la reserva. Además, si la reserva se configuró para que la consuma automáticamente cualquier VM que coincida con las propiedades de la reserva (el comportamiento predeterminado), cualquier proyecto de consumidor agregado podría empezar a consumir recursos de la reserva. Si deseas supervisar el consumo de una reserva, consulta cómo verificar el consumo de las reservas.
Para cambiar los proyectos de consumidor que pueden consumir una reserva compartida, elige una de las siguientes opciones:
Console
Para cambiar los proyectos de consumidor de una reserva compartida, sigue estos pasos:
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. Estos proyectos deben estar en la misma organización que el proyecto de propietario. No especifiques el proyecto propietario en la lista. De forma predeterminada, ya tiene permitido consumir la reserva compartida.
Para cambiar los proyectos de consumidor de una reserva compartida, elige uno de los siguientes métodos:
REST
Cuando modificas los proyectos de consumidor destinados a una reserva compartida, debes especificar los IDs de los proyectos que deseas o no permitir que consuman la reserva compartida. Estos proyectos deben estar en la misma organización que el proyecto de propietario. No especifiques el proyecto de propietario. De forma predeterminada, ya tiene permitido consumir la reserva compartida.
Para cambiar los proyectos de consumidor de una reserva compartida, elige uno de los siguientes métodos:
Modifica la cantidad de VMs reservadas en una reserva
Puedes cambiar una reserva existente para aumentar o disminuir la cantidad de VMs reservadas.
Antes de cambiar la cantidad de VMs reservadas en una reserva, asegúrate de lo siguiente:'
Para cambiar la cantidad de VMs reservadas en una reserva, elige una de las siguientes opciones:
Console
Para cambiar la cantidad de VMs reservadas en una reserva, sigue estos pasos:
gcloud
Para cambiar la cantidad de VMs reservadas en una reserva, usa el comando
gcloud compute reservations update
.gcloud compute reservations update RESERVATION_NAME \ --project=PROJECT_ID \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Reemplaza lo siguiente:
REST
Para cambiar la cantidad de VMs reservadas en una reserva, realiza una solicitud
POST
al métodoreservations.resize
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/resize { "specificSkuCount": "NUMBER_OF_VMS" }
Reemplaza lo siguiente:
Cambia otras propiedades en una reserva
Si deseas modificar una propiedad que no se menciona en la sección Modifica reservas, debes crear una reserva de reemplazo.
Para reemplazar una reserva sin correr el riesgo de una reducción no deseada en tu capacidad reservada, haz lo siguiente:
Solucionar problemas
Obtén más información sobre cómo solucionar problemas con las actualizaciones de reservas.
¿Qué sigue?
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-09-03 (UTC)
-