gcloud compute instance-groups managed update-autoscaling NAME [--cpu-utilization-predictive-method=CPU_UTILIZATION_PREDICTIVE_METHOD] [--max-num-replicas=MAX_NUM_REPLICAS] [--min-num-replicas=MIN_NUM_REPLICAS] [--mode=MODE] [--stabilization-period=STABILIZATION_PERIOD] [--clear-scale-in-control | --scale-in-control=[max-scaled-in-replicas=MAX-SCALED-IN-REPLICAS],[max-scaled-in-replicas-percent=MAX-SCALED-IN-REPLICAS-PERCENT],[time-window=TIME-WINDOW]] [--disable-schedule=SCHEDULE_NAME | --enable-schedule=SCHEDULE_NAME | --remove-schedule=SCHEDULE_NAME | --set-schedule=SCHEDULE_NAME | --update-schedule=SCHEDULE_NAME] [--region=REGION | --zone=ZONE] [--schedule-cron=CRON_EXPRESSION --schedule-description=DESCRIPTION --schedule-duration-sec=DURATION --schedule-min-required-replicas=MIN_REQUIRED_REPLICAS --schedule-time-zone=TIME_ZONE] [GCLOUD_WIDE_FLAG …]
gcloud compute instance-groups managed update-autoscaling updates
autoscaling parameters of specified managed instance group.
Autoscalers can use one or more autoscaling signals. Information on using multiple autoscaling signals can be found here: https://cloud.google.com/compute/docs/autoscaler/multiple-signals
In contrast to gcloud
compute instance-groups managed set-autoscaling, this command
only updates specified fields. For instance:
gcloud compute instance-groups managed update-autoscaling --mode only-scale-outmode field of the autoscaler policy, but leave the
rest of the settings intact.
gcloud compute instance-groups managed update-autoscaling --mode=only-scale-outNAME--cpu-utilization-predictive-method=CPU_UTILIZATION_PREDICTIVE_METHODCPU_UTILIZATION_PREDICTIVE_METHOD must be one of:
noneoptimize-availability--max-num-replicas=MAX_NUM_REPLICAS--min-num-replicas=MIN_NUM_REPLICAS--mode=MODEYou can turn off or restrict a group's autoscaler activities without affecting your autoscaler configuration. The autoscaler configuration persists while the activities are turned off or restricted, and the activities resume when the autoscaler is turned on again or when the restrictions are lifted.
MODE must be one of:
offononly-scale-outonly-uponly-up is deprecated. Use --mode only-scale-out
instead.
--stabilization-period=STABILIZATION_PERIOD--clear-scale-in-control--scale-in-control flag.
--scale-in-control=[max-scaled-in-replicas=MAX-SCALED-IN-REPLICAS],[max-scaled-in-replicas-percent=MAX-SCALED-IN-REPLICAS-PERCENT],[time-window=TIME-WINDOW]max-scaled-in-replicasmax-scaled-in-replicas-percenttime-window--disable-schedule=SCHEDULE_NAME--enable-schedule=SCHEDULE_NAME--remove-schedule=SCHEDULE_NAMEBe careful with this action as scaling schedule deletion cannot be undone.
You can delete any schedule regardless of its status. If you delete a scaling schedule that is currently active, the deleted scaling schedule stops being effective immediately after it is deleted. If there is no need to maintain capacity, the autoscaler starts removing instances after the usual stabilization period and after scale-in controls (if configured). For more information, see Delays in scaling in and Scale-in controls. This ensures you don't accidentally lose capacity immediately after the scaling schedule ends.--set-schedule=SCHEDULE_NAME--update-schedule=SCHEDULE_NAME--region=REGIONA list of regions can be fetched by running:
gcloud compute regions listcompute/region property value for this
command invocation.
--zone=ZONEA list of zones can be fetched by running:
gcloud compute zones listcompute/zone property value for this command
invocation.
--schedule-cron=CRON_EXPRESSION--schedule-description=DESCRIPTION--schedule-duration-sec=DURATION--schedule-min-required-replicas=MIN_REQUIRED_REPLICASAutoscaler provides at least this number of instances when the scaling schedule is active. A managed instance group can have more VMs if there are other scaling schedules active with more required instances or if another signal (for example, scaling based on CPU) requires more instances to meet its target.
This configuration does not change autoscaling minimum and maximum instance limits which are always in effect. Autoscaler does not create more than the maximum number of instances configured for a group.--schedule-time-zone=TIME_ZONEIt should be provided as a name from the IANA tz database (for example Europe/Paris or UTC). It automatically adjusts for daylight savings time (DST). If no time zone is provided, UTC is used as a default.
See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones for the list of valid timezones.--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 help for details.
gcloud alpha compute instance-groups managed update-autoscalinggcloud beta compute instance-groups managed update-autoscalinggcloud preview compute instance-groups managed update-autoscaling
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 2026-05-27 UTC.