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
}
Fields
id

string (uint64 format)

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

creationTimestamp

string

[Output Only] Creation timestamp in RFC3339 text format.

name

string

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.

description

string

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

target

string

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

autoscalingPolicy

object

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%.

autoscalingPolicy.minNumReplicas

integer

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.

autoscalingPolicy.maxNumReplicas