Loading...
Loading...
Evaluates future GPU and TPU reservation feasibility and calendar-mode booking options in Google Compute Engine (GCE). Use when planning future AI/ML training runs, checking reservation availability windows, verifying accelerator cluster topologies, or assessing future capacity lead times. Don't use for active on-demand reservations (use compute-on-demand-reservations), immediate Spot capacity queries (use compute-spot-capacity-advice), or Standard Future Reservations (--reservation-mode=DEFAULT).
npx skill4agent add google/skills compute-future-reservationscompute-future-reservations[!NOTE] Scope Boundary (Calendar Mode vs. Standard Future Reservations): This skill covers Calendar-Mode Future Reservations (, backed by Dynamic Workload Scheduler for up to 90 days on supported families such as--reservation-mode=CALENDAR,a3*,a4*, and Cloud TPUs; for newly released machine series, verify Calendar Mode support dynamically viah4d*or the official Calendar Mode documentation). Do not apply Calendar-Mode flags (gcloud compute advice calendar-mode,--reservation-mode=CALENDAR) to Standard Future Reservations (--deployment-type=DENSEfor general-purpose CPU families,--reservation-mode=DEFAULT/a2*GPUs,g2*planning workflows, or multi-month/CUD commitments).DRAFT
gcloud--project={project_id}--region={region}--zone={zone}us-central1gcloud config set project {project_id}
gcloud config set compute/region {region}gcloud services enable compute.googleapis.com --project={project_id}apt-getcurl | bashgcloud auth logingcloud auth application-default loginGOOGLE_APPLICATION_CREDENTIALSadvice calendar-modecreatelistdescribedeleteroles/compute.futureReservationUsercompute.advice.calendarModecompute.futureReservations.createcompute.futureReservations.deletecompute.futureReservations.getcompute.futureReservations.listcompute.reservations.createcompute.futureReservations.cancelcancelroles/compute.futureReservationAdminroles/compute.admincompute.futureReservations.cancelstart-timeconstraints/compute.sharedReservationsOwnerProjectsstart-time.md.txt# For GPU / H4D VMs:
gcloud compute advice calendar-mode \
--project={project_id} \
--region={region} \
--machine-type={machine_type} \
--vm-count={total_instances} \
--start-time-range=from={start_date},to={end_date} \
--duration-range=min={min_duration},max={max_duration} \
[--location-policy={zone}={policy}]
# For Cloud TPUs (supported --tpu-version values: V6E, V5P, V5E; --workload-type is required for V5E):
gcloud compute advice calendar-mode \
--project={project_id} \
--region={region} \
--tpu-version={V6E|V5P|V5E} \
--chip-count={chip_count} \
--start-time-range=from={start_date},to={end_date} \
--duration-range=min={min_duration},max={max_duration} \
[--workload-type={BATCH|SERVING}] \
[--location-policy={zone}={policy}]# List planned future reservations
gcloud compute future-reservations list \
--project={project_id} \
[--zones={zone}]
# Inspect a specific future reservation plan
gcloud compute future-reservations describe {future_reservation_name} \
--zone={zone} \
--project={project_id}[!IMPORTANT] Submitting a future reservation request () commits to capacity billing once approved. Always obtain explicit human approval before executing--planning-status=SUBMITTED.gcloud compute future-reservations create
calendar-mode# For GPU / H4D VMs (requires --deployment-type=DENSE):
gcloud compute future-reservations create {future_reservation_name} \
--project={project_id} \
--zone={zone} \
--total-count={total_instances} \
--machine-type={machine_type} \
--deployment-type=DENSE \
--reservation-mode=CALENDAR \
--planning-status=SUBMITTED \
--require-specific-reservation \
--reservation-name={reservation_name} \
--start-time={start_rfc3339} \
--end-time={end_rfc3339} \
--auto-delete-auto-created-reservations \
[--share-setting=projects --share-with={consumer_project_ids}]
# For Cloud TPUs:
gcloud compute future-reservations create {future_reservation_name} \
--project={project_id} \
--zone={zone} \
--tpu-version={tpu_version} \
--chip-count={chip_count} \
--reservation-mode=CALENDAR \
--planning-status=SUBMITTED \
--require-specific-reservation \
--reservation-name={reservation_name} \
--start-time={start_rfc3339} \
--end-time={end_rfc3339} \
--auto-delete-auto-created-reservations \
[--workload-type={BATCH|SERVING}] \
[--share-setting=projects --share-with={consumer_project_ids}]cancelroles/compute.futureReservationAdmincancelAPPROVEDstart-time720start-time96deletedeleteCANCELLEDend-time--quiet# Cancel a pending or approved future reservation request (within the allowed window)
gcloud compute future-reservations cancel {future_reservation_name} \
--zone={zone} \
--project={project_id}
# Delete a cancelled or completed future reservation record
gcloud compute future-reservations delete {future_reservation_name} \
--zone={zone} \
--project={project_id}start-timestart-time{reservation_name}--provisioning-model=RESERVATION_BOUND--maintenance-policy=TERMINATE--instance-termination-action={STOP|DELETE}--no-address--service-accountgcloud compute instances create {vm_name} \
--project={project_id} \
--zone={zone} \
--machine-type={machine_type} \
--reservation-affinity=specific \
--reservation={reservation_name} \
--provisioning-model=RESERVATION_BOUND \
--maintenance-policy=TERMINATE \
--instance-termination-action=DELETE \
[--no-address] \
[--service-account={service_account_email}]gcloud compute instances creategcloud compute instance-templates creategcloud compute instance-groups managed createct6e-standard-8t--reservation-affinity=specific--reservation=projects/{project_id}/reservations/{reservation_name}--provisioning-model=RESERVATION_BOUND--maintenance-policy=TERMINATE--start-time-range=from={start_date},to={end_date}from=2026-11-01T00:00:00Z,to=2026-11-30T00:00:00Z--duration-range=min={min_duration},max={max_duration}min=7d,max=14dmin=14d,max=14dminmax--location-policy={zone}={policy}ALLOWDENYus-central1-a=ALLOW,us-central1-b=DENY--tpu-version={V6E|V5P|V5E}advice calendar-modeTPU7Xfuture-reservations createadvice calendar-mode--workload-type={BATCH|SERVING}--tpu-version=V5EV6EV5PBATCHSERVING--reservation-mode=CALENDAR--planning-status=SUBMITTEDDRAFT--require-specific-reservation--reservation-name={reservation_name}start-time{reservation_name}{future_reservation_name}-res--deployment-type=DENSE--share-setting={share_type}localprojects--share-with--auto-delete-auto-created-reservationsend-time--no-auto-delete-auto-created-reservationsCALENDAR_MODE_MISSING_AUTO_DELETEgcloud compute advice calendar-modea4-highgpu-8ga3-ultragpu-8ga3-megagpu-8ga3-highgpu-8ga3-edgegpu-8gh4d-standard-192h4d-highmem-192h4d-highmem-192-lssd--vm-count--total-count1801256a2-*g2-*a4x-*--chip-countV6E1, 4, 8, 16, 32, 64, 128, 256V5P4, 8, 16, 32, 64, 128, 256, 512, 102411024V5E--workload-typeSERVING1, 4, 8BATCH16, 32, 64, 128, 256TPU7Xfuture-reservations createadvice calendar-mode4, 8, 16, 32, 64, 128, 256, 512, 10241gcloud compute advice calendar-moderecommendationsrecommendationsPerSpec.specrecommendations:
- recommendationsPerSpec:
spec:
endTime: '2026-11-29T00:00:00Z'
location: zones/us-central1-a
otherLocations:
zones/us-central1-b:
details: this machine family is not supported in this zone
status: NOT_SUPPORTED
recommendationId: 87cc2159-5205-4804-b764-a0ca8d10397c
recommendationType: FUTURE_RESERVATION
startTime: '2026-11-15T00:00:00Z'specstartTimeendTimelocationzones/us-central1-azones/us-central1-a--zonegcloud compute future-reservations createotherLocationszones/<zone>--regionstatus: RECOMMENDEDNO_CAPACITYCONDITIONS_NOT_METNOT_SUPPORTEDgcloud compute future-reservations createstartTimelocationotherLocationszones/<zone>status: NO_CAPACITYCONDITIONS_NOT_METNOT_SUPPORTEDRECOMMENDEDstartTimelocationotherLocationsgcloud compute advice calendar-mode --region={other_region}us-east4us-west1--start-time-range=from=...,to=...--duration-rangea3-highgpu-8ga3-megagpu-8ggcloud compute future-reservations createcanceldeletegcloud compute reservations updategcloud compute future-reservations updatestart-timegcloud compute reservations updateAdviceServiceadvice calendar-modeFutureReservationsServicecreate_instanceprovisioning_model: RESERVATION_BOUNDgcloudgcloud beta compute advice capacity --provisioning-model=SPOT