---
title: "POST /projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/suspendInstances"
method: POST
path: "/projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/suspendInstances"
tags: ["regionInstanceGroupManagers"]
---

# POST /projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/suspendInstances

`POST /projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/suspendInstances`

Flags the specified instances in the managed instance group to be
immediately suspended. You can only specify instances that are running in
this request. This method reduces thetargetSize and increases the targetSuspendedSize
of the managed instance group by the number of instances that you suspend.
The suspendInstances operation is marked DONE if
the suspendInstances request is successful. The underlying
actions take additional time. You must separately verify the status of theSUSPENDING action with thelistmanagedinstances
method.

If the standbyPolicy.initialDelaySec field is set, the group
delays suspension of the instances until initialDelaySec have
passed from instance.creationTimestamp (that is, when the
instance was created). This delay gives your application time to
set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there
will be zero delay.

If the group is part of a backend
service that has enabled
connection draining, it can take up to 60 seconds after the connection
draining duration has elapsed before the VM instance is suspended.

Suspended instances can be resumed using the resumeInstances
method.

You can specify a maximum of 1000 instances with this method per request.

## Path parameters

- `project` string, required
- `region` string, required
- `instanceGroupManager` string, required

## Query parameters

- `requestId` string

## Request body

- RegionInstanceGroupManagersSuspendInstancesRequest
  - `instances` string[] — The URLs of one or more instances to suspend. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
  - `forceSuspend` boolean — If this flag is set to true, the Instance Group Manager will proceed to suspend the instances, skipping initialization on them.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/compute.md) · [All operations](https://skmtc.net/google/apis/compute/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/compute/revisions/6120ed8969d4/schema)
