Method: regionInstanceGroupManagers.applyUpdatesToInstances

Apply updates to selected instances the managed instance group.

HTTP request


POST https://compute.s3nsapis.fr/compute/v1/projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances

The URLs use gRPC Transcoding syntax.

Path parameters

Parameters
project

string

Project ID for this request.
region

string

Name of the region scoping this request, should conform to RFC1035.
instanceGroupManager

string

The name of the managed instance group, should conform to RFC1035.

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

  • compute.instanceGroupManagers.update

Request body

The request body contains data with the following structure:

JSON representation 
{
  "instances": [
    string
  ],
  "minimalAction": enum (InstanceAction),
  "mostDisruptiveAllowedAction": enum (InstanceAction),
  "allInstances": boolean
}
Fields
instances[]

string

The list of URLs of one or more instances for which you want to apply updates. Each URL can be a full URL or a partial URL, such as

zones/[ZONE]/instances/[INSTANCE_NAME]

.
minimalAction

enum (InstanceAction)

The minimal action that you want to perform on each instance during the update:

  • REPLACE

    : At minimum, delete the instance and create it again.

  • RESTART

    : Stop the instance and start it again.

  • REFRESH

    : Do not stop the instance and limit disruption as much as possible.

  • NONE

    : Do not disrupt the instance at all.

By default, the minimum action is

NONE

. If your update requires a more disruptive action than you set with this flag, the necessary action is performed to execute the update.
mostDisruptiveAllowedAction

enum (InstanceAction)

The most disruptive action that you want to perform on each instance during the update:

  • REPLACE

    : regionInstanceGroupManagers.delete the instance and create it again.

  • RESTART

    : Stop the instance and start it again.

  • REFRESH

    : Do not stop the instance and limit disruption as much as possible.

  • NONE

    : Do not disrupt the instance at all.

By default, the most disruptive allowed action is

REPLACE

. If your update requires a more disruptive action than you set with this flag, the update request will fail.
allInstances

boolean

Flag to update all instances instead of specified list of "instances". If the flag is set to true then the instances may not be specified in the request.

Response body

If successful, the response body contains an instance of Operation.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/compute
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.