Method: regionAutoscalers.get

Returns the specified autoscaler.

HTTP request

GET https://compute.googleapis.com/compute/v1/projects/{project}/regions/{region}/autoscalers/{resourceId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
project

string

Project ID for this request.

region

string

Name of the region scoping this request.

resourceId

string

Name of the autoscaler to return.

Authorization requires the following IAM permission on the specified resource autoscaler:

  • compute.autoscalers.get

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

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 RFC