REST Resource: regionAutoscalers

Resource: Autoscaler

Represents an Autoscaler resource.

Google Compute Engine has two Autoscaler resources:

Use autoscalers to automatically add or delete instances from a managed instance group according to your defined autoscaling policy. For more information, read Autoscaling Groups of Instances.

For zonal managed instance groups resource, use the autoscaler resource.

For regional managed instance groups, use the regionAutoscalers resource.

JSON representation
  "id": string,
  "creationTimestamp": string,
  "name": string,
  "description": string,
  "target": string,
  "autoscalingPolicy": {
    "minNumReplicas": integer,
    "maxNumReplicas": integer,
    "scaleInControl": {
      "maxScaledInReplicas": {
        "fixed": integer,
        "percent": integer,
        "calculated": integer
      "timeWindowSec": integer
    "coolDownPeriodSec": integer,
    "cpuUtilization": {
      "utilizationTarget": number,
      "predictiveMethod": enum
    "customMetricUtilizations": [
        "metric": string,
        "filter": string,
        "utilizationTargetType": enum,

        "utilizationTarget": number,
        "singleInstanceAssignment": number
    "loadBalancingUtilization": {
      "utilizationTarget": number
    "mode": enum,
    "scalingSchedules": {
      string: {
        "minRequiredReplicas": integer,
        "schedule": string,
        "timeZone": string,
        "durationSec": integer,
        "disabled": boolean,
        "description": string
  "zone": string,
  "region": string,
  "selfLink": string,
  "status": enum,
  "statusDetails": [
      "message": string,
      "type": enum
  "recommendedSize": integer,
  "scalingScheduleStatus": {
    string: {
      "nextStartTime": string,
      "lastStartTime": string,
      "state": enum
  "kind": string

string (uint64 format)

[Output Only] The unique identifier for the resource. This identifier is defined by the server.



[Output Only] Creation timestamp in RFC3339 text format.



Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.



An optional description of this resource. Provide this property when you create the resource.



URL of the managed instance group that this autoscaler will scale. This field is required when creating an autoscaler.



The configuration parameters for the autoscaling algorithm. You can define one or more signals for an autoscaler: cpuUtilization, customMetricUtilizations, and loadBalancingUtilization.

If none of these are specified, the default will be to autoscale based on cpuUtilization to 0.6 or 60%.



The minimum number of replicas that the autoscaler can scale in to. This cannot be less than 0. If not provided, autoscaler chooses a default value depending on maximum number of instances allowed.