En este documento, se explica cómo administrar las solicitudes de reserva futuras. En particular, haz lo siguiente:
Modificar un borrador o una solicitud de reserva futura enviada para cambiar una o más de sus propiedades
Cancela una solicitud de reserva futura para evitar que Google Cloud la revise o impida que ingrese una hora de bloqueo para una reserva futura aprobada.
Borra una reserva futura antes de que ingrese al tiempo de bloqueo requerido o después de que finalice el período de la reserva.
Si deseas administrar las reservas creadas de forma automática para una reserva futura completada después del final de su período de reserva, consulta lo siguiente:
Antes de comenzar
-
Configura la autenticación si aún no lo hiciste.
La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API de Google Cloud.
Para ejecutar un código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera.
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 cancelar una reserva futura, usa
compute.futureReservations.cancel
en el proyecto -
Para borrar una reserva futura, usa
compute.futureReservations.delete
en el proyecto. -
Para modificar una reserva futura, usa
compute.futureReservations.update
en el proyecto. Solo puedes modificar, cancelar o borrar una solicitud de reserva futura desde el proyecto en el que se creó la solicitud de reserva futura. Esto te permite compartir una solicitud de reserva futura con otros proyectos, pero los usuarios con permisos solo para otros proyectos no pueden modificar la solicitud de reserva futura.
Solo puedes modificar, cancelar o borrar una solicitud de reserva futura si su estado de adquisición lo permite. Para obtener más información, consulta la siguiente tabla:
Estado de la adquisición Cancelar Borrar Modificar En borrador ( DRAFTING
)Aprobación pendiente ( PENDING_APPROVAL
)Aprobado ( APPROVED
)Rechazado ( DECLINED
)Cancelados ( CANCELED
)Obteniéndose ( PROCURING
)Suministro ( PROVISIONING
)Entregado ( FULFILLED
)* Parcialmente entregados ( FAILED_PARTIALLY_FULFILLED
)* Con errores ( FAILED
)* * Puedes borrar una reserva futura completada, parcialmente completada o con errores solo después de su hora de finalización.
Para cualquier reserva futura:
El nombre de la reserva futura.
El proyecto en el que se creó la solicitud de reserva futura.
: Es la zona en la que se encuentra la reserva.
Para solicitudes de reserva futuras creadas mediante la especificación de una plantilla de instancias:
No puedes anular las propiedades de la VM especificadas en la plantilla de instancias.
No puedes reemplazar la plantilla de instancias que se usa para crear una solicitud de reserva futura con otra plantilla.
Modifica un borrador o una solicitud de reserva futura rechazada.
En esta sección, se explica cómo modificar una solicitud de reserva futura con un estado de adquisición establecido como Borrador (
DRAFTING
) o Rechazado (DECLINED
).Modifica una reserva futura aprobada o en curso.
En esta sección, se explica cómo modificar una reserva futura con un estado de adquisición establecido como Aprobado (
APPROVED
) o Adquirido (PROCURING
). Si deseas modificar la opción de eliminación automática, la descripción o el prefijo de nombre de una reserva futura, puedes modificarlos sin revisión. De lo contrario, si deseas modificar otras propiedades, necesitas la aprobación de Google Cloud.-
En esta sección, se explica cómo modificar una o más propiedades en un borrador o una solicitud de reserva futura rechazada mediante la especificación de una plantilla de instancias. No puedes modificar las propiedades de una VM de una solicitud de reserva futura. En su lugar, debes crear una reserva nueva.
-
En esta sección, se explica cómo modificar una o más propiedades en un borrador o una solicitud de reserva futura rechazada que se creó directamente mediante la especificación de propiedades.
Eliminación automática
Descripción
Prefijo del nombre
Configuración de uso compartido
Hora de inicio y finalización del período de reserva
Recuento total (cantidad de VM)
En la consola de Google Cloud, ve a la página Reservas.
Haz clic en la pestaña Reservas futuras.
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.
Para modificar la solicitud de reserva futura, haz clic en
Editar o Editar borrador.Se abrirá la página para editar la solicitud de reserva futura seleccionada.
Tener conocimiento sobre uno o más de los siguientes temas:
En el campo Prefijo, ingresa un prefijo de nombre nuevo.
En el campo Descripción, ingresa una descripción nueva.
Modifica la Hora de inicio o la Hora de finalización de la solicitud de reserva futura. Asegúrate de que se den las siguientes condiciones:
La hora de inicio no puede ser posterior a 1 año a partir de la fecha y hora en que envías una solicitud de reserva futura para su revisión.
Especifica un valor recomendado para la hora de inicio a fin de asegurarte de que tienes tiempo suficiente antes de que tu reserva futura ingrese a la hora de bloqueo.
Especifica un período de reserva mínimo recomendado para aumentar la probabilidad de que con Google Cloud se apruebe tu solicitud después de enviarla para su revisión.
En la sección Tipo de recurso compartido, puedes seleccionar Local o Compartido. Si seleccionas Compartido, puedes agregar o quitar proyectos para compartir la solicitud de reserva futura.
Puedes seleccionar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto en el que se creó la solicitud de reserva futura (el proyecto de propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se pueden consumir las reservas creadas de forma automática para esta solicitud de reserva futura.
En el campo Cantidad de instancias de VM, ingresa el recuento total de VMs que deseas reservar para el período, la configuración de VM y los proyectos especificados en esta solicitud de reserva futura.
Cuando se calcula la cantidad de reservas que se crearán para una reserva futura aprobada, primero se verifica con Compute Engine las reservas existentes. Si hay reservas existentes que coinciden con la reserva futura aprobada, la cantidad de reservas existentes se resta de la cantidad total solicitada de reservas en la solicitud para determinar la cantidad de reservas nuevas creadas con Compute Engine. Para obtener más información, consulta cómo se cuenta y produce recursos reservados con Compute Engine.
En la sección Reservas generadas automáticamente, puedes habilitar o inhabilitar la eliminación automática de las reservas creadas de forma automática para tu solicitud de reserva futura.
Opcional. Si habilitas la opción de eliminación automática, puedes especificar la fecha y la hora en que Compute Engine borra las reservas creadas de forma automática. La fecha y la hora deben ser posteriores a la hora de finalización del período de reserva. Si dejas este campo vacío, las reservas creadas de forma automática se borran en un plazo de 2 horas después de la hora de finalización del período de reserva.
Según el estado de adquisición de la solicitud de reserva futura que modificas, realiza una de las siguientes acciones:
Para un borrador de solicitud de reserva futura, selecciona una de las siguientes opciones:
Para guardar los cambios, haz clic en Guardar.
Si deseas enviar el borrador de una solicitud de reserva futura a Google Cloud para su revisión, haz clic en Enviar.
En el caso de una solicitud de reserva futura rechazada, solo puedes enviarla para su revisión si haces clic en Enviar.
Si envías una solicitud, se abrirá la página Reservas. De lo contrario, se abrirá la página de detalles de la solicitud de reserva futura.
FUTURE_RESERVATION_NAME
: El nombre de un borrador existente o una solicitud de reserva futura rechazada.DESCRIPTION
: Opcional Una descripción nueva para la solicitud de reserva futura.NAME_PREFIX
: Opcional Un nuevo prefijo de nombre para la solicitud de reserva futura. El nombre de cada reserva creada de forma automática para esta solicitud de reserva futura comienza con el prefijo del nombre. Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, se recomienda especificar un prefijo de nombre único.PLANNING_STATUS
: Es el estado de planificación de la solicitud de reserva futura. Solo puedes especificarSUBMITTED
que envía la solicitud de reserva futura a Google Cloud para su revisión.PROJECT_ID
: Opcional El ID del proyecto en el que se creó la solicitud de reserva futura. Si modificas una solicitud de reserva futura de un solo proyecto en una solicitud de reserva futura compartida, este proyecto se convierte en el proyecto propietario de la solicitud de reserva futura. Si omites la marca--project
, el valor se establece en el ID del proyecto actual.SHARE_SETTING
: Opcional Para cambiar el tipo de solicitud de reserva futura, especifica uno de los siguientes valores:Para cambiar una solicitud de reserva futura de un solo proyecto a una solicitud de reserva futura compartida, especifica
projects
. Asegúrate de especificar al menos un proyecto de consumidor en la marca--share-with
. De lo contrario, la modificación de la reserva futura fallará.De lo contrario, especifica
local
.
CONSUMER_PROJECT_IDS
: Opcional Una lista separada por comas de los ID de los proyectos con los que se puede compartir esta solicitud de reserva futura. Por ejemplo, especificaproject-1,project-2
. Puedes especificar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto en el que se creó esta solicitud de reserva futura (el proyecto propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se pueden consumir las reservas creadas de forma automática para esta solicitud de reserva futura.START_TIME
: Opcional La hora de inicio del período de reserva con el formato de marca de tiempo RFC 3339, que debe ser la siguiente:YYYY-MM-DDTHH:MM:SSOFFSET
Reemplaza lo siguiente:
YYYY-MM-DD
: una fecha con formato de un año de 4 dígitos, un mes de 2 dígitos y un día de 2 dígitos del mes separado por guiones (-
)HH:MM:SS
: una hora con formato de hora de 2 dígitos con un formato de 24 horas, minutos de 2 dígitos y segundos de 2 dígitos separados por dos puntos (:
)OFFSET
: la zona horaria con formato como una compensación del horario universal coordinado (UTC). Por ejemplo, para usar la hora estándar del Pacífico (PST), especifica-08:00
. Como alternativa, para no usar compensación, especificaZ
.
La hora de inicio no puede ser posterior a 1 año a partir de la fecha y hora en que envías una solicitud de reserva futura para su revisión. A fin de tener tiempo suficiente para cancelar, borrar o modificar una reserva futura de forma opcional después de que se apruebe o antes de que ingrese a la hora de bloqueo, asegúrate de especificar una hora de inicio recomendada. .
END_TIME
: Opcional : La hora de finalización del período de reserva con un formato de marca de tiempo RFC 3339. El período de reserva debe durar al menos 24 horas. Como alternativa, puedes reemplazar la marca--end-time
por la marca--duration=END_DURATION
, en la queEND_DURATION
es la duración del período de reserva en segundos. Por ejemplo, especifica1209600
para 1,209,600 segundos (14 días).Para aumentar la probabilidad de que a través de Google Cloud se apruebe una solicitud de reserva futura después de enviarla para su revisión, asegúrate de especificar uno de los valores recomendados para el período de la reserva.
TOTAL_COUNT
: Opcional : La cantidad total de VMs que deseas reservar para el período, la configuración de VM y los proyectos especificados en esta solicitud de reserva futura.Cuando se calcula la cantidad de reservas que se crearán para una reserva futura aprobada, Compute Engine primero verifica las reservas existentes. Si hay reservas existentes que coinciden con la reserva futura aprobada, la cantidad de reservas existentes se resta de la cantidad total solicitada de reservas en la solicitud para determinar la cantidad de reservas nuevas creadas con Compute Engine Para obtener más información, consulta cómo se cuenta y produce recursos reservados con Compute Engine.
Precaución: Asegúrate de tener suficiente cuota para los recursos que solicitas reservar. De lo contrario, en Google Cloud se rechazará tu solicitud de reserva futura.
ZONE
: La zona en la que se encuentra la solicitud de reserva futura.Para permitir la eliminación de forma automática de las reservas creadas de forma automática después de la hora de finalización del período de reserva mediante Compute Engine, selecciona uno de los siguientes métodos:
Para borrar las reservas dentro de las 2 horas posteriores a la hora de finalización (predeterminada), especifica la marca
--auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations
Para borrar las reservas creadas de forma automática en un momento específico después de la hora de finalización del período de reserva, especifica las marcas
--auto-delete-auto-created-reservations
y--auto-created-reservations-delete-time
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
Reemplaza
AUTO_CREATED_RESERVATIONS_DELETE_TIME
por una fecha y hora con formato de marca de tiempo RFC 3339.Para borrar las reservas creadas de forma automática después de una duración específica después de la hora de finalización del período de reserva, especifica las marcas
--auto-delete-auto-created-reservations
y--auto-created-reservations-duration
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-duration=DURATION_BEFORE_DELETE
Reemplaza
DURATION_BEFORE_DELETE
por una duración en días, horas, minutos o segundos. Por ejemplo, especifica30m
para 30 minutos o1d2h3m4s
para 1 día, 2 horas, 3 minutos y 4 segundos.
Para inhabilitar Compute Engine de modo que se borren de forma automática las reservas creadas de forma automática, especifica la marca
--no-auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --no-auto-delete-auto-created-reservations
Convertirlo en una solicitud de reserva futura de un solo proyecto
Inhabilita la opción de eliminación automática.
Reserva 100 VM.
Envía la solicitud de reserva futura a Google Cloud para su aprobación.
PROJECT_ID
por el ID del proyecto en el que se encuentra la solicitud de reserva futura.ZONE
: La zona en la que se encuentra la solicitud de reserva futura.FUTURE_RESERVATION_NAME
: El nombre de un borrador existente o una solicitud de reserva futura rechazada. No puedes modificar el nombre de una solicitud de reserva futura.UPDATE_FIELDS
: Una lista de campos separados por comas que se actualizarán en esta solicitudPATCH
. Debes codificar cada coma como%2C
. Por ejemplo, si deseas actualizar los camposautoDeleteAutoCreatedReservations
,totalCount
yendTime
en tu solicitud de reserva futura, especifica lo siguiente: haz lo siguiente:autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
AUTO_DELETE_AUTO_CREATED_RESERVATIONS
: Opcional Si configuras este campo comotrue
, se borra de forma automática a través de Compute Engine las reservas creadas de forma automática para esta solicitud de reserva de reserva futura. De forma predeterminada, la hora de eliminación se encuentra dentro de las 2 horas después de la hora de finalización del período de reserva. Para cambiar esto, realiza una de las siguientes acciones:Para borrar las reservas creadas de forma automática en un momento específico después de la hora de finalización de tu período de reserva, configura
autoDeleteAutoCreatedReservations
comotrue
y especifica el campoautoCreatedReservationsDeleteTime
.PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDeleteTime": "DELETE_TIME" }
Reemplaza
DELETE_TIME
por una fecha y hora en la que se borren las reservas con Compute Engine La fecha y la hora deben tener el formato de una marca de tiempo RFC 3339, que debe ser de la siguiente manera:YYYY-MM-DDTHH:MM:SSOFFSET
Reemplaza lo siguiente:
YYYY-MM-DD
: una fecha con formato de un año de 4 dígitos, un mes de 2 dígitos y un día de 2 dígitos del mes separado por guiones (-
)HH:MM:SS
: una hora con formato de hora de 2 dígitos con un formato de 24 horas, minutos de 2 dígitos y segundos de 2 dígitos separados por dos puntos (:
)OFFSET
: la zona horaria con formato como una compensación del horario universal coordinado (UTC). Por ejemplo, para usar la hora estándar del Pacífico (PST), especifica-08:00
. Como alternativa, para no usar compensación, especificaZ
.
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
comotrue
y especifica el campoautoCreatedReservationsDuration
.PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDuration": { "seconds": "DURATION_BEFORE_DELETE" } }
Reemplaza
DURATION_BEFORE_DELETE
por una duración en segundos. Por ejemplo, especifica604800
para 604,800 segundos (7 días).
DESCRIPTION
: Opcional Para actualizar la descripción de esta solicitud de reserva futura, realiza una de las siguientes acciones:Para agregar o actualizar una descripción, especifica una descripción.
Para quitar la descripción, borra el campo
description
del cuerpo de la solicitud y especifícalo enUPDATE_FIELDS
.
NAME_PREFIX
: Opcional Un nuevo prefijo de nombre para la solicitud de reserva futura. El nombre de cada reserva creada de forma automática para esta solicitud de reserva futura comienza con el prefijo del nombre. Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, se recomienda especificar un prefijo de nombre único.PLANNING_STATUS
: Es el estado de planificación de la solicitud de reserva futura. Solo puedes especificarSUBMITTED
que envía la solicitud de reserva futura a Google Cloud para su revisión.SHARE_TYPE
: Opcional Para cambiar el tipo de recurso compartido de esta solicitud de reserva futura, especifica uno de los siguientes valores:Para cambiar una solicitud de reserva futura de un solo proyecto a una solicitud de reserva futura compartida, especifica
SPECIFIC_PROJECTS
. Además, debes especificar al menos un proyecto de consumidor en el campoprojects
. De lo contrario, la creación de la solicitud de reserva futura fallará.De lo contrario, especifica
LOCAL
. Además, debes borrar el campoprojects
del cuerpo de la solicitud y especificarlo enUPDATE_FIELDS
. De lo contrario, la creación de la solicitud de reserva futura fallará.
CONSUMER_PROJECT_ID_1
yCONSUMER_PROJECT_ID_2
: opcional. Los ID de los proyectos con los que se puede compartir una solicitud de reserva futura. Puedes especificar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto en el que se creó la solicitud de reserva futura (el proyecto de propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se pueden consumir las reservas creadas de forma automática para esta solicitud de reserva futura.TOTAL_COUNT
: Opcional : La cantidad total de VMs que deseas reservar para el período, la configuración de VM y los proyectos especificados en esta solicitud de reserva futura.Cuando se calcula la cantidad de reservas que se crearán para una reserva futura aprobada, Compute Engine primero verifica las reservas existentes. Si hay reservas existentes que coinciden con la reserva futura aprobada, la cantidad de reservas existentes se resta de la cantidad total solicitada de reservas en la solicitud para determinar la cantidad de reservas nuevas creadas con Compute Engine Para obtener más información, consulta cómo se cuenta y produce recursos reservados con Compute Engine.
START_TIME
: Opcional La nueva hora de inicio del período de reserva con formato de marca de tiempo RFC 3339. La hora de inicio no puede ser posterior a 1 año a partir de la fecha y hora en que envías una solicitud de reserva futura para su revisión. Además, asegúrate de especificar una hora de inicio recomendada para garantizar que tienes tiempo suficiente antes de que una reserva futura ingrese a la hora de bloqueo.END_TIME
: Opcional : La hora de finalización del período de reserva con un formato de marca de tiempo RFC 3339. El período de reserva debe durar al menos 24 horas. Como alternativa, puedes reemplazar el campoendTime
por el campoduration
para especificar una duración específica desde la hora de inicio del período de reserva:"duration": { "seconds": "END_DURATION" }
Reemplaza
END_DURATION
por una duración en segundos. Por ejemplo, especifica1209600
para 1,209,600 segundos (14 días).Para aumentar la probabilidad de que a través de Google Cloud se apruebe una solicitud de reserva futura después de enviarla para su revisión, asegúrate de especificar uno de los valores recomendados para el período de la reserva.
Convertirlo en una solicitud de reserva futura de un solo proyecto
Inhabilita la opción de eliminación automática.
Reserva 100 VM.
Envía la solicitud de reserva futura a Google Cloud para su aprobación.
Eliminación automática
Descripción
Prefijo del nombre
GPU
SSD locales y el tipo de interfaz de disco
Series y tipos de máquinas
Plataforma de CPU mínima
Configuración de uso compartido
Hora de inicio y finalización del período de reserva
Recuento total (cantidad de VM)
En la consola de Google Cloud, ve a la página Reservas.
Haz clic en la pestaña Reservas futuras.
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.
Para modificar la solicitud de reserva futura, haz clic en
Editar o Editar borrador.Se abrirá la página para editar la solicitud de reserva futura seleccionada.
Tener conocimiento sobre uno o más de los siguientes temas:
En el campo Prefijo, ingresa un prefijo de nombre nuevo.
En el campo Descripción, ingresa una descripción nueva.
Modifica la Hora de inicio o la Hora de finalización de la solicitud de reserva futura. Asegúrate de que se den las siguientes condiciones:
La hora de inicio no puede ser posterior a 1 año a partir de la fecha y hora en que envías una solicitud de reserva futura para su revisión.
Especifica un valor recomendado para la hora de inicio a fin de asegurarte de que tienes tiempo suficiente antes de que tu reserva futura ingrese a la hora de bloqueo.
Especifica un período de reserva mínimo recomendado para aumentar la probabilidad de que con Google Cloud se apruebe tu solicitud después de enviarla para su revisión.
En la sección Tipo de recurso compartido, puedes seleccionar Local o Compartido. Si seleccionas Compartido, puedes agregar o quitar proyectos para compartir la solicitud de reserva futura.
Puedes seleccionar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto en el que se creó la solicitud de reserva futura (el proyecto de propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se pueden consumir las reservas creadas de forma automática para esta solicitud de reserva futura.
En el campo Cantidad de instancias de VM, ingresa el recuento total de VMs que deseas reservar para el período, la configuración de VM y los proyectos especificados en esta solicitud de reserva futura.
Cuando se calcula la cantidad de reservas que se crearán para una reserva futura aprobada, primero se verifica con Compute Engine las reservas existentes. Si hay reservas existentes que coinciden con la reserva futura aprobada, la cantidad de reservas existentes se resta de la cantidad total solicitada de reservas en la solicitud para determinar la cantidad de reservas nuevas creadas con Compute Engine. Para obtener más información, consulta cómo se cuenta y produce recursos reservados con Compute Engine.
En la sección Configuración de máquina, puedes cambiar lo siguiente:
La serie de máquinas y el tipo de máquina que se usa en las VMs reservadas.
Las GPU que se adjuntarán a las VM reservadas
Los SSD locales y el tipo de interfaz de disco de las VM reservadas
Según el estado de adquisición de la solicitud de reserva futura que modificas, realiza una de las siguientes acciones:
Para un borrador de solicitud de reserva futura, selecciona una de las siguientes opciones:
Para guardar los cambios, haz clic en Guardar.
Si deseas enviar el borrador de una solicitud de reserva futura a Google Cloud para su revisión, haz clic en Enviar.
En el caso de una solicitud de reserva futura rechazada, solo puedes enviarla para su revisión si haces clic en Enviar.
Si envías una solicitud, se abrirá la página Reservas. De lo contrario, se abrirá la página de detalles de la solicitud de reserva futura.
FUTURE_RESERVATION_NAME
: El nombre de un borrador existente o una solicitud de reserva futura rechazada.Opcional. Realice una de las siguientes acciones:
Para agregar unidades de procesamiento de gráficos (GPU) a cada VM reservada, especifica lo siguiente:
NUMBER_OF_ACCELERATORS
: Es la cantidad de GPU que se agregará por VM reservada.ACCELERATOR_TYPE
: Es el tipo de GPU que se agregará a las VMs reservadas.
Asegúrate de que el tipo de máquina que especifiques en la solicitud de reserva futura admita los tipos de GPU que especifiques y que la GPU esté disponible en la zona en la que quieras reservar los recursos. De lo contrario, tendrás errores.
Para quitar todas las GPU de esta solicitud de reserva futura, reemplaza la marca
--accelerator
por la marca--clear-accelerator
.
DESCRIPTION
: Opcional Una descripción nueva para la solicitud de reserva futura.Opcional. Realice una de las siguientes acciones:
Para agregar o editar el tipo de interfaz que deseas que usen los SSD locales para cada VM, reemplaza
INTERFACE_1
yINTERFACE_2
. El valor debe ser uno de los siguientes:Si tu imagen de disco de arranque tiene controladores NVMe optimizados, especifica
nvme
.De lo contrario, especifica
scsi
.
Cada SSD local es de 375 GB. Repite la marca
--local-ssd
para cada SSD local que desees agregar. Puedes especificar un máximo de 24 SSDs locales.Para quitar todos los SSD locales de esta reserva de solicitud futura, quita todas las marcas
--local-ssd
y especifica la marca--clear-local-ssd
.
MACHINE_TYPE
: Opcional Un tipo de máquina predefinido o personalizado para usar en cada VM. Antes de especificar un tipo personalizado de máquina, revisa las limitaciones para VMs con tipos personalizados de máquinas.MINIMUM_CPU_PLATFORM
: Opcional La plataforma de CPU mínima para usar en cada VM. Si omites la marca--min-cpu-platform
, su valor se establece en la plataforma de CPU predeterminada de la zona.NAME_PREFIX
: Opcional Un nuevo prefijo de nombre para la solicitud de reserva futura. El nombre de cada reserva creada de forma automática para esta solicitud de reserva futura comienza con el prefijo del nombre. Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, se recomienda especificar un prefijo de nombre único.PLANNING_STATUS
: Es el estado de planificación de la solicitud de reserva futura. Solo puedes especificarSUBMITTED
que envía la solicitud de reserva futura a Google Cloud para su revisión.PROJECT_ID
: Opcional El ID del proyecto en el que se creó la solicitud de reserva futura. Si modificas una solicitud de reserva futura de un solo proyecto en una solicitud de reserva futura compartida, este proyecto se convierte en el proyecto propietario de la solicitud de reserva futura. Si omites la marca--project
, el valor se establece en el ID del proyecto actual.SHARE_SETTING
: Opcional Para cambiar el tipo de solicitud de reserva futura, especifica uno de los siguientes valores:Para cambiar una solicitud de reserva futura de un solo proyecto a una solicitud de reserva futura compartida, especifica
projects
. Asegúrate de especificar al menos un proyecto de consumidor en la marca--share-with
. De lo contrario, la modificación de la reserva futura fallará.De lo contrario, especifica
local
.
CONSUMER_PROJECT_IDS
: Opcional Una lista separada por comas de los ID de los proyectos con los que se puede compartir esta solicitud de reserva futura. Por ejemplo, especificaproject-1,project-2
. Puedes especificar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto en el que se creó esta solicitud de reserva futura (el proyecto propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se pueden consumir las reservas creadas de forma automática para esta solicitud de reserva futura.START_TIME
: Opcional La hora de inicio del período de reserva con el formato de marca de tiempo RFC 3339, que debe ser la siguiente:YYYY-MM-DDTHH:MM:SSOFFSET
Reemplaza lo siguiente:
YYYY-MM-DD
: una fecha con formato de un año de 4 dígitos, un mes de 2 dígitos y un día de 2 dígitos del mes separado por guiones (-
)HH:MM:SS
: una hora con formato de hora de 2 dígitos con un formato de 24 horas, minutos de 2 dígitos y segundos de 2 dígitos separados por dos puntos (:
)OFFSET
: la zona horaria con formato como una compensación del horario universal coordinado (UTC). Por ejemplo, para usar la hora estándar del Pacífico (PST), especifica-08:00
. Como alternativa, para no usar compensación, especificaZ
.
La hora de inicio no puede ser posterior a 1 año a partir de la fecha y hora en que envías una solicitud de reserva futura para su revisión. A fin de tener tiempo suficiente para cancelar, borrar o modificar una reserva futura de forma opcional después de que se apruebe o antes de que ingrese a la hora de bloqueo, asegúrate de especificar una hora de inicio recomendada. .
END_TIME
: Opcional : La hora de finalización del período de reserva con un formato de marca de tiempo RFC 3339. El período de reserva debe durar al menos 24 horas. Como alternativa, puedes reemplazar la marca--end-time
por la marca--duration=END_DURATION
, en la queEND_DURATION
es la duración del período de reserva en segundos. Por ejemplo, especifica1209600
para 1,209,600 segundos (14 días).Para aumentar la probabilidad de que a través de Google Cloud se apruebe una solicitud de reserva futura después de enviarla para su revisión, asegúrate de especificar uno de los valores recomendados para el período de la reserva.
TOTAL_COUNT
: Opcional : La cantidad total de VMs que deseas reservar para el período, la configuración de VM y los proyectos especificados en esta solicitud de reserva futura.Cuando se calcula la cantidad de reservas que se crearán para una reserva futura aprobada, Compute Engine primero verifica las reservas existentes. Si hay reservas existentes que coinciden con la reserva futura aprobada, la cantidad de reservas existentes se resta de la cantidad total solicitada de reservas en la solicitud para determinar la cantidad de reservas nuevas creadas con Compute Engine Para obtener más información, consulta cómo se cuenta y produce recursos reservados con Compute Engine.
Precaución: Asegúrate de tener suficiente cuota para los recursos que solicitas reservar. De lo contrario, en Google Cloud se rechazará tu solicitud de reserva futura.
ZONE
: La zona en la que se encuentra la solicitud de reserva futura.Para permitir la eliminación de forma automática de las reservas creadas de forma automática después de la hora de finalización del período de reserva mediante Compute Engine, selecciona uno de los siguientes métodos:
Para borrar las reservas dentro de las 2 horas posteriores a la hora de finalización (predeterminada), especifica la marca
--auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations
Para borrar las reservas creadas de forma automática en un momento específico después de la hora de finalización del período de reserva, especifica las marcas
--auto-delete-auto-created-reservations
y--auto-created-reservations-delete-time
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
Reemplaza
AUTO_CREATED_RESERVATIONS_DELETE_TIME
por una fecha y hora con formato de marca de tiempo RFC 3339.Para borrar las reservas creadas de forma automática después de una duración específica después de la hora de finalización del período de reserva, especifica las marcas
--auto-delete-auto-created-reservations
y--auto-created-reservations-duration
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-duration=DURATION_BEFORE_DELETE
Reemplaza
DURATION_BEFORE_DELETE
por una duración en días, horas, minutos o segundos. Por ejemplo, especifica30m
para 30 minutos o1d2h3m4s
para 1 día, 2 horas, 3 minutos y 4 segundos.
Para inhabilitar Compute Engine de modo que se borren de forma automática las reservas creadas de forma automática, especifica la marca
--no-auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --no-auto-delete-auto-created-reservations
Convertirlo en una solicitud de reserva futura de un solo proyecto
Inhabilita la opción de eliminación automática.
Reserva 100 VM.
Envía la solicitud de reserva futura a Google Cloud para su aprobación.
PROJECT_ID
por el ID del proyecto en el que se encuentra la solicitud de reserva futura.ZONE
: La zona en la que se encuentra la solicitud de reserva futura.FUTURE_RESERVATION_NAME
: El nombre de un borrador existente o una solicitud de reserva futura rechazada. No puedes modificar el nombre de una solicitud de reserva futura.UPDATE_FIELDS
: Una lista de campos separados por comas que se actualizarán en esta solicitudPATCH
. Debes codificar cada coma como%2C
. Por ejemplo, si deseas actualizar los camposautoDeleteAutoCreatedReservations
,totalCount
yendTime
en tu solicitud de reserva futura, especifica lo siguiente: haz lo siguiente:autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
AUTO_DELETE_AUTO_CREATED_RESERVATIONS
: Opcional Si configuras este campo comotrue
, se borra de forma automática a través de Compute Engine las reservas creadas de forma automática para esta solicitud de reserva de reserva futura. De forma predeterminada, la hora de eliminación se encuentra dentro de las 2 horas después de la hora de finalización del período de reserva. Para cambiar esto, realiza una de las siguientes acciones:Para borrar las reservas creadas de forma automática en un momento específico después de la hora de finalización de tu período de reserva, configura
autoDeleteAutoCreatedReservations
comotrue
y especifica el campoautoCreatedReservationsDeleteTime
.PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDeleteTime": "DELETE_TIME" }
Reemplaza
DELETE_TIME
por una fecha y hora en la que se borren las reservas con Compute Engine La fecha y la hora deben tener el formato de una marca de tiempo RFC 3339, que debe ser de la siguiente manera:YYYY-MM-DDTHH:MM:SSOFFSET
Reemplaza lo siguiente:
YYYY-MM-DD
: una fecha con formato de un año de 4 dígitos, un mes de 2 dígitos y un día de 2 dígitos del mes separado por guiones (-
)HH:MM:SS
: una hora con formato de hora de 2 dígitos con un formato de 24 horas, minutos de 2 dígitos y segundos de 2 dígitos separados por dos puntos (:
)OFFSET
: la zona horaria con formato como una compensación del horario universal coordinado (UTC). Por ejemplo, para usar la hora estándar del Pacífico (PST), especifica-08:00
. Como alternativa, para no usar compensación, especificaZ
.
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
comotrue
y especifica el campoautoCreatedReservationsDuration
.PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDuration": { "seconds": "DURATION_BEFORE_DELETE" } }
Reemplaza
DURATION_BEFORE_DELETE
por una duración en segundos. Por ejemplo, especifica604800
para 604,800 segundos (7 días).
DESCRIPTION
: Opcional Para actualizar la descripción de esta solicitud de reserva futura, realiza una de las siguientes acciones:Para agregar o actualizar una descripción, especifica una descripción.
Para quitar la descripción, borra el campo
description
del cuerpo de la solicitud y especifícalo enUPDATE_FIELDS
.
NAME_PREFIX
: Opcional Un nuevo prefijo de nombre para la solicitud de reserva futura. El nombre de cada reserva creada de forma automática para esta solicitud de reserva futura comienza con el prefijo del nombre. Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, se recomienda especificar un prefijo de nombre único.PLANNING_STATUS
: Es el estado de planificación de la solicitud de reserva futura. Solo puedes especificarSUBMITTED
que envía la solicitud de reserva futura a Google Cloud para su revisión.SHARE_TYPE
: Opcional Para cambiar el tipo de recurso compartido de esta solicitud de reserva futura, especifica uno de los siguientes valores:Para cambiar una solicitud de reserva futura de un solo proyecto a una solicitud de reserva futura compartida, especifica
SPECIFIC_PROJECTS
. Además, debes especificar al menos un proyecto de consumidor en el campoprojects
. De lo contrario, la creación de la solicitud de reserva futura fallará.De lo contrario, especifica
LOCAL
. Además, debes borrar el campoprojects
del cuerpo de la solicitud y especificarlo enUPDATE_FIELDS
. De lo contrario, la creación de la solicitud de reserva futura fallará.
CONSUMER_PROJECT_ID_1
yCONSUMER_PROJECT_ID_2
: opcional. Los ID de los proyectos con los que se puede compartir una solicitud de reserva futura. Puedes especificar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto en el que se creó la solicitud de reserva futura (el proyecto de propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se pueden consumir las reservas creadas de forma automática para esta solicitud de reserva futura.Opcional. Para actualizar las unidades de procesamiento de gráficos (GPU) conectadas a cada VM reservada, realiza una de las siguientes acciones:
Para agregar o modificar GPU, especifica lo siguiente:
NUMBER_OF_ACCELERATORS
: Es la cantidad de GPU que se agregará por VM reservada.ACCELERATOR_TYPE
: Es el tipo de GPU que se agregará a las VMs reservadas.
Asegúrate de que el tipo de máquina que especifiques en la solicitud de reserva futura admita los tipos de GPU que especifiques y que la GPU esté disponible en la zona en la que quieras reservar los recursos. De lo contrario, tendrás errores.
Para quitar todas las GPU de esta solicitud de reserva futura, borra el campo
guestAccelerators
del cuerpo de la solicitud y especifícalo enUPDATE_FIELDS
.
Opcional. Para actualizar las SSD locales conectadas a cada VM reservada, realiza una de las siguientes acciones:
Para agregar o editar el tipo de interfaz que deseas que usen los SSD locales para cada VM, reemplaza
INTERFACE_1
yINTERFACE_2
. El valor debe ser uno de los siguientes:Si tu imagen de disco de arranque tiene controladores NVMe optimizados, especifica
NVME
.De lo contrario, especifica
SCSI
.
Repite los campos
diskSizeGb
yinterface
para cada SSD local que desees agregar o actualizar. Puedes especificar un máximo de 24 SSDs locales.Para quitar todos los SSD locales de esta reserva de solicitud futura, borra el campo
localSsds
del cuerpo de la solicitud y especifícalo enUPDATE_FIELDS
.
MACHINE_TYPE
: Opcional Un tipo de máquina predefinido o personalizado para usar en cada VM. Antes de especificar un tipo personalizado de máquina, revisa las limitaciones para VMs con tipos personalizados de máquinas.MINIMUM_CPU_PLATFORM
: Opcional A fin de actualizar la plataforma de CPU mínima para usar en cada VM, realiza una de las siguientes acciones:Para agregar o actualizar la plataforma de CPU mínima, especifica una plataforma de CPU mínima.
Para volver a la plataforma de CPU predeterminada de la zona, borra el campo
minCpuPlatform
del cuerpo de la solicitud y especifícalo enUPDATE_FIELDS
.
TOTAL_COUNT
: Opcional : La cantidad total de VMs que deseas reservar para el período, la configuración de VM y los proyectos especificados en esta solicitud de reserva futura.Cuando se calcula la cantidad de reservas que se crearán para una reserva futura aprobada, Compute Engine primero verifica las reservas existentes. Si hay reservas existentes que coinciden con la reserva futura aprobada, la cantidad de reservas existentes se resta de la cantidad total solicitada de reservas en la solicitud para determinar la cantidad de reservas nuevas creadas con Compute Engine Para obtener más información, consulta cómo se cuenta y produce recursos reservados con Compute Engine.
START_TIME
: Opcional La nueva hora de inicio del período de reserva con formato de marca de tiempo RFC 3339. La hora de inicio no puede ser posterior a 1 año a partir de la fecha y hora en que envías una solicitud de reserva futura para su revisión. Además, asegúrate de especificar una hora de inicio recomendada para garantizar que tienes tiempo suficiente antes de que una reserva futura ingrese a la hora de bloqueo.END_TIME
: Opcional : La hora de finalización del período de reserva con un formato de marca de tiempo RFC 3339. El período de reserva debe durar al menos 24 horas. Como alternativa, puedes reemplazar el campoendTime
por el campoduration
para especificar una duración específica desde la hora de inicio del período de reserva:"duration": { "seconds": "END_DURATION" }
Reemplaza
END_DURATION
por una duración en segundos. Por ejemplo, especifica1209600
para 1,209,600 segundos (14 días).Para aumentar la probabilidad de que a través de Google Cloud se apruebe una solicitud de reserva futura después de enviarla para su revisión, asegúrate de especificar uno de los valores recomendados para el período de la reserva.
Convertirlo en una solicitud de reserva futura de un solo proyecto
Inhabilita la opción de eliminación automática.
Reserva 100 VM.
Envía la solicitud de reserva futura a Google Cloud para su aprobación.
Modifica una reserva futura aprobada o en curso sin revisión.
En esta sección, se explica cómo modificar la opción de eliminación automática, la descripción y el prefijo de nombre en una reserva futura aprobada o en proceso de revisión. La modificación de estas propiedades es inmediata y no hay límites para la cantidad de veces que puedes cambiarlas hasta que Google Cloud comience a crear las reservas.
Solicitud de una modificación de una reserva futura aprobada o en curso.
En esta sección, se explica cómo solicitar a Google Cloud que modifique una o más propiedades en una reserva futura aprobada o en curso. Solo puedes enviar una solicitud para modificar una reserva futura con un estado de Adquirida (
PROCURING
).Eliminación automática
Descripción
Prefijo del nombre
En la consola de Google Cloud, ve a la página Reservas.
Haz clic en la pestaña Reservas futuras.
En la columna Nombre, haz clic en el nombre de la reserva futura que deseas modificar.
Se abrirá la página de detalles de la reserva futura seleccionada.
Si deseas modificar la opción de eliminación automática y la descripción de una reserva futura, realiza una o más de las siguientes acciones:
En la fila Tiempo de eliminación automática de reservas creadas de forma automática, haz clic en
Editar y, luego, sigue estos pasos:Realice una de las siguientes acciones:
Para permitir que se borren de forma automática las reservas creadas de forma automática en tu solicitud de reserva futura con Compute Engine, haz lo siguiente:
Haz clic en el botón de activación Habilitar la eliminación automática.
Opcional: En el campo Hora de borrado automático, ingresa una fecha y hora nuevas para borrar las reservas creadas de forma automática. La fecha y la hora deben ser posteriores a la hora de finalización del período de reserva. Si dejas este campo vacío, las reservas creadas de forma automática se borran en un plazo de 2 horas después de la hora de finalización del período de reserva.
De lo contrario, haz clic en el botón de activación Habilitar eliminación automática a la posición desactivada.
Haz clic en Enviar.
En la fila Prefijo, haz clic en
Editar y, luego, haz lo siguiente:En el campo Prefijo, ingresa un prefijo de nombre nuevo.
Haz clic en Enviar.
En la fila Descripción, haz clic en
Editar y, luego, haz lo siguiente:En el campo Descripción, ingresa una descripción nueva.
Haz clic en Enviar.
FUTURE_RESERVATION_NAME
: El nombre de una reserva futura aprobada o adquiridaDESCRIPTION
: Opcional Una descripción nueva para la reserva futura.NAME_PREFIX
: Opcional Un prefijo de nombre nuevo para la reserva futura. El nombre de cada reserva creada de forma automática para esta reserva futura comienza con el prefijo del nombre. Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, se recomienda especificar un prefijo de nombre único.PROJECT_ID
: Opcional El ID del proyecto en el que se creó la reserva futura.ZONE
: Es la zona en la que se encuentra la reserva.Para permitir la eliminación de forma automática de las reservas creadas de forma automática después de la hora de finalización del período de reserva mediante Compute Engine, selecciona uno de los siguientes métodos:
Para borrar las reservas dentro de las 2 horas posteriores a la hora de finalización (predeterminada), especifica la marca
--auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations
Para borrar las reservas creadas de forma automática en un momento específico después de la hora de finalización del período de reserva, especifica las marcas
--auto-delete-auto-created-reservations
y--auto-created-reservations-delete-time
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
Reemplaza
AUTO_CREATED_RESERVATIONS_DELETE_TIME
por una fecha y hora con formato de marca de tiempo RFC 3339.Para borrar las reservas creadas de forma automática después de una duración específica después de la hora de finalización del período de reserva, especifica las marcas
--auto-delete-auto-created-reservations
y--auto-created-reservations-duration
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-duration=DURATION_BEFORE_DELETE
Reemplaza
DURATION_BEFORE_DELETE
por una duración en días, horas, minutos o segundos. Por ejemplo, especifica30m
para 30 minutos o1d2h3m4s
para 1 día, 2 horas, 3 minutos y 4 segundos.
Para inhabilitar Compute Engine de modo que se borren de forma automática las reservas creadas de forma automática, especifica la marca
--no-auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --no-auto-delete-auto-created-reservations
Habilita la opción de eliminación automática.
Borra de forma automática las reservas creadas automáticamente después de 864,000 segundos (10 días).
Especifica un nuevo prefijo de nombre.
PROJECT_ID
: El ID del proyecto en el que se encuentra la reserva futura.ZONE
: Es la zona en la que se encuentra la reserva.FUTURE_RESERVATION_NAME
: El nombre de una reserva futura aprobada o adquirida No puedes modificar el nombre de una reserva futura.UPDATE_FIELDS
: Una lista de campos separados por comas que se actualizarán en esta solicitudPATCH
. Debes codificar cada coma como%2C
. Por ejemplo, si deseas actualizar los camposdescription
ynamePrefix
en tu reserva futura, especifica lo siguiente:description%2CnamePrefix
AUTO_DELETE_AUTO_CREATED_RESERVATIONS
: Opcional Si configuras este campo comotrue
, con Compute Engine podrás borrar de forma automática las reservas creadas de forma automática para esta reserva de reserva futura. De forma predeterminada, la hora de eliminación se encuentra dentro de las 2 horas después de la hora de finalización del período de reserva. Para cambiar esto, realiza una de las siguientes acciones:Para borrar las reservas creadas de forma automática en un momento específico después de la hora de finalización de tu período de reserva, configura
autoDeleteAutoCreatedReservations
comotrue
y especifica el campoautoCreatedReservationsDeleteTime
.PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDeleteTime": "DELETE_TIME" }
Reemplaza
DELETE_TIME
por una fecha y hora en la que se borren las reservas con Compute Engine La fecha y la hora deben tener el formato de una marca de tiempo RFC 3339, que debe ser de la siguiente manera:YYYY-MM-DDTHH:MM:SSOFFSET
Reemplaza lo siguiente:
YYYY-MM-DD
: una fecha con formato de un año de 4 dígitos, un mes de 2 dígitos y un día de 2 dígitos del mes separado por guiones (-
)HH:MM:SS
: una hora con formato de hora de 2 dígitos con un formato de 24 horas, minutos de 2 dígitos y segundos de 2 dígitos separados por dos puntos (:
)OFFSET
: la zona horaria con formato como una compensación del horario universal coordinado (UTC). Por ejemplo, para usar la hora estándar del Pacífico (PST), especifica-08:00
. Como alternativa, para no usar compensación, especificaZ
.
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
comotrue
y especifica el campoautoCreatedReservationsDuration
.PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDuration": { "seconds": "DURATION_BEFORE_DELETE" } }
Reemplaza
DURATION_BEFORE_DELETE
por una duración en segundos. Por ejemplo, especifica604800
para 604,800 segundos (7 días).
DESCRIPTION
: Opcional Para actualizar la descripción de esta reserva futura, realiza una de las siguientes acciones:Para agregar o actualizar una descripción, especifica una descripción.
Para quitar la descripción, borra el campo
description
del cuerpo de la solicitud y especifícalo enUPDATE_FIELDS
.
NAME_PREFIX
: Opcional Un prefijo de nombre nuevo para la reserva futura. El nombre de cada reserva creada de forma automática para esta reserva futura comienza con el prefijo del nombre. Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, se recomienda especificar un prefijo de nombre único.Habilita la opción de eliminación automática.
Borra de forma automática las reservas creadas automáticamente después de 864,000 segundos (10 días).
Especifica un nuevo prefijo de nombre.
Si solicitas modificar una reserva futura aprobada, Google Cloud realiza una de las siguientes acciones:
Aprueba la solicitud y establece el estado de adquisición en Aprobado (
APPROVED
). Si la hora de inicio del período de reserva es dentro de los 56 días (8 semanas), Compute Engine establece el estado de adquisición como Adquirido (PROCURING
) en unos minutos.Rechaza la solicitud y establece el estado de adquisición en Rechazada (
DECLINED
). Si deseas volver a modificar la reserva futura, consulta Modifica un borrador o una reserva futura rechazada en este documento.
Si solicitas modificar una reserva futura de adquisición, Compute Engine crea el estado de actualización en la reserva futura y lo configura como Actualizar aprobación pendiente (
AMENDMENT_PENDING_APPROVAL
). Luego, Google Cloud revisa tu solicitud y realiza una de las siguientes acciones:Aprueba la solicitud y establece el estado de la actualización en Actualización aprobada (
AMENDMENT_APPROVED
).Rechaza la solicitud, establece el estado de la actualización en Actualización rechazada (
AMENDMENT_DECLINED
) y sigue usando las propiedades aprobadas con anterioridad para las reservas creadas de forma automática.
Durante el tiempo que se revisa tu solicitud en Google Cloud para modificar una reserva futura, no puedes modificar ninguna propiedad, incluidas las propiedades que normalmente puedes modificar sin aprobación, hasta que en Google Cloud se apruebe o rechace la solicitud.
-
En esta sección, se explica cómo solicitar a Google Cloud que se modifiquen una o más propiedades en una reserva futura aprobada y enviada mediante la especificación de una plantilla de instancias. No puedes reemplazar la plantilla de instancias que se usa para crear la reserva futura o anular sus propiedades de VM.
-
En esta sección, se explica cómo solicitar a Google Cloud que se modifiquen una o más propiedades de una reserva futura enviada y aprobada mediante la especificación directa de las propiedades.
Eliminación automática
Descripción
Prefijo del nombre
Configuración de uso compartido
Hora de inicio y finalización del período de reserva
Recuento total (cantidad de VMs)†
En la consola de Google Cloud, ve a la página Reservas.
Haz clic en la pestaña Reservas futuras.
En la columna Nombre, haz clic en el nombre de la reserva futura que deseas modificar.
Se abrirá la página de detalles de la reserva futura seleccionada.
Si deseas modificar la opción de eliminación automática y la descripción de una reserva futura, realiza una o más de las siguientes acciones:
En la fila Tiempo de eliminación automática de reservas creadas de forma automática, haz clic en
Editar y, luego, sigue estos pasos:Realice una de las siguientes acciones:
Para permitir que se borren de forma automática las reservas creadas de forma automática en tu solicitud de reserva futura con Compute Engine, haz lo siguiente:
Haz clic en el botón de activación Habilitar la eliminación automática.
Opcional: En el campo Hora de borrado automático, ingresa una fecha y hora nuevas para borrar las reservas creadas de forma automática. La fecha y la hora deben ser posteriores a la hora de finalización del período de reserva. Si dejas este campo vacío, las reservas creadas de forma automática se borran en un plazo de 2 horas después de la hora de finalización del período de reserva.
De lo contrario, haz clic en el botón de activación Habilitar eliminación automática a la posición desactivada.
Haz clic en Enviar.
En la fila Prefijo, haz clic en
Editar y, luego, haz lo siguiente:En el campo Prefijo, ingresa un prefijo de nombre nuevo.
Haz clic en Enviar.
En la fila Descripción, haz clic en
Editar y, luego, haz lo siguiente:En el campo Descripción, ingresa una descripción nueva.
Haz clic en Enviar.
Haz clic en
Editar.Se abrirá la página para editar la reserva futura seleccionada.
Si deseas modificar otras propiedades, realiza una o más de las siguientes acciones:
Modifica la Hora de inicio o la Hora de finalización de la reserva futura. Asegúrate de que se den las siguientes condiciones:
La hora de inicio no puede ser posterior a 1 año a partir de la fecha y hora en que envías una reserva futura para su revisión.
Especifica un valor recomendado para la hora de inicio a fin de asegurarte de que tienes tiempo suficiente antes de que tu reserva futura ingrese a la hora de bloqueo.
Especifica un período de reserva mínimo recomendado para aumentar la probabilidad de que con Google Cloud se apruebe tu solicitud después de enviarla para su revisión.
En la sección Tipo de recurso compartido, puedes seleccionar Local o Compartido. Si seleccionas Compartido, puedes agregar o quitar proyectos para compartir la reserva futura.
Puedes seleccionar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto en el que se creó la reserva futura (el proyecto propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se permite consumir las reservas compartidas creadas de forma automática para esta reserva futura.
En el campo Cantidad de instancias de VM, ingresa el recuento total de VMs que deseas reservar para el período, la configuración de VM y los proyectos especificados en esta solicitud de reserva futura.
Cuando se calcula la cantidad de reservas que se crearán para una reserva futura aprobada, primero se verifica con Compute Engine las reservas existentes. Si hay reservas existentes que coinciden con la reserva futura aprobada, la cantidad de reservas existentes se resta de la cantidad total solicitada de reservas en la solicitud para determinar la cantidad de reservas nuevas creadas con Compute Engine. Para obtener más información, consulta cómo se cuenta y produce recursos reservados con Compute Engine.
Si deseas enviar una solicitud de modificación a Google Cloud para su revisión, haz clic en Enviar.
Si envías una solicitud, se abrirá la página Reservas. De lo contrario, se abrirá la página de detalles de la reserva futura.
FUTURE_RESERVATION_NAME
: El nombre de una reserva futura aprobada o adquiridaDESCRIPTION
: Opcional Una descripción nueva para la reserva futura.NAME_PREFIX
: Opcional Un prefijo de nombre nuevo para la reserva futura. El nombre de cada reserva creada de forma automática para esta reserva futura comienza con el prefijo del nombre. Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, se recomienda especificar un prefijo de nombre único.PLANNING_STATUS
: Es el estado de planificación de la reserva futura. Solo puedes especificarSUBMITTED
, que envía la reserva futura a Google Cloud para su revisión.PROJECT_ID
: Opcional El ID del proyecto en el que se creó la reserva futura. Si modificas una reserva futura de un solo proyecto en una reserva compartida, este proyecto se convierte en el proyecto propietario de la reserva futura. Si omites la marca--project
, el valor se establece en el ID del proyecto actual.SHARE_SETTING
: Opcional Para cambiar el tipo de reserva futura, especifica uno de los siguientes valores:Para cambiar una reserva futura de un solo proyecto a una reserva futura compartida, especifica
projects
. Asegúrate de especificar al menos un proyecto de consumidor en la marca--share-with
. De lo contrario, la creación de la solicitud de reserva futura fallará.De lo contrario, especifica
local
.
CONSUMER_PROJECT_IDS
: Opcional : Una lista separada por comas de los ID de los proyectos con los que se puede compartir esta solicitud de reserva futura. Por ejemplo, especificaproject-1,project-2
. Puedes especificar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto en el que se creó esta reserva futura (el proyecto propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se permite consumir las reservas compartidas creadas de forma automática para esta reserva futura.START_TIME
: Opcional La hora de inicio del período de reserva con el formato de marca de tiempo RFC 3339, que debe ser la siguiente:YYYY-MM-DDTHH:MM:SSOFFSET
Reemplaza lo siguiente:
YYYY-MM-DD
: una fecha con formato de un año de 4 dígitos, un mes de 2 dígitos y un día de 2 dígitos del mes separado por guiones (-
)HH:MM:SS
: una hora con formato de hora de 2 dígitos con un formato de 24 horas, minutos de 2 dígitos y segundos de 2 dígitos separados por dos puntos (:
)OFFSET
: la zona horaria con formato como una compensación del horario universal coordinado (UTC). Por ejemplo, para usar la hora estándar del Pacífico (PST), especifica-08:00
. Como alternativa, para no usar compensación, especificaZ
.
La hora de inicio no puede ser posterior a 1 año a partir de la fecha y hora en que envías una reserva futura para su revisión. A fin de tener tiempo suficiente para cancelar, borrar o modificar una reserva futura de forma opcional después de que se apruebe o antes de que ingrese a la hora de bloqueo, asegúrate de especificar una hora de inicio recomendada. .
END_TIME
: Opcional : La hora de finalización del período de reserva con un formato de marca de tiempo RFC 3339. El período de reserva debe durar al menos 24 horas. Como alternativa, puedes reemplazar la marca--end-time
por la marca--duration=END_DURATION
, en la queEND_DURATION
es la duración del período de reserva en segundos. Por ejemplo, especifica1209600
para 1,209,600 segundos (14 días).Para aumentar la probabilidad de que a través de Google Cloud se apruebe una solicitud de reserva futura después de enviarla para su revisión, asegúrate de especificar uno de los valores recomendados para el período de la reserva.
TOTAL_COUNT
: Opcional : La cantidad total de VMs que deseas reservar para el período, la configuración de VM y los proyectos especificados en esta solicitud de reserva futura.Cuando se calcula la cantidad de reservas que se crearán para una reserva futura aprobada, Compute Engine primero verifica las reservas existentes. Si hay reservas existentes que coinciden con la reserva futura aprobada, la cantidad de reservas existentes se resta de la cantidad total solicitada de reservas en la solicitud para determinar la cantidad de reservas nuevas creadas con Compute Engine Para obtener más información, consulta cómo se cuenta y produce recursos reservados con Compute Engine.
Precaución: Si deseas aumentar la cantidad de VM que se reservarán, asegúrate de tener suficiente cuota para los recursos adicionales que solicitas reservar. De lo contrario, en Google Cloud se rechazará tu solicitud de modificación.
ZONE
: Es la zona en la que se encuentra la reserva.Para permitir la eliminación de forma automática de las reservas creadas de forma automática después de la hora de finalización del período de reserva mediante Compute Engine, selecciona uno de los siguientes métodos:
Para borrar las reservas dentro de las 2 horas posteriores a la hora de finalización (predeterminada), especifica la marca
--auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations
Para borrar las reservas creadas de forma automática en un momento específico después de la hora de finalización del período de reserva, especifica las marcas
--auto-delete-auto-created-reservations
y--auto-created-reservations-delete-time
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
Reemplaza
AUTO_CREATED_RESERVATIONS_DELETE_TIME
por una fecha y hora con formato de marca de tiempo RFC 3339.Para borrar las reservas creadas de forma automática después de una duración específica después de la hora de finalización del período de reserva, especifica las marcas
--auto-delete-auto-created-reservations
y--auto-created-reservations-duration
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-duration=DURATION_BEFORE_DELETE
Reemplaza
DURATION_BEFORE_DELETE
por una duración en días, horas, minutos o segundos. Por ejemplo, especifica30m
para 30 minutos o1d2h3m4s
para 1 día, 2 horas, 3 minutos y 4 segundos.
Para inhabilitar Compute Engine de modo que se borren de forma automática las reservas creadas de forma automática, especifica la marca
--no-auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --no-auto-delete-auto-created-reservations
Cambia la hora de finalización de su período de reserva a la medianoche del 31 de diciembre de 2023 UTC.
Reserva 10 VM.
Especifica un nuevo prefijo de nombre.
PROJECT_ID
: El ID del proyecto en el que se encuentra la reserva futura.ZONE
: Es la zona en la que se encuentra la reserva.FUTURE_RESERVATION_NAME
: El nombre de una reserva futura aprobada o adquirida No puedes modificar el nombre de una reserva futura.UPDATE_FIELDS
: Una lista de campos separados por comas que se actualizarán en esta solicitudPATCH
. Debes codificar cada coma como%2C
. Por ejemplo, si deseas actualizar los camposautoDeleteAutoCreatedReservations
,totalCount
yendTime
en tu reserva futura, especifica lo siguiente: siguiente:autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
AUTO_DELETE_AUTO_CREATED_RESERVATIONS
: Opcional Si configuras este campo comotrue
, con Compute Engine podrás borrar de forma automática las reservas creadas de forma automática para esta reserva de reserva futura. De forma predeterminada, la hora de eliminación se encuentra dentro de las 2 horas después de la hora de finalización del período de reserva. Para cambiar esto, realiza una de las siguientes acciones:Para borrar las reservas creadas de forma automática en un momento específico después de la hora de finalización de tu período de reserva, configura
autoDeleteAutoCreatedReservations
comotrue
y especifica el campoautoCreatedReservationsDeleteTime
.PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDeleteTime": "DELETE_TIME" }
Reemplaza
DELETE_TIME
por una fecha y hora en la que se borren las reservas con Compute Engine La fecha y la hora deben tener el formato de una marca de tiempo RFC 3339, que debe ser de la siguiente manera:YYYY-MM-DDTHH:MM:SSOFFSET
Reemplaza lo siguiente:
YYYY-MM-DD
: una fecha con formato de un año de 4 dígitos, un mes de 2 dígitos y un día de 2 dígitos del mes separado por guiones (-
)HH:MM:SS
: una hora con formato de hora de 2 dígitos con un formato de 24 horas, minutos de 2 dígitos y segundos de 2 dígitos separados por dos puntos (:
)OFFSET
: la zona horaria con formato como una compensación del horario universal coordinado (UTC). Por ejemplo, para usar la hora estándar del Pacífico (PST), especifica-08:00
. Como alternativa, para no usar compensación, especificaZ
.
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
comotrue
y especifica el campoautoCreatedReservationsDuration
.PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDuration": { "seconds": "DURATION_BEFORE_DELETE" } }
Reemplaza
DURATION_BEFORE_DELETE
por una duración en segundos. Por ejemplo, especifica604800
para 604,800 segundos (7 días).
DESCRIPTION
: Opcional Para actualizar la descripción de esta reserva futura, realiza una de las siguientes acciones:Para agregar o actualizar una descripción, especifica una descripción.
Para quitar la descripción, borra el campo
description
del cuerpo de la solicitud y especifícalo enUPDATE_FIELDS
.
NAME_PREFIX
: Opcional Un prefijo de nombre nuevo para la reserva futura. El nombre de cada reserva creada de forma automática para esta reserva futura comienza con el prefijo del nombre. Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, se recomienda especificar un prefijo de nombre único.PLANNING_STATUS
: Es el estado de planificación de la reserva futura. Solo puedes especificarSUBMITTED
, que envía la reserva futura a Google Cloud para su revisión.SHARE_TYPE
: Opcional Para cambiar el tipo de recurso compartido de esta reserva futura, especifica uno de los siguientes valores:Para cambiar una reserva futura de un solo proyecto a una reserva futura compartida, especifica
SPECIFIC_PROJECTS
. Además, debes especificar al menos un proyecto de consumidor en el campoprojects
. De lo contrario, la modificación de la reserva futura fallará.De lo contrario, especifica
LOCAL
. Además, debes borrar el campoprojects
del cuerpo de la solicitud y especificarlo enUPDATE_FIELDS
. De lo contrario, la modificación de la reserva futura fallará.
CONSUMER_PROJECT_ID_1
yCONSUMER_PROJECT_ID_2
: opcional. Los ID de los proyectos con los que se puede compartir una reserva futura compartida. Puedes especificar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto en el que se creó la reserva futura (el proyecto propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se permite consumir las reservas compartidas creadas de forma automática para esta reserva futura.TOTAL_COUNT
: Opcional : La cantidad total de VMs que deseas reservar para el período, la configuración de VM y los proyectos especificados en esta solicitud de reserva futura.Cuando se calcula la cantidad de reservas que se crearán para una reserva futura aprobada, Compute Engine primero verifica las reservas existentes. Si hay reservas existentes que coinciden con la reserva futura aprobada, la cantidad de reservas existentes se resta de la cantidad total solicitada de reservas en la solicitud para determinar la cantidad de reservas nuevas creadas con Compute Engine Para obtener más información, consulta cómo se cuenta y produce recursos reservados con Compute Engine.
START_TIME
: Opcional La nueva hora de inicio del período de reserva con formato de marca de tiempo RFC 3339. La hora de inicio no puede ser posterior a 1 año a partir de la fecha y hora en que envías una reserva futura para su revisión. Además, asegúrate de especificar una hora de inicio recomendada para garantizar que tienes tiempo suficiente antes de que una reserva futura ingrese a la hora de bloqueo.END_TIME
: Opcional : La hora de finalización del período de reserva con un formato de marca de tiempo RFC 3339. El período de reserva debe durar al menos 24 horas. Como alternativa, puedes reemplazar el campoendTime
por el campoduration
para especificar una duración específica desde la hora de inicio del período de reserva:"duration": { "seconds": "END_DURATION" }
Reemplaza
END_DURATION
por una duración en segundos. Por ejemplo, especifica1209600
para 1,209,600 segundos (14 días).Para aumentar la probabilidad de que a través de Google Cloud se apruebe una solicitud de reserva futura después de enviarla para su revisión, asegúrate de especificar uno de los valores recomendados para el período de la reserva.
Cambia la hora de finalización de su período de reserva a la medianoche del 31 de diciembre de 2023 UTC.
Reserva 10 VM.
Especifica un nuevo prefijo de nombre.
Eliminación automática
Descripción
Prefijo del nombre
GPU‡
SSD locales y el tipo de interfaz de disco‡
Serie y tipos de máquinas‡
Plataforma de CPU mínima‡
Configuración de uso compartido
Hora de inicio y finalización del período de reserva
Recuento total (cantidad de VMs)‡
En la consola de Google Cloud, ve a la página Reservas.
Haz clic en la pestaña Reservas futuras.
En la columna Nombre, haz clic en el nombre de la reserva futura que deseas modificar.
Se abrirá la página de detalles de la reserva futura seleccionada.
Si deseas modificar la opción de eliminación automática y la descripción de una reserva futura, realiza una o más de las siguientes acciones:
En la fila Tiempo de eliminación automática de reservas creadas de forma automática, haz clic en
Editar y, luego, sigue estos pasos:Realice una de las siguientes acciones:
Para permitir que se borren de forma automática las reservas creadas de forma automática en tu solicitud de reserva futura con Compute Engine, haz lo siguiente:
Haz clic en el botón de activación Habilitar la eliminación automática.
Opcional: En el campo Hora de borrado automático, ingresa una fecha y hora nuevas para borrar las reservas creadas de forma automática. La fecha y la hora deben ser posteriores a la hora de finalización del período de reserva. Si dejas este campo vacío, las reservas creadas de forma automática se borran en un plazo de 2 horas después de la hora de finalización del período de reserva.
De lo contrario, haz clic en el botón de activación Habilitar eliminación automática a la posición desactivada.
Haz clic en Enviar.
En la fila Prefijo, haz clic en
Editar y, luego, haz lo siguiente:En el campo Prefijo, ingresa un prefijo de nombre nuevo.
Haz clic en Enviar.
En la fila Descripción, haz clic en
Editar y, luego, haz lo siguiente:En el campo Descripción, ingresa una descripción nueva.
Haz clic en Enviar.
Haz clic en
Editar.Se abrirá la página para editar la reserva futura seleccionada.
Si deseas modificar otras propiedades, realiza una o más de las siguientes acciones:
Modifica la Hora de inicio o la Hora de finalización de la reserva futura. Asegúrate de que se den las siguientes condiciones:
La hora de inicio no puede ser posterior a 1 año a partir de la fecha y hora en que envías una reserva futura para su revisión.
Especifica un valor recomendado para la hora de inicio a fin de asegurarte de que tienes tiempo suficiente antes de que tu reserva futura ingrese a la hora de bloqueo.
Especifica un período de reserva mínimo recomendado para aumentar la probabilidad de que con Google Cloud se apruebe tu solicitud después de enviarla para su revisión.
En la sección Tipo de recurso compartido, puedes seleccionar Local o Compartido. Si seleccionas Compartido, puedes agregar o quitar proyectos para compartir la reserva futura.
Puedes seleccionar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto en el que se creó la reserva futura (el proyecto propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se permite consumir las reservas compartidas creadas de forma automática para esta reserva futura.
En el campo Cantidad de instancias de VM, ingresa el recuento total de VMs que deseas reservar para el período, la configuración de VM y los proyectos especificados en esta solicitud de reserva futura.
Cuando se calcula la cantidad de reservas que se crearán para una reserva futura aprobada, primero se verifica con Compute Engine las reservas existentes. Si hay reservas existentes que coinciden con la reserva futura aprobada, la cantidad de reservas existentes se resta de la cantidad total solicitada de reservas en la solicitud para determinar la cantidad de reservas nuevas creadas con Compute Engine. Para obtener más información, consulta cómo se cuenta y produce recursos reservados con Compute Engine.
En la sección Configuración de máquina, puedes cambiar lo siguiente:
La serie de máquinas y el tipo de máquina que se usa en las VMs reservadas.
Las GPU que se adjuntarán a las VM reservadas
Los SSD locales y el tipo de interfaz de disco de las VM reservadas
Si deseas enviar una solicitud de modificación a Google Cloud para su revisión, haz clic en Enviar.
Si envías una solicitud, se abrirá la página Reservas. De lo contrario, se abrirá la página de detalles de la reserva futura.
FUTURE_RESERVATION_NAME
: El nombre de una reserva futura aprobada o adquiridaOpcional. Realice una de las siguientes acciones:
Para agregar unidades de procesamiento de gráficos (GPU) a cada VM reservada, especifica lo siguiente:
NUMBER_OF_ACCELERATORS
: Es la cantidad de GPU que se agregará por VM reservada.ACCELERATOR_TYPE
: Es el tipo de GPU que se agregará a las VMs reservadas.
Asegúrate de que el tipo de máquina que especifiques en la solicitud de reserva futura admita los tipos de GPU que especifiques y que la GPU esté disponible en la zona en la que quieras reservar los recursos. De lo contrario, tendrás errores.
Para quitar todas las GPU de esta solicitud futura, reemplaza la marca
--accelerator
por la marca--clear-accelerator
.
DESCRIPTION
: Opcional Una descripción nueva para la reserva futura.Opcional. Realice una de las siguientes acciones:
Para agregar o editar el tipo de interfaz que deseas que usen los SSD locales para cada VM, reemplaza
INTERFACE_1
yINTERFACE_2
. El valor debe ser uno de los siguientes:Si tu imagen de disco de arranque tiene controladores NVMe optimizados, especifica
nvme
.De lo contrario, especifica
scsi
.
Cada SSD local es de 375 GB. Repite la marca
--local-ssd
para cada SSD local que desees agregar. Puedes especificar un máximo de 24 SSDs locales.Para quitar todos los SSD locales de esta reserva futura, quita todas las marcas
--local-ssd
y especifica la marca--clear-local-ssd
.
MACHINE_TYPE
: Opcional Un tipo de máquina predefinido o personalizado para usar en cada VM. Antes de especificar un tipo personalizado de máquina, revisa las limitaciones para VMs con tipos personalizados de máquinas.MINIMUM_CPU_PLATFORM
: Opcional La plataforma de CPU mínima para usar en cada VM. Si omites la marca--min-cpu-platform
, su valor se establece en la plataforma de CPU predeterminada de la zona.NAME_PREFIX
: Opcional Un prefijo de nombre nuevo para la reserva futura. El nombre de cada reserva creada de forma automática para esta reserva futura comienza con el prefijo del nombre. Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, se recomienda especificar un prefijo de nombre único.PLANNING_STATUS
: Es el estado de planificación de la reserva futura. Solo puedes especificarSUBMITTED
, que envía la reserva futura a Google Cloud para su revisión.PROJECT_ID
: Opcional El ID del proyecto en el que se creó la reserva futura. Si modificas una reserva futura de un solo proyecto en una reserva compartida, este proyecto se convierte en el proyecto propietario de la reserva futura. Si omites la marca--project
, el valor se establece en el ID del proyecto actual.SHARE_SETTING
: Opcional Para cambiar el tipo de reserva futura, especifica uno de los siguientes valores:Para cambiar una reserva futura de un solo proyecto a una reserva futura compartida, especifica
projects
. Asegúrate de especificar al menos un proyecto de consumidor en la marca--share-with
. De lo contrario, la creación de la solicitud de reserva futura fallará.De lo contrario, especifica
local
.
CONSUMER_PROJECT_IDS
: Opcional : Una lista separada por comas de los ID de los proyectos con los que se puede compartir esta solicitud de reserva futura. Por ejemplo, especificaproject-1,project-2
. Puedes especificar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto en el que se creó esta reserva futura (el proyecto propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se permite consumir las reservas compartidas creadas de forma automática para esta reserva futura.START_TIME
: Opcional La hora de inicio del período de reserva con el formato de marca de tiempo RFC 3339, que debe ser la siguiente:YYYY-MM-DDTHH:MM:SSOFFSET
Reemplaza lo siguiente:
YYYY-MM-DD
: una fecha con formato de un año de 4 dígitos, un mes de 2 dígitos y un día de 2 dígitos del mes separado por guiones (-
)HH:MM:SS
: una hora con formato de hora de 2 dígitos con un formato de 24 horas, minutos de 2 dígitos y segundos de 2 dígitos separados por dos puntos (:
)OFFSET
: la zona horaria con formato como una compensación del horario universal coordinado (UTC). Por ejemplo, para usar la hora estándar del Pacífico (PST), especifica-08:00
. Como alternativa, para no usar compensación, especificaZ
.
La hora de inicio no puede ser posterior a 1 año a partir de la fecha y hora en que envías una reserva futura para su revisión. A fin de tener tiempo suficiente para cancelar, borrar o modificar una reserva futura de forma opcional después de que se apruebe o antes de que ingrese a la hora de bloqueo, asegúrate de especificar una hora de inicio recomendada. .
END_TIME
: Opcional : La hora de finalización del período de reserva con un formato de marca de tiempo RFC 3339. El período de reserva debe durar al menos 24 horas. Como alternativa, puedes reemplazar la marca--end-time
por la marca--duration=END_DURATION
, en la queEND_DURATION
es la duración del período de reserva en segundos. Por ejemplo, especifica1209600
para 1,209,600 segundos (14 días).Para aumentar la probabilidad de que a través de Google Cloud se apruebe una solicitud de reserva futura después de enviarla para su revisión, asegúrate de especificar uno de los valores recomendados para el período de la reserva.
TOTAL_COUNT
: Opcional : La cantidad total de VMs que deseas reservar para el período, la configuración de VM y los proyectos especificados en esta solicitud de reserva futura.Cuando se calcula la cantidad de reservas que se crearán para una reserva futura aprobada, Compute Engine primero verifica las reservas existentes. Si hay reservas existentes que coinciden con la reserva futura aprobada, la cantidad de reservas existentes se resta de la cantidad total solicitada de reservas en la solicitud para determinar la cantidad de reservas nuevas creadas con Compute Engine Para obtener más información, consulta cómo se cuenta y produce recursos reservados con Compute Engine.
Precaución: Si deseas aumentar la cantidad de VM que se reservarán, asegúrate de tener suficiente cuota para los recursos adicionales que solicitas reservar. De lo contrario, en Google Cloud se rechazará tu solicitud de modificación.
ZONE
: Es la zona en la que se encuentra la reserva.Para permitir la eliminación de forma automática de las reservas creadas de forma automática después de la hora de finalización del período de reserva mediante Compute Engine, selecciona uno de los siguientes métodos:
Para borrar las reservas dentro de las 2 horas posteriores a la hora de finalización (predeterminada), especifica la marca
--auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations
Para borrar las reservas creadas de forma automática en un momento específico después de la hora de finalización del período de reserva, especifica las marcas
--auto-delete-auto-created-reservations
y--auto-created-reservations-delete-time
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
Reemplaza
AUTO_CREATED_RESERVATIONS_DELETE_TIME
por una fecha y hora con formato de marca de tiempo RFC 3339.Para borrar las reservas creadas de forma automática después de una duración específica después de la hora de finalización del período de reserva, especifica las marcas
--auto-delete-auto-created-reservations
y--auto-created-reservations-duration
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-duration=DURATION_BEFORE_DELETE
Reemplaza
DURATION_BEFORE_DELETE
por una duración en días, horas, minutos o segundos. Por ejemplo, especifica30m
para 30 minutos o1d2h3m4s
para 1 día, 2 horas, 3 minutos y 4 segundos.
Para inhabilitar Compute Engine de modo que se borren de forma automática las reservas creadas de forma automática, especifica la marca
--no-auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --no-auto-delete-auto-created-reservations
Cambia la hora de finalización de su período de reserva a la medianoche del 31 de diciembre de 2023 UTC.
Reserva 10 VM.
Especifica un nuevo prefijo de nombre.
PROJECT_ID
: El ID del proyecto en el que se encuentra la reserva futura.ZONE
: Es la zona en la que se encuentra la reserva.FUTURE_RESERVATION_NAME
: El nombre de una reserva futura aprobada o adquirida No puedes modificar el nombre de una reserva futura.UPDATE_FIELDS
: Una lista de campos separados por comas que se actualizarán en esta solicitudPATCH
. Debes codificar cada coma como%2C
. Por ejemplo, si deseas actualizar los camposautoDeleteAutoCreatedReservations
,totalCount
yendTime
en tu reserva futura, especifica lo siguiente: siguiente:autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
AUTO_DELETE_AUTO_CREATED_RESERVATIONS
: Opcional Si configuras este campo comotrue
, con Compute Engine podrás borrar de forma automática las reservas creadas de forma automática para esta reserva de reserva futura. De forma predeterminada, la hora de eliminación se encuentra dentro de las 2 horas después de la hora de finalización del período de reserva. Para cambiar esto, realiza una de las siguientes acciones:Para borrar las reservas creadas de forma automática en un momento específico después de la hora de finalización de tu período de reserva, configura
autoDeleteAutoCreatedReservations
comotrue
y especifica el campoautoCreatedReservationsDeleteTime
.PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDeleteTime": "DELETE_TIME" }
Reemplaza
DELETE_TIME
por una fecha y hora en la que se borren las reservas con Compute Engine La fecha y la hora deben tener el formato de una marca de tiempo RFC 3339, que debe ser de la siguiente manera:YYYY-MM-DDTHH:MM:SSOFFSET
Reemplaza lo siguiente:
YYYY-MM-DD
: una fecha con formato de un año de 4 dígitos, un mes de 2 dígitos y un día de 2 dígitos del mes separado por guiones (-
)HH:MM:SS
: una hora con formato de hora de 2 dígitos con un formato de 24 horas, minutos de 2 dígitos y segundos de 2 dígitos separados por dos puntos (:
)OFFSET
: la zona horaria con formato como una compensación del horario universal coordinado (UTC). Por ejemplo, para usar la hora estándar del Pacífico (PST), especifica-08:00
. Como alternativa, para no usar compensación, especificaZ
.
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
comotrue
y especifica el campoautoCreatedReservationsDuration
.PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDuration": { "seconds": "DURATION_BEFORE_DELETE" } }
Reemplaza
DURATION_BEFORE_DELETE
por una duración en segundos. Por ejemplo, especifica604800
para 604,800 segundos (7 días).
DESCRIPTION
: Opcional Para actualizar la descripción de esta reserva futura, realiza una de las siguientes acciones:Para agregar o actualizar una descripción, especifica una descripción.
Para quitar la descripción, borra el campo
description
del cuerpo de la solicitud y especifícalo enUPDATE_FIELDS
.
NAME_PREFIX
: Opcional Un prefijo de nombre nuevo para la reserva futura. El nombre de cada reserva creada de forma automática para esta reserva futura comienza con el prefijo del nombre. Para ayudarte a identificar las reservas creadas de forma automática para esta solicitud de reserva futura, se recomienda especificar un prefijo de nombre único.PLANNING_STATUS
: Es el estado de planificación de la reserva futura. Solo puedes especificarSUBMITTED
, que envía la reserva futura a Google Cloud para su revisión.SHARE_TYPE
: Opcional Para cambiar el tipo de recurso compartido de esta reserva futura, especifica uno de los siguientes valores:Para cambiar una reserva futura de un solo proyecto a una reserva futura compartida, especifica
SPECIFIC_PROJECTS
. Además, debes especificar al menos un proyecto de consumidor en el campoprojects
. De lo contrario, la modificación de la reserva futura fallará.De lo contrario, especifica
LOCAL
. Además, debes borrar el campoprojects
del cuerpo de la solicitud y especificarlo enUPDATE_FIELDS
. De lo contrario, la modificación de la reserva futura fallará.
CONSUMER_PROJECT_ID_1
yCONSUMER_PROJECT_ID_2
: opcional. Los ID de los proyectos con los que se puede compartir una reserva futura compartida. Puedes especificar hasta 100 proyectos. Estos proyectos deben estar en la misma organización que el proyecto en el que se creó la reserva futura (el proyecto propietario). No especifiques el proyecto de propietario. De forma predeterminada, ya se permite consumir las reservas compartidas creadas de forma automática para esta reserva futura.Opcional. Para actualizar las unidades de procesamiento de gráficos (GPU) conectadas a cada VM reservada, realiza una de las siguientes acciones:
Para agregar o modificar GPU, especifica lo siguiente:
NUMBER_OF_ACCELERATORS
: Es la cantidad de GPU que se agregará por VM reservada.ACCELERATOR_TYPE
: Es el tipo de GPU que se agregará a las VMs reservadas.
Asegúrate de que el tipo de máquina que especifiques en la solicitud de reserva futura admita los tipos de GPU que especifiques y que la GPU esté disponible en la zona en la que quieras reservar los recursos. De lo contrario, tendrás errores.
Para quitar todas las GPU de esta solicitud futura, borra el campo
guestAccelerators
en el cuerpo de la solicitud y especifícalo enUPDATE_FIELDS
.
Opcional. Para actualizar las SSD locales conectadas a cada VM reservada, realiza una de las siguientes acciones:
Para agregar o editar el tipo de interfaz que deseas que usen los SSD locales para cada VM, reemplaza
INTERFACE_1
yINTERFACE_2
. El valor debe ser uno de los siguientes:Si tu imagen de disco de arranque tiene controladores NVMe optimizados, especifica
NVME
.De lo contrario, especifica
SCSI
.
Repite los campos
diskSizeGb
yinterface
para cada SSD local que desees agregar o actualizar. Puedes especificar un máximo de 24 SSDs locales.Para quitar todos los SSD locales de esta reserva futura, borra el campo
localSsds
del cuerpo de la solicitud y especifícalo enUPDATE_FIELDS
.
MACHINE_TYPE
: Opcional Un tipo de máquina predefinido o personalizado para usar en cada VM. Antes de especificar un tipo personalizado de máquina, revisa las limitaciones para VMs con tipos personalizados de máquinas.MINIMUM_CPU_PLATFORM
: Opcional A fin de actualizar la plataforma de CPU mínima para usar en cada VM, realiza una de las siguientes acciones:Para agregar o actualizar la plataforma de CPU mínima, especifica una plataforma de CPU mínima.
Para volver a la plataforma de CPU predeterminada de la zona, borra el campo
minCpuPlatform
del cuerpo de la solicitud y especifícalo enUPDATE_FIELDS
.
TOTAL_COUNT
: Opcional : La cantidad total de VMs que deseas reservar para el período, la configuración de VM y los proyectos especificados en esta solicitud de reserva futura.Cuando se calcula la cantidad de reservas que se crearán para una reserva futura aprobada, Compute Engine primero verifica las reservas existentes. Si hay reservas existentes que coinciden con la reserva futura aprobada, la cantidad de reservas existentes se resta de la cantidad total solicitada de reservas en la solicitud para determinar la cantidad de reservas nuevas creadas con Compute Engine Para obtener más información, consulta cómo se cuenta y produce recursos reservados con Compute Engine.
START_TIME
: Opcional La nueva hora de inicio del período de reserva con formato de marca de tiempo RFC 3339. La hora de inicio no puede ser posterior a 1 año a partir de la fecha y hora en que envías una reserva futura para su revisión. Además, asegúrate de especificar una hora de inicio recomendada para garantizar que tienes tiempo suficiente antes de que una reserva futura ingrese a la hora de bloqueo.END_TIME
: Opcional : La hora de finalización del período de reserva con un formato de marca de tiempo RFC 3339. El período de reserva debe durar al menos 24 horas. Como alternativa, puedes reemplazar el campoendTime
por el campoduration
para especificar una duración específica desde la hora de inicio del período de reserva:"duration": { "seconds": "END_DURATION" }
Reemplaza
END_DURATION
por una duración en segundos. Por ejemplo, especifica1209600
para 1,209,600 segundos (14 días).Para aumentar la probabilidad de que a través de Google Cloud se apruebe una solicitud de reserva futura después de enviarla para su revisión, asegúrate de especificar uno de los valores recomendados para el período de la reserva.
Cambia la hora de finalización de su período de reserva a la medianoche del 31 de diciembre de 2023 UTC.
Reserva 10 VM.
Especifica un nuevo prefijo de nombre.
Tener conocimiento sobre uno o más de los siguientes temas:
Para evitar la revisión de la solicitud de reserva futura con Google Cloud, cancela la solicitud de reserva futura.
Para evitar que la solicitud de reserva futura restrinja el tipo de solicitudes de reserva futuras que puedes crear en tu proyecto actual o en los proyectos con los que se comparte la solicitud de reserva futura, borra la solicitud futura solicitud de reserva.
Crea un nuevo proyecto único o una solicitud de reserva futura compartida con las actualizaciones deseadas.
FUTURE_RESERVATION_NAME
: El nombre de una solicitud de reserva futura existente.PROJECT_ID
: Opcional El ID del proyecto en el que se encuentra la solicitud de reserva futura. Si omites la marca--project
, se usa el ID del proyecto actual.ZONE
: Es la zona en la que se encuentra la solicitud de reserva futura.PROJECT_ID
es el ID del proyecto en el que se encuentra la solicitud de reserva futura.ZONE
: Es la zona en la que se encuentra la solicitud de reserva futura.FUTURE_RESERVATION_NAME
: El nombre de una solicitud de reserva futura existente.La solicitud de reserva futura se canceló.
Antes de que la reserva futura haya alcanzado la hora de inicio del período de reserva.
Después de que la reserva futura haya alcanzado la hora de finalización del período de reserva.
En la consola de Google Cloud, ve a la página Reservas.
Haz clic en la pestaña Reservas futuras.
Selecciona la casilla de verificación junto a cada solicitud de reserva futura que desees borrar.
Haz clic en
Borrar reserva.Para confirmar la acción, haz clic en Borrar.
Borrar una solicitud de reserva futura puede tomar hasta un minuto en completarse.
FUTURE_RESERVATION_NAME
: El nombre de una solicitud de reserva futura existente.PROJECT_ID
: Opcional El ID del proyecto en el que se encuentra la solicitud de reserva futura. Si omites la marca--project
, se usa el ID del proyecto actual.ZONE
: Es la zona en la que se encuentra la solicitud de reserva futura.PROJECT_ID
es el ID del proyecto en el que se encuentra la solicitud de reserva futura.ZONE
: Es la zona en la que se encuentra la solicitud de reserva futura.FUTURE_RESERVATION_NAME
: El nombre de una solicitud de reserva futura existente.Obtén información sobre cómo ver solicitudes de reserva futuras
Después de llegar a la hora de inicio del período de reserva, obtén información para consumir las reservas creadas de forma automática.
Después de la hora de finalización del período de reserva, obtén información para hacer lo siguiente:
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.
Funciones obligatorias
Para obtener los permisos que necesitas modificar, cancelar o borrar tus solicitudes de reserva futuras, pídele a tu administrador que te otorgue el administrador de reserva futura de Compute (
roles/compute.futureReservationAdmin
) rol de IAM en el proyecto. Para obtener más información sobre cómo otorgar funciones, consulta Administra el acceso.Esta función predefinida contiene los permisos necesarios para modificar, cancelar o borrar tus solicitudes de reserva futuras. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para modificar, cancelar o borrar tus solicitudes de reserva futuras:
También puedes obtener estos permisos con funciones personalizadas o con otras funciones predefinidas.
Restricciones
Además de las restricciones generales para las reservas futuras, cuando modificas, cancelas o borras solicitudes de reserva futuras, se aplican las siguientes restricciones:
Modifica solicitudes de reserva futuras
Puedes modificar una solicitud de reserva futura antes de que alcance el estado de adquisición Adquirido (
PROVISIONING
), siempre que no se cancele o esté pendiente de aprobación. Cuando modificas una solicitud de reserva futura, no puedes cambiar las siguientes propiedades:Para modificar cualquiera de estas propiedades, debes crear una solicitud de reserva futura nueva con las actualizaciones deseadas.
Si deseas modificar otras propiedades, selecciona uno de los siguientes métodos:
Modifica un borrador o una solicitud de reserva futura rechazada
Si modificas un borrador de solicitud de reserva futura, puedes guardar los cambios o enviar la solicitud de reserva futura actualizada a Google Cloud. Si modificas una solicitud de reserva futura rechazada, debes enviar la solicitud para su revisión.
Para modificar las propiedades de un borrador o una solicitud de reserva futura rechazada, selecciona uno de los siguientes métodos:
Modifica un borrador o una reserva futura rechazada mediante la especificación de una plantilla de instancias
Para una solicitud de reserva futura creada a través de la especificación de una plantilla de instancias con un estado de adquisición de Borrador (
DRAFTING
) o Rechazado (DECLINED
), puedes modificar las siguientes propiedades:Puedes modificar un borrador o una solicitud de reserva futura rechazado que se creó si especificas una plantilla de instancias con la consola de Google Cloud, gcloud CLI y REST.
Consola
Para solicitar a través de Google Cloud que se modifique un borrador o una solicitud de reserva futura rechazada mediante la especificación de una plantilla de instancias, sigue estos pasos:
gcloud
Para solicitar que se modifique un borrador o una solicitud de reserva futura con Google Cloud y creada mediante la especificación de una plantilla de instancias, usa el comando
gcloud beta compute future-reservations update
.gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \ --description="DESCRIPTION" \ --name-prefix=NAME_PREFIX \ --planning-status=PLANNING_STATUS \ --project=PROJECT_ID \ --share-setting=SHARE_SETTING \ --share-with=CONSUMER_PROJECT_IDS \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
Reemplaza lo siguiente:
También puedes cambiar si con Compute Engine se borran de forma automática las reservas creadas de forma automática para una solicitud de reserva futura si realizas una de las siguientes acciones:
Por ejemplo, considera un borrador de solicitud de reserva futura compartida con el nombre
fr-03
y ubicada en la zonaus-central1-a
. Supongamos que deseas modificar esta solicitud de reserva futura compartida mediante los siguientes cambios:Para modificar
fr-03
, ejecuta el siguiente comando:gcloud beta compute future-reservations update fr-03 \ --clear-share-settings \ --no-auto-delete-auto-created-reservations \ --planning-status=SUBMITTED \ --project=example-project \ --total-count=100 \ --zone=us-central1-a
REST
Para solicitar que se modifique un borrador o una solicitud de reserva futura rechazada con Google Cloud y mediante la especificación de una plantilla de instancias, haz una
PATCH
solicitud al métodobeta.futureReservations.update
. En el parámetro de búsquedaupdateMask
, especifica cada campo que deseas actualizar. Si necesitas borrar un campo opcional de tu reserva, incluye ese campo en el parámetro de consultaupdateMask
y omite ese campo del cuerpo de la solicitud.PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS { "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS", "description": "DESCRIPTION", "name": "FUTURE_RESERVATION_NAME", "namePrefix": "NAME_PREFIX", "planningStatus": "PLANNING_STATUS", "shareSettings": { "projects": [ "CONSUMER_PROJECT_ID_1", "CONSUMER_PROJECT_ID_2" ], "shareType": "SHARE_TYPE" }, "specificSkuProperties": { "totalCount": "TOTAL_COUNT" }, "timeWindow": { "endTime": "END_TIME", "startTime": "START_TIME" } }
Reemplaza lo siguiente:
Por ejemplo, considera un borrador de solicitud de reserva futura compartida con el nombre
fr-03
y ubicada en la zonaus-central1-a
. Supongamos que deseas modificar esta solicitud de reserva futura compartida mediante los siguientes cambios:Para modificar
fr-03
, realiza la siguiente solicitudPATCH
:PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount { "autoDeleteAutoCreatedReservations": "false", "name": "fr-03", "planningStatus": "SUBMITTED", "shareSettings": { "shareType": "LOCAL" }, "specificSkuProperties": { "totalCount": "100" } }
Después de enviar una solicitud de reserva futura a Google Cloud para su revisión, consulta los detalles para supervisar su estado de adquisición.
Modifica un borrador o una reserva futura rechazada mediante la especificación directa de las propiedades
Para una solicitud de reserva futura que crean las propiedades directamente con un estado de adquisición establecido en Borrador (
DRAFTING
) o Rechazado (DECLINED
), puedes modificar las siguientes propiedades:Puedes modificar un borrador o una solicitud de reserva futura rechazada que se creó si especificaste las propiedades directamente con la consola de Google Cloud, gcloud CLI y REST.
Consola
Para solicitar que se modifique un borrador o una solicitud de reserva futura rechazada con Google Cloud y mediante la especificación directa de las propiedades, sigue estos pasos:
gcloud
Para solicitar a Google Cloud que modifique un borrador o una solicitud de reserva futura creada mediante la especificación directa de las propiedades, usa el
gcloud beta compute future-reservations update
.gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \ --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \ --description="DESCRIPTION" \ --local-ssd=size=375,interface=INTERFACE_1 \ --local-ssd=size=375,interface=INTERFACE_2 \ --machine-type=MACHINE_TYPE \ --min-cpu-platform=MIN_CPU_PLATFORM \ --name-prefix=NAME_PREFIX \ --planning-status=PLANNING_STATUS \ --project=PROJECT_ID \ --share-setting=SHARE_SETTING \ --share-with=CONSUMER_PROJECT_IDS \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
Reemplaza lo siguiente:
También puedes cambiar si con Compute Engine se borran de forma automática las reservas creadas de forma automática para una solicitud de reserva futura si realizas una de las siguientes acciones:
Por ejemplo, considera un borrador de solicitud de reserva futura compartida con el nombre
fr-03
y ubicada en la zonaus-central1-a
. Supongamos que deseas modificar esta solicitud de reserva futura compartida mediante los siguientes cambios:Para modificar
fr-03
, ejecuta el siguiente comando:gcloud beta compute future-reservations update fr-03 \ --clear-share-settings \ --no-auto-delete-auto-created-reservations \ --planning-status=SUBMITTED \ --project=example-project \ --total-count=100 \ --zone=us-central1-a
REST
Para solicitar que se modifique un borrador o una solicitud de reserva futura rechazada con Google Cloud mediante la especificación directa de las propiedades, haz lo siguiente:
PATCH
solicitud a labeta.futureReservations.update
método. En el parámetro de búsquedaupdateMask
, especifica cada campo que deseas actualizar. Si necesitas borrar un campo opcional de tu reserva, incluye ese campo en el parámetro de consultaupdateMask
y omite ese campo del cuerpo de la solicitud.PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS { "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS", "description": "DESCRIPTION", "name": "FUTURE_RESERVATION_NAME", "namePrefix": "NAME_PREFIX", "planningStatus": "PLANNING_STATUS", "shareSettings": { "projects": [ "CONSUMER_PROJECT_ID_1", "CONSUMER_PROJECT_ID_2" ], "shareType": "SHARE_TYPE" }, "specificSkuProperties": { "instanceProperties": { "guestAccelerators": [ { "acceleratorCount": NUMBER_OF_ACCELERATORS, "acceleratorType": "ACCELERATOR_TYPE" } ], "localSsds": [ { "diskSizeGb": "375", "interface": "INTERFACE_1" }, { "diskSizeGb": "375", "interface": "INTERFACE_2" } ], "machineType": "MACHINE_TYPE", "minCpuPlatform": "MINIMUM_CPU_PLATFORM" }, "totalCount": "TOTAL_COUNT" }, "timeWindow": { "endTime": "END_TIME", "startTime": "START_TIME" } }
Reemplaza lo siguiente:
Por ejemplo, considera un borrador de solicitud de reserva futura compartida con el nombre
fr-03
y ubicada en la zonaus-central1-a
. Supongamos que deseas modificar esta solicitud de reserva futura compartida mediante los siguientes cambios:Para modificar
fr-03
, realiza la siguiente solicitudPATCH
:PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount { "autoDeleteAutoCreatedReservations": "false", "name": "fr-03", "planningStatus": "SUBMITTED", "shareSettings": { "shareType": "LOCAL" }, "specificSkuProperties": { "totalCount": "100" } }
Después de enviar una solicitud de reserva futura a Google Cloud para su revisión, consulta los detalles para supervisar su estado de adquisición.
Modifica una reserva futura aprobada o en curso
Para modificar las propiedades de una reserva futura aprobada o en curso, selecciona uno de los siguientes métodos:
Modifica una reserva futura aprobada o en proceso de adquisición sin revisión
Para una reserva futura con un estado de adquisición establecido en Aprobado (
APPROVED
) o Adquirido (PROCURING
), puedes modificar los siguientes campos sin aprobación de Google Cloud:La modificación de estas propiedades es inmediata. Hasta la hora de inicio del período de reserva de una reserva futura, no hay límites para la cantidad de veces que puedes modificar estas propiedades.
Puedes modificar una reserva futura aprobada o en curso sin revisión con la consola de Google Cloud, gcloud CLI y REST.
Consola
Para modificar una reserva futura aprobada o en proceso de adquisición sin revisión, sigue estos pasos:
gcloud
Para modificar una reserva aprobada o que adquiera recursos sin revisión, usa el comando
gcloud beta compute future-reservations update
.gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \ --description="DESCRIPTION" \ --name-prefix=NAME_PREFIX \ --project=PROJECT_ID \ --zone=ZONE
Reemplaza lo siguiente:
De manera opcional, también puedes cambiar si quieres borrar de forma automática las reservas creadas de forma automática para una reserva futura con Compute Engine si realizas una de las siguientes acciones:
Por ejemplo, considera una reserva futura aprobada llamada
fr-04
y ubicada en la zonaus-central1-a
. Supongamos que deseas modificar esta reserva futura con los siguientes cambios:Para modificar
fr-04
, ejecuta el siguiente comando:gcloud beta compute future-reservations update fr-04 \ --auto-delete-auto-created-reservations \ --auto-created-reservations-duration=864000 \ --name-prefix=new-prefix \ --project=example-project \ --zone=us-central1-a
REST
Para modificar una reserva aprobada o adquirida sin revisión, haz una
PATCH
solicitud a labeta.futureReservations.update
método. En el parámetro de búsquedaupdateMask
, especifica cada campo que deseas actualizar. Si necesitas borrar un campo opcional de tu reserva, incluye ese campo en el parámetro de consultaupdateMask
y omite ese campo del cuerpo de la solicitud.PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS { "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS", "description": "DESCRIPTION", "name": "FUTURE_RESERVATION_NAME", "namePrefix": "NAME_PREFIX" }
Reemplaza lo siguiente:
Por ejemplo, considera una reserva futura aprobada llamada
fr-04
y ubicada en la zonaus-central1-a
. Supongamos que deseas modificar esta reserva futura con los siguientes cambios:Para modificar
fr-04
, realiza la siguiente solicitudPATCH
:PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-04?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CnamePrefix { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDuration": { "seconds": "864000" }, "name": "fr-04", "namePrefix": "new-prefix" }
Solicitud para modificar una reserva futura aprobada o en proceso de adquisición
Puedes solicitar a Google Cloud que modifique una reserva futura con un estado de adquisición establecido como Aprobado (
APPROVED
) o Adquirido (PROCURING
) de la siguiente manera:Para solicitar a Google Cloud que se modifiquen las propiedades de una reserva futura aprobada o seleccionada, selecciona uno de los siguientes métodos:
Solicitud para modificar una reserva futura creada mediante la especificación de una plantilla de instancias
Para una reserva futura creada a través de la especificación de una plantilla de instancias con un estado de adquisición de Aprobado (
APPROVED
) o Adquirido (PROCURING
), puedes solicitar modificar las siguientes propiedades:† Si solicitas aumentar o disminuir en gran medida el recuento total dentro de los 14 días posteriores a la hora de inicio de la reserva futura, es probable que Google Cloud rechace tu solicitud.
Puedes solicitar a Google Cloud que modifique una reserva futura creada si especificas una plantilla de instancias con gcloud CLI y REST.
Consola
Para solicitar a Google Cloud que se modifique una reserva futura aprobada o en proceso de creación mediante la especificación de una plantilla de instancias, sigue estos pasos:
gcloud
Para solicitar a Google Cloud que se modifique una reserva aprobada o una reserva futura adquirida mediante la especificación de una plantilla de instancias, usa el Comando
gcloud beta compute future-reservations update
.gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \ --description="DESCRIPTION" \ --name-prefix=NAME_PREFIX \ --planning-status=PLANNING_STATUS \ --project=PROJECT_ID \ --share-setting=SHARE_SETTING \ --share-with=CONSUMER_PROJECT_IDS \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
Reemplaza lo siguiente:
De manera opcional, también puedes cambiar si quieres borrar de forma automática las reservas creadas de forma automática para una reserva futura con Compute Engine si realizas una de las siguientes acciones:
Por ejemplo, considera una reserva futura aprobada llamada
fr-05
y ubicada en la zonaus-central1-a
. Supongamos que deseas solicitar a Google Cloud que se modifique esta reserva futura mediante los siguientes cambios:Para solicitar a Google Cloud que se modifique
fr-05
, ejecuta el siguiente comando:gcloud beta compute future-reservations update fr-05 \ --end-time=2024-12-31T00:00:00Z \ --name-prefix=new-prefix \ --planning-status=SUBMITTED \ --project=example-project \ --total-count=10 \ --zone=us-central1-a
REST
Para solicitar a Google Cloud que se modifique una reserva aprobada o reserva futura adquirida mediante la especificación de una plantilla de instancias, realiza una solicitud
PATCH
al métodobeta.futureReservations.update
. En el parámetro de búsquedaupdateMask
, especifica cada campo que deseas actualizar. Si necesitas borrar un campo opcional de tu reserva, incluye ese campo en el parámetro de consultaupdateMask
y omite ese campo del cuerpo de la solicitud.PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS { "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS", "description": "DESCRIPTION", "name": "FUTURE_RESERVATION_NAME", "namePrefix": "NAME_PREFIX", "planningStatus": "PLANNING_STATUS", "shareSettings": { "projects": [ "CONSUMER_PROJECT_ID_1", "CONSUMER_PROJECT_ID_2" ], "shareType": "SHARE_TYPE" }, "specificSkuProperties": { "totalCount": "TOTAL_COUNT" }, "timeWindow": { "endTime": "END_TIME", "startTime": "START_TIME" } }
Reemplaza lo siguiente:
Por ejemplo, considera una reserva futura aprobada llamada
fr-05
y ubicada en la zonaus-central1-a
. Supongamos que deseas solicitar a Google Cloud que se modifique esta reserva futura mediante los siguientes cambios:Para solicitar a Google Cloud que se modifique
fr-05
, realiza la siguiente solicitudPATCH
:PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-05?updateMask=namePrefix%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime { "name": "fr-05", "namePrefix": "new-prefix", "planningStatus": "SUBMITTED", "specificSkuProperties": { "totalCount": "10" }, "timeWindow": { "endTime": "2023-12-31T00:00:00Z" } }
Después de enviar una solicitud para modificar una reserva futura a Google Cloud, puedes supervisar el estado de la solicitud si visualizas los detalles de la reserva futura.
Solicitud para modificar una reserva futura creada directamente mediante la especificación de propiedades
Para una reserva futura creada a través de la especificación directa de las propiedades con un estado de adquisición de Aprobado (
APPROVED
) o Adquirido (Procuring
), puedes solicitar modificar las siguientes propiedades:‡ Si solicitas cambiar alguna propiedad de la VM, o aumentas o disminuyes en gran medida el recuento total dentro de los 14 días posteriores a la hora de inicio de la reserva futura, es probable que Google Cloud rechace la solicitud.
Puedes solicitar a Google Cloud que modifique una reserva futura creada si especificas propiedades directamente a través de la consola de Google Cloud, gcloud CLI y REST.
Consola
Para solicitar a Google Cloud que se modifique una reserva aprobada o en curso de creación futura mediante la especificación directa de las propiedades, sigue estos pasos:
gcloud
Para solicitar a Google Cloud que se modifique una reserva futura aprobada o en curso mediante la especificación directa de las propiedades, usa lo siguiente:
gcloud beta compute future-reservations update
comando.gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \ --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \ --description="DESCRIPTION" \ --local-ssd=size=375,interface=INTERFACE_1 \ --local-ssd=size=375,interface=INTERFACE_2 \ --machine-type=MACHINE_TYPE \ --min-cpu-platform=MIN_CPU_PLATFORM \ --name-prefix=NAME_PREFIX \ --planning-status=PLANNING_STATUS \ --project=PROJECT_ID \ --share-setting=SHARE_SETTING \ --share-with=CONSUMER_PROJECT_IDS \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
Reemplaza lo siguiente:
De manera opcional, también puedes cambiar si quieres borrar de forma automática las reservas creadas de forma automática para una reserva futura con Compute Engine si realizas una de las siguientes acciones:
Por ejemplo, considera una reserva futura aprobada llamada
fr-05
y ubicada en la zonaus-central1-a
. Supongamos que deseas solicitar a Google Cloud que se modifique esta reserva futura mediante los siguientes cambios:Para solicitar a Google Cloud que se modifique
fr-05
, ejecuta el siguiente comando:gcloud beta compute future-reservations update fr-05 \ --end-time=2024-12-31T00:00:00Z \ --name-prefix=new-prefix \ --planning-status=SUBMITTED \ --project=example-project \ --total-count=10 \ --zone=us-central1-a
REST
Para solicitar a Google Cloud que se modifique una reserva futura aprobada o reserva futura adquirida mediante la especificación directa de las propiedades, haz lo siguiente:
PATCH
solicitud a labeta.futureReservations.update
método. En el parámetro de búsquedaupdateMask
, especifica cada campo que deseas actualizar. Si necesitas borrar un campo opcional de tu reserva, incluye ese campo en el parámetro de consultaupdateMask
y omite ese campo del cuerpo de la solicitud.PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS { "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS", "description": "DESCRIPTION", "name": "FUTURE_RESERVATION_NAME", "namePrefix": "NAME_PREFIX", "planningStatus": "PLANNING_STATUS", "shareSettings": { "projects": [ "CONSUMER_PROJECT_ID_1", "CONSUMER_PROJECT_ID_2" ], "shareType": "SHARE_TYPE" }, "specificSkuProperties": { "instanceProperties": { "guestAccelerators": [ { "acceleratorCount": NUMBER_OF_ACCELERATORS, "acceleratorType": "ACCELERATOR_TYPE" } ], "localSsds": [ { "diskSizeGb": "375", "interface": "INTERFACE_1" }, { "diskSizeGb": "375", "interface": "INTERFACE_2" } ], "machineType": "MACHINE_TYPE", "minCpuPlatform": "MINIMUM_CPU_PLATFORM" }, "totalCount": "TOTAL_COUNT" }, "timeWindow": { "endTime": "END_TIME", "startTime": "START_TIME" } }
Reemplaza lo siguiente:
Por ejemplo, considera una reserva futura aprobada llamada
fr-05
y ubicada en la zonaus-central1-a
. Supongamos que deseas solicitar a Google Cloud que se modifique esta reserva futura mediante los siguientes cambios:Para solicitar a Google Cloud que se modifique
fr-05
, realiza la siguiente solicitudPATCH
:PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-05?updateMask=namePrefix%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime { "name": "fr-05", "namePrefix": "new-prefix", "planningStatus": "SUBMITTED", "specificSkuProperties": { "totalCount": "10" }, "timeWindow": { "endTime": "2023-12-31T00:00:00Z" } }
Después de enviar una solicitud para modificar una reserva futura a Google Cloud, puedes supervisar el estado de la solicitud si visualizas los detalles de la reserva futura.
Cambia cualquier otra propiedad en una solicitud de reserva futura
Si deseas cambiar cualquier otra propiedad en una solicitud de reserva futura antes de que alcance un estado de adquisición Adquirido (
PROCURING
), sigue estos pasos:Solución de problemas
Si te encuentras con errores cuando modificas una solicitud de reserva futura, consulta cómo solucionar problemas de solicitudes de reserva futuras.
Si los problemas persisten después de solucionar el problema, comunícate con tu representante de cuenta o con el servicio de Asistencia de Google Cloud.
Cancela solicitudes de reserva futuras
Puedes cancelar una solicitud de reserva futura aprobada, rechazada o adquirida para que a través de Google Cloud no se suministre la capacidad solicitada. Después de cancelar una reserva futura, solo podrás ver sus detalles o borrarla.
Puedes cancelar una solicitud de reserva futura con gcloud CLI y REST.
gcloud
Para cancelar una solicitud de reserva futura, usa el comando
gcloud beta compute future-reservations cancel
.gcloud beta compute future-reservations cancel FUTURE_RESERVATION_NAME \ --project=PROJECT_ID \ --zone=ZONE
Reemplaza lo siguiente:
REST
Para cancelar una solicitud de reserva futura, realiza una solicitud
POST
al métodobeta.futureReservations.cancel
.POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME/cancel
Reemplaza lo siguiente:
Borrar solicitudes de reserva futuras
Puedes borrar una solicitud de reserva futura solo en uno de los siguientes casos:
Borrar una reserva futura no borra las reservas creadas de forma automática para la reserva futura. Si deseas borrar una reserva creada de forma automática después del final del período de reserva, consulta Borra reservas en su lugar.
Puedes borrar una solicitud de reserva futura con la consola de Google Cloud, gcloud CLI y REST.
Consola
Para borrar una solicitud de reserva futura, sigue estos pasos:
gcloud
Para borrar una solicitud de reserva futura, usa el comando
gcloud beta compute future-reservations delete
.gcloud beta compute future-reservations delete FUTURE_RESERVATION_NAME \ --project=PROJECT_ID \ --zone=ZONE
Reemplaza lo siguiente:
REST
Para borrar una solicitud de reserva futura, realiza una solicitud
DELETE
al métodobeta.futureReservations.delete
.DELETE https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME
Reemplaza lo siguiente:
¿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-08-01 (UTC)
[{ "type": "thumb-down", "id": "hardToUnderstand", "label":"Hard to understand" },{ "type": "thumb-down", "id": "incorrectInformationOrSampleCode", "label":"Incorrect information or sample code" },{ "type": "thumb-down", "id": "missingTheInformationSamplesINeed", "label":"Missing the information/samples I need" },{ "type": "thumb-down", "id": "translationIssue", "label":"Problema de traducción" },{ "type": "thumb-down", "id": "otherDown", "label":"Otro" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Fácil de comprender" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Resolvió mi problema" },{ "type": "thumb-up", "id": "otherUp", "label":"Otro" }] -