Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-131,0021,0174.3 MB
regionInstanceGroupManagers

Apply updates to selected instances the managed instance group.

post/projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances

Path parameters

projectstring required

Project ID for this request.

regionstring required

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

instanceGroupManagerstring required

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

Request body

instancesstring[]

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 aszones/[ZONE]/instances/[INSTANCE_NAME].

minimalAction'NONE' | 'REFRESH' | 'REPLACE' | 'RESTART'

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'NONE' | 'REFRESH' | 'REPLACE' | 'RESTART'

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

 - REPLACE: 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.

allInstancesboolean

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

Successful response