Loading...
Loading...
Inspects, verifies, and manages Google Compute Engine (GCE) On-Demand reservations and analyzes consumed versus available reserved capacity. Use when checking active reservation capacity, determining whether reserved VMs are available or exhausted, verifying reservation targeting (automatic versus specific reservation), or sharing reservations across projects. Don't use for Spot capacity advice (use compute-spot-capacity-advice) or future calendar bookings (use compute-future-reservations).
npx skill4agent add google/skills compute-on-demand-reservationscompute-on-demand-reservationsgcloud--project={project_id}--zone={zone}us-central1us-central1-agcloud config set project {project_id}
gcloud config set compute/region {region}
gcloud config set compute/zone {zone}gcloud services enable compute.googleapis.com --project={project_id}apt-getcurl | bashgcloud auth logingcloud auth application-default loginGOOGLE_APPLICATION_CREDENTIALSlistdescriberoles/compute.viewercompute.reservations.listcompute.reservations.getcreateupdatedeleteroles/compute.admincompute.reservations.createcompute.reservations.resizecompute.reservations.updatecompute.reservations.deleteinstances createroles/compute.instanceAdmin.v1constraints/compute.sharedReservationsOwnerProjects.md.txtgcloud compute reservations list \
--project={project_id} \
[--zones={zone}] \
[--format="table(name,zone.basename(),specificReservation.instanceProperties.machineType.basename(),specificReservation.assuredCount,specificReservation.inUseCount,specificReservation.count,specificReservationRequired,shareSettings.shareType,status)"]gcloud compute reservations describe {reservation_name} \
--zone={zone} \
--project={project_id}aggregateReservationspecificReservation.*listaggregateReservation.totalResourcesaggregateReservation.inUseResourcesdescribe[!IMPORTANT] Creating a reservation immediately incurs billing charges. Always obtain explicit human approval before executing.gcloud compute reservations create
gcloud compute reservations create {reservation_name} \
--project={project_id} \
--zone={zone} \
--vm-count={vm_count} \
(--machine-type={machine_type} | --source-instance-template={template_name}) \
[--min-cpu-platform={min_cpu_platform}] \
[--accelerator=count={gpu_count},type={gpu_type}] \
[--local-ssd=interface={nvme|scsi}] \
[--require-specific-reservation] \
[--share-setting=projects --share-with={consumer_project_ids}] # up to 100 consumer projects in the same org (excluding the host project)--vm-count--share-with--add-share-with--remove-share-withmachineTypeminCpuPlatformacceleratorlocalSsdzonespecificReservationRequiredgcloud compute reservations update {reservation_name} \
--project={project_id} \
--zone={zone} \
[--vm-count={new_vm_count}] \
[--add-share-with={project_ids_or_numbers} | --remove-share-with={project_numbers}]commitmentgcloud beta compute commitments update-reservationsspecificReservationRequired: trueinUseCount > 0--quietgcloud compute reservations delete {reservation_name} \
--zone={zone} \
--project={project_id}statusREADYUPDATINGCREATINGDELETINGstatusREADYUPDATINGUPDATINGspecificReservation.assuredCountCREATINGDELETINGspecificReservation.assuredCountassuredCountspecificReservation.counthealthInfo.healthStatus: DEGRADEDspecificReservation.countspecificReservation.inUseCountAvailable Capacity = specificReservation.assuredCount - specificReservation.inUseCount> 0inUseCount >= assuredCountspecificReservationRequired| Setting | Consumption Mode | Matching Behavior |
|---|---|---|
| Automatic ( | Any newly created |
| Targeted ( | VMs do not consume this capacity unless they match all reserved |
ANY_RESERVATIONSPECIFIC_RESERVATIONspecificReservation.instancePropertieszoneLOCALshareSettings.projectMapzonemachineTypeminCpuPlatform"Automatic"--min-cpu-platformguestAcceleratorsacceleratorTypeacceleratorCountlocalSsdsNVMESCSIresourcePolicieslocationHintprovisioningModelSTANDARDSPOT[!WARNING] Silent Double-Billing Trap: Under(ANY_RESERVATION, the default), if a newly created VM matches--reservation-affinity=anyandzonebut differs on even a single property (such asmachineTypevs.NVMELocal SSD interface orSCSI), Compute Engine silently skips the reservation, launches an unreserved On-Demand VM, and bills for both the idle reservation and the new VM. Creating both the reservation and VMs from the sameminCpuPlatformprevents property drift.--source-instance-template
--no-address--service-accountspecificReservationRequired: true--reservation-affinity=specificspecificReservationRequired: falsegcloud compute instances create {vm_name} \
--project={project_id} \
--zone={zone} \
--machine-type={machine_type} \
--reservation-affinity=specific \
--reservation={reservation_name} \
[--no-address] \
[--service-account={service_account_email}]gcloud compute instances create {vm_name} \
--project={project_id} \
--zone={zone} \
--machine-type={machine_type} \
--reservation-affinity=none \
[--no-address] \
[--service-account={service_account_email}]shareSettingsshareType: LOCALshareType: SPECIFIC_PROJECTSprojectMap{"projectId": "..."}gcloud compute reservations list --project={consumer_project_id}--project={host_project_id}assuredCountinUseCount--project={consumer_project_id}--reservationgcloud compute instances create {vm_name} \
--project={consumer_project_id} \
--zone={zone} \
--machine-type={machine_type} \
--reservation-affinity=specific \
--reservation=projects/{host_project_id}/reservations/{reservation_name} \
[--no-address] \
[--service-account={service_account_email}]gcloud compute reservations creategcloud compute reservations updategcloud compute reservations deletegcloud compute instances createlist_reservationsspecific_reservationshare_settingsget_reservation_detailsgcloud compute reservations listcreate_instancereservation_affinitymin_cpu_platformlocal_ssdSPECIFIC_RESERVATIONgcloudgcloud compute reservations createcompute-spot-capacity-advicegcloud beta compute advice capacity --provisioning-model=SPOTgcloud compute reservations listdescribe