- NAME
-
- gcloud alpha compute future-reservations update - update Compute Engine future reservations
- SYNOPSIS
-
-
gcloud alpha compute future-reservations updateFUTURE_RESERVATION[--[no-]auto-delete-auto-created-reservations] [--deployment-type=DEPLOYMENT_TYPE] [--description=DESCRIPTION] [--enable-opportunistic-maintenance=ENABLE_OPPORTUNISTIC_MAINTENANCE] [--instance-termination-action=INSTANCE_TERMINATION_ACTION] [--planning-status=PLANNING_STATUS] [--[no-]require-specific-reservation] [--reservation-name=RESERVATION_NAME] [--scheduling-type=SCHEDULING_TYPE] [--total-count=TOTAL_COUNT] [--zone=ZONE] [--auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME|--auto-created-reservations-duration=AUTO_CREATED_RESERVATIONS_DURATION] [--clear-name-prefix|--name-prefix=NAME_PREFIX] [--clear-share-settings|--share-setting=SHARE_SETTING--share-with=PROJECT,[PROJECT,…]] [--commitment-name=COMMITMENT_NAME--commitment-plan=COMMITMENT_PLAN--previous-commitment-terms=PREVIOUS_COMMITMENT_TERMS] [--machine-type=MACHINE_TYPE--maintenance-interval=MAINTENANCE_INTERVAL--min-cpu-platform=MIN_CPU_PLATFORM--accelerator=[count=COUNT],[type=TYPE] |--clear-accelerator--clear-local-ssd|--local-ssd=[count=COUNT],[interface=INTERFACE],[size=SIZE]] [--start-time=START_TIME--duration=DURATION|--end-time=END_TIME] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(ALPHA)Update Compute Engine future reservations. - EXAMPLES
-
To update total count, start and end time of a Compute Engine future reservation
in
us-central1-agcloud alpha compute future-reservations update my-future-reservation --total-count=1000 --start-time=2021-11-10T07:00:00Z --end-time=2021-12-10T07:00:00Z --zone=us-central1-a - POSITIONAL ARGUMENTS
-
FUTURE_RESERVATION- Name of the future reservation to update.
- FLAGS
-
--[no-]auto-delete-auto-created-reservations-
If specified, the auto-created reservations for a future reservation are deleted
at the end time (default) or at a specified delete time. Use
--auto-delete-auto-created-reservationsto enable and--no-auto-delete-auto-created-reservationsto disable. --deployment-type=DEPLOYMENT_TYPE-
Indicates if the reservation allocation strategy is static or dynamic. DENSE
refers to a fixed size and topology, with deployment expressed in terms of
blocks. FLEXIBLE indicates a non-static distribution of capacity that can change
over time. Deployment is not expressed in blocks.
DEPLOYMENT_TYPEmust be one of:DENSE,FLEXIBLE. --description=DESCRIPTION- An optional description of the future reservation to create.
--enable-opportunistic-maintenance=ENABLE_OPPORTUNISTIC_MAINTENANCE- Indicates if this group of VMs have opportunistic maintenance enabled. Applicable only to dense coordinated maintenance.
--instance-termination-action=INSTANCE_TERMINATION_ACTION-
Specific termination action for running instances at the end of reservation
duration, it can be DELETE or STOP.
INSTANCE_TERMINATION_ACTIONmust be one of:DELETE,STOP. --planning-status=PLANNING_STATUS-
The planning status of the future reservation. The default value is DRAFT. While
in DRAFT, any changes to the future reservation's properties will be allowed. If
set to SUBMITTED, the future reservation will submit and its procurementStatus
will change to PENDING_APPROVAL. Once the future reservation is pending
approval, changes to the future reservation's properties will not be allowed.
PLANNING_STATUSmust be one of:DRAFT- Default planning status value.
SUBMITTED- Planning status value to immediately submit the future reservation.
--[no-]require-specific-reservation-
Indicate whether the auto-created reservations can be consumed by VMs with "any
reservation" defined. If enabled, then only VMs that target the auto-created
reservation by name using
--reservation-affinity=specificcan consume from this reservation. Auto-created reservations delivered with this flag enabled will inherit the name of the future reservation. Use--require-specific-reservationto enable and--no-require-specific-reservationto disable. --reservation-name=RESERVATION_NAME- Name of reservations where the capacity is provisioned at the time of delivery of future reservations. If the reservation with the given name does not exist already, it is created automatically at the time of Approval with INACTIVE state till specified start-time. Either provide the reservation_name or a name_prefix.
--scheduling-type=SCHEDULING_TYPE-
Indicates the maintenance type for this group of VMs. This will be set on the
reservation via FR, and will be inherited for reservation blocks.
SCHEDULING_TYPEmust be one of:GROUPED,INDEPENDENT. --total-count=TOTAL_COUNT- The total number of instances for which capacity assurance is requested at a future time period.
--zone=ZONE-
Zone of the future reservation to update. If not specified and the
compute/zoneTo avoid prompting when this flag is omitted, you can set the
compute/zonegcloud config set compute/zone ZONEA list of zones can be fetched by running:
gcloud compute zones listTo unset the property, run:
gcloud config unset compute/zoneAlternatively, the zone can be stored in the environment variable
CLOUDSDK_COMPUTE_ZONE -
Manage the auto-delete time properties.
At most one of these can be specified:
--auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME- Automatically deletes an auto-created reservations at a specific time. The specified time must be an RFC3339 timestamp, which must be formatted as "YYYY-MM-DDTHH:MM:SSZ" where YYYY = year, MM = month, DD = day, HH = hours, MM = minutes, SS = seconds, and Z = time zone in Coordinated Universal Time (UTC). For example, specify 2021-11-20T07:00:00Z.
--auto-created-reservations-duration=AUTO_CREATED_RESERVATIONS_DURATION- Automatically deletes an auto-created reservations after a specified number of days, hours, minutes, or seconds. For example, specify 30m for 30 minutes, or 1d2h3m4s for 1 day, 2 hours, 3 minutes, and 4 seconds. For more information, see $ gcloud topic datetimes.
-
Manage the name-prefix of a future reservation.
At most one of these can be specified:
--clear-name-prefix- Clears the name prefix for the system generated reservations.
--name-prefix=NAME_PREFIX- A name prefix for the auto-created reservations when capacity is delivered at the start time. Each auto-created reservation name starts with the name prefix.
-
Manage the properties of a shared future reservation.
At most one of these can be specified:
- Clear share settings on future reservation. This will result in non-shared future reservation.
-
Manage the share settings of a future reservation.
-
Specify if this future reservation is shared, and if so, the type of sharing. If
you omit this flag, this value is local by default.
SHARE_SETTINGmust be one of:local,projects. - If this future reservation is shared, provide a comma-separated list of projects that this future reservation is shared with. The list must contain project IDs or project numbers.
-
Specify if this future reservation is shared, and if so, the type of sharing. If
you omit this flag, this value is local by default.
-
Manage the commitment info properties
--commitment-name=COMMITMENT_NAME- Name of commitment covering the delivered reservation at the time of delivery of future reservations. If not specified, it takes the name of the future reservation.
--commitment-plan=COMMITMENT_PLAN-
The plan for this commitment to be created, which determines duration and
discount rate. The currently supported plans are TWELVE_MONTH (1 year), and
THIRTY_SIX_MONTH (3 years).
COMMITMENT_PLANmust be one of:TWELVE_MONTH,THIRTY_SIX_MONTH. --previous-commitment-terms=PREVIOUS_COMMITMENT_TERMS-
Applicable only if future reservation will deliver to an existing reservation
with a ramp plan. When set to EXTEND, all associated parent Committed Used
Discount's end-date/term will be extended to the end-time of this future
reservation. Default is to extend previous commitment's time to the end_time of
the reservation.
PREVIOUS_COMMITMENT_TERMSmust be (only one value is supported):EXTEND.
-
Manage the specific SKU reservation properties.
--machine-type=MACHINE_TYPE-
The type of machine (name only) that has a fixed number of vCPUs and a fixed
amount of memory. You can also specify a custom machine type by using the
pattern
custom-number_of_CPUs-amount_of_memory-for example,custom-32-29440. --maintenance-interval=MAINTENANCE_INTERVAL-
Specifies how infrastructure upgrades should be applied to the VM.
MAINTENANCE_INTERVALmust be one of:PERIODIC- VMs receive infrastructure and hypervisor updates on a periodic basis, minimizing the number of maintenance operations (live migrations or terminations) on an individual VM. Security updates will still be applied as soon as they are available.
RECURRENT- VMs receive infrastructure and hypervisor updates on a periodic basis, minimizing the number of maintenance operations (live migrations or terminations) on an individual VM. This may mean a VM will take longer to receive an update than if it was configured for AS_NEEDED. Security updates will still be applied as soonas they are available. RECURRENT is used for GEN3 and Sliceof Hardware VMs.
--min-cpu-platform=MIN_CPU_PLATFORM- Optional minimum CPU platform of the reservation to create.
-
Manage the accelerators of a future reservation.
At most one of these can be specified:
--accelerator=[count=COUNT],[type=TYPE]-
Manage the configuration of the type and number of accelerator cards attached.
count- The number of accelerators to attach to each instance in the reservation.
type-
The specific type (e.g.
nvidia-tesla-k80for nVidia Tesla K80) of accelerator to attach to instances in the reservation. Usegcloud compute accelerator-types listto learn about all available accelerator types.
--clear-accelerator- Remove all accelerators from the future reservation.
-
Manage the local ssd of a future reservation.
At most one of these can be specified:
--clear-local-ssd- Remove all local ssd information on the future reservation.
--local-ssd=[count=COUNT],[interface=INTERFACE],[size=SIZE]-
Manage the size and the interface of local SSD to use. See https://cloud.google.com/compute/docs/disks/local-ssd
for more information.
interface-
The kind of disk interface exposed to the VM for this SSD. Valid values are
scsiandnvme. SCSI is the default and is supported by more guest operating systems. NVME may provide higher performance. size- The size of the local SSD in base-2 GB.
count- The number of local SSD to use per VM. Default value is 1.
-
Manage the time specific properties for requesting future capacity
--start-time=START_TIME- Start time of the Future Reservation. The start time must be an RFC3339 valid string formatted by date, time, and timezone or "YYYY-MM-DDTHH:MM:SSZ"; where YYYY = year, MM = month, DD = day, HH = hours, MM = minutes, SS = seconds, and Z = timezone (i.e. 2021-11-20T07:00:00Z).
-
At most one of these can be specified:
--duration=DURATION- Alternate way of specifying time in the number of seconds to terminate capacity request relative to the start time of a request.
--end-time=END_TIME- End time of the Future Reservation. The end time must be an RFC3339 valid string formatted by date, time, and timezone or "YYYY-MM-DDTHH:MM:SSZ"; where YYYY = year, MM = month, DD = day, HH = hours, MM = minutes, SS = seconds, and Z = timezone (i.e. 2021-11-20T07:00:00Z).
- GCLOUD WIDE FLAGS
-
These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$ gcloud helpfor details. - NOTES
-
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation-only early access
allowlist. These variants are also available:
gcloud compute future-reservations updategcloud beta compute future-reservations update
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-08-28 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": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]
{"lastModified": "Last updated 2024-08-28 UTC."}