InstanceGroupManagerClient (Google Cloud 0.119.0-alpha API)

java.lang.Object
- com.google.cloud.compute.v1.InstanceGroupManagerClient

All Implemented Interfaces:

com.google.api.gax.core.BackgroundResource, AutoCloseable
```
@Generated(value="by gapic-generator")
 @BetaApi
public class InstanceGroupManagerClient
extends Object
implements com.google.api.gax.core.BackgroundResource
```
Service Description: Creates and runs virtual machines on Google Cloud Platform.
This class provides the ability to make remote calls to the backing service through method calls that map to API methods. Sample code to get started:
```
 
 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersAbandonInstancesRequest instanceGroupManagersAbandonInstancesRequestResource = InstanceGroupManagersAbandonInstancesRequest.newBuilder().build();
   Operation response = instanceGroupManagerClient.abandonInstancesInstanceGroupManager(instanceGroupManager, instanceGroupManagersAbandonInstancesRequestResource);
 }
 
 
```
Note: close() needs to be called on the instanceGroupManagerClient object to clean up resources such as threads. In the example above, try-with-resources is used, which automatically calls close().
The surface of this class includes several types of Java methods for each of the API's methods:
1. A "flattened" method. With this type of method, the fields of the request type have been converted into function parameters. It may be the case that not all fields are available as parameters, and not every API method will have a flattened method entry point.
2. A "request object" method. This type of method only takes one parameter, a request object, which must be constructed before the call. Not every API method will have a request object method.
3. A "callable" method. This type of method takes no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.
See the individual methods for example code.
Many parameters require resource names to be formatted in a particular way. To assist with these names, this class includes a format method for each type of name, and additionally a parse method to extract the individual identifiers contained within names that are returned.
This class can be customized by passing in a custom instance of InstanceGroupManagerSettings to create(). For example:
To customize credentials:
```
 
 InstanceGroupManagerSettings instanceGroupManagerSettings =
     InstanceGroupManagerSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 InstanceGroupManagerClient instanceGroupManagerClient =
     InstanceGroupManagerClient.create(instanceGroupManagerSettings);
 
 
```
To customize the endpoint:
```
 
 InstanceGroupManagerSettings instanceGroupManagerSettings =
     InstanceGroupManagerSettings.newBuilder().setEndpoint(myEndpoint).build();
 InstanceGroupManagerClient instanceGroupManagerClient =
     InstanceGroupManagerClient.create(instanceGroupManagerSettings);
 
 
```

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`InstanceGroupManagerClient.AggregatedListInstanceGroupManagersFixedSizeCollection`
`static class`	`InstanceGroupManagerClient.AggregatedListInstanceGroupManagersPage`
`static class`	`InstanceGroupManagerClient.AggregatedListInstanceGroupManagersPagedResponse`
`static class`	`InstanceGroupManagerClient.ListInstanceGroupManagersFixedSizeCollection`
`static class`	`InstanceGroupManagerClient.ListInstanceGroupManagersPage`
`static class`	`InstanceGroupManagerClient.ListInstanceGroupManagersPagedResponse`

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`InstanceGroupManagerClient(InstanceGroupManagerSettings settings)` Constructs an instance of InstanceGroupManagerClient, using the given settings.
`protected`	`InstanceGroupManagerClient(InstanceGroupManagerStub stub)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Operation`	`abandonInstancesInstanceGroupManager(AbandonInstancesInstanceGroupManagerHttpRequest request)` Flags the specified instances to be removed from the managed instance group.
`Operation`	`abandonInstancesInstanceGroupManager(ProjectZoneInstanceGroupManagerName instanceGroupManager, InstanceGroupManagersAbandonInstancesRequest instanceGroupManagersAbandonInstancesRequestResource)` Flags the specified instances to be removed from the managed instance group.
`Operation`	`abandonInstancesInstanceGroupManager(String instanceGroupManager, InstanceGroupManagersAbandonInstancesRequest instanceGroupManagersAbandonInstancesRequestResource)` Flags the specified instances to be removed from the managed instance group.
`com.google.api.gax.rpc.UnaryCallable<AbandonInstancesInstanceGroupManagerHttpRequest,Operation>`	`abandonInstancesInstanceGroupManagerCallable()` Flags the specified instances to be removed from the managed instance group.
`InstanceGroupManagerClient.AggregatedListInstanceGroupManagersPagedResponse`	`aggregatedListInstanceGroupManagers(AggregatedListInstanceGroupManagersHttpRequest request)` Retrieves the list of managed instance groups and groups them by zone.
`InstanceGroupManagerClient.AggregatedListInstanceGroupManagersPagedResponse`	`aggregatedListInstanceGroupManagers(ProjectName project)` Retrieves the list of managed instance groups and groups them by zone.
`InstanceGroupManagerClient.AggregatedListInstanceGroupManagersPagedResponse`	`aggregatedListInstanceGroupManagers(String project)` Retrieves the list of managed instance groups and groups them by zone.
`com.google.api.gax.rpc.UnaryCallable<AggregatedListInstanceGroupManagersHttpRequest,InstanceGroupManagerAggregatedList>`	`aggregatedListInstanceGroupManagersCallable()` Retrieves the list of managed instance groups and groups them by zone.
`com.google.api.gax.rpc.UnaryCallable<AggregatedListInstanceGroupManagersHttpRequest,InstanceGroupManagerClient.AggregatedListInstanceGroupManagersPagedResponse>`	`aggregatedListInstanceGroupManagersPagedCallable()` Retrieves the list of managed instance groups and groups them by zone.
`boolean`	`awaitTermination(long duration, TimeUnit unit)`
`void`	`close()`
`static InstanceGroupManagerClient`	`create()` Constructs an instance of InstanceGroupManagerClient with default settings.
`static InstanceGroupManagerClient`	`create(InstanceGroupManagerSettings settings)` Constructs an instance of InstanceGroupManagerClient, using the given settings.
`static InstanceGroupManagerClient`	`create(InstanceGroupManagerStub stub)` Constructs an instance of InstanceGroupManagerClient, using the given stub for making calls.
`Operation`	`deleteInstanceGroupManager(DeleteInstanceGroupManagerHttpRequest request)` Deletes the specified managed instance group and all of the instances in that group.
`Operation`	`deleteInstanceGroupManager(ProjectZoneInstanceGroupManagerName instanceGroupManager)` Deletes the specified managed instance group and all of the instances in that group.
`Operation`	`deleteInstanceGroupManager(String instanceGroupManager)` Deletes the specified managed instance group and all of the instances in that group.
`com.google.api.gax.rpc.UnaryCallable<DeleteInstanceGroupManagerHttpRequest,Operation>`	`deleteInstanceGroupManagerCallable()` Deletes the specified managed instance group and all of the instances in that group.
`Operation`	`deleteInstancesInstanceGroupManager(DeleteInstancesInstanceGroupManagerHttpRequest request)` Flags the specified instances in the managed instance group for immediate deletion.
`Operation`	`deleteInstancesInstanceGroupManager(ProjectZoneInstanceGroupManagerName instanceGroupManager, InstanceGroupManagersDeleteInstancesRequest instanceGroupManagersDeleteInstancesRequestResource)` Flags the specified instances in the managed instance group for immediate deletion.
`Operation`	`deleteInstancesInstanceGroupManager(String instanceGroupManager, InstanceGroupManagersDeleteInstancesRequest instanceGroupManagersDeleteInstancesRequestResource)` Flags the specified instances in the managed instance group for immediate deletion.
`com.google.api.gax.rpc.UnaryCallable<DeleteInstancesInstanceGroupManagerHttpRequest,Operation>`	`deleteInstancesInstanceGroupManagerCallable()` Flags the specified instances in the managed instance group for immediate deletion.
`InstanceGroupManager`	`getInstanceGroupManager(GetInstanceGroupManagerHttpRequest request)` Returns all of the details about the specified managed instance group.
`InstanceGroupManager`	`getInstanceGroupManager(ProjectZoneInstanceGroupManagerName instanceGroupManager)` Returns all of the details about the specified managed instance group.
`InstanceGroupManager`	`getInstanceGroupManager(String instanceGroupManager)` Returns all of the details about the specified managed instance group.
`com.google.api.gax.rpc.UnaryCallable<GetInstanceGroupManagerHttpRequest,InstanceGroupManager>`	`getInstanceGroupManagerCallable()` Returns all of the details about the specified managed instance group.
`InstanceGroupManagerSettings`	`getSettings()`
`InstanceGroupManagerStub`	`getStub()`
`Operation`	`insertInstanceGroupManager(InsertInstanceGroupManagerHttpRequest request)` Creates a managed instance group using the information that you specify in the request.
`Operation`	`insertInstanceGroupManager(ProjectZoneName zone, InstanceGroupManager instanceGroupManagerResource)` Creates a managed instance group using the information that you specify in the request.
`Operation`	`insertInstanceGroupManager(String zone, InstanceGroupManager instanceGroupManagerResource)` Creates a managed instance group using the information that you specify in the request.
`com.google.api.gax.rpc.UnaryCallable<InsertInstanceGroupManagerHttpRequest,Operation>`	`insertInstanceGroupManagerCallable()` Creates a managed instance group using the information that you specify in the request.
`boolean`	`isShutdown()`
`boolean`	`isTerminated()`
`InstanceGroupManagerClient.ListInstanceGroupManagersPagedResponse`	`listInstanceGroupManagers(ListInstanceGroupManagersHttpRequest request)` Retrieves a list of managed instance groups that are contained within the specified project and zone.
`InstanceGroupManagerClient.ListInstanceGroupManagersPagedResponse`	`listInstanceGroupManagers(ProjectZoneName zone)` Retrieves a list of managed instance groups that are contained within the specified project and zone.
`InstanceGroupManagerClient.ListInstanceGroupManagersPagedResponse`	`listInstanceGroupManagers(String zone)` Retrieves a list of managed instance groups that are contained within the specified project and zone.
`com.google.api.gax.rpc.UnaryCallable<ListInstanceGroupManagersHttpRequest,InstanceGroupManagerList>`	`listInstanceGroupManagersCallable()` Retrieves a list of managed instance groups that are contained within the specified project and zone.
`com.google.api.gax.rpc.UnaryCallable<ListInstanceGroupManagersHttpRequest,InstanceGroupManagerClient.ListInstanceGroupManagersPagedResponse>`	`listInstanceGroupManagersPagedCallable()` Retrieves a list of managed instance groups that are contained within the specified project and zone.
`InstanceGroupManagersListManagedInstancesResponse`	`listManagedInstancesInstanceGroupManagers(ListManagedInstancesInstanceGroupManagersHttpRequest request)` Lists all of the instances in the managed instance group.
`InstanceGroupManagersListManagedInstancesResponse`	`listManagedInstancesInstanceGroupManagers(ProjectZoneInstanceGroupManagerName instanceGroupManager)` Lists all of the instances in the managed instance group.
`InstanceGroupManagersListManagedInstancesResponse`	`listManagedInstancesInstanceGroupManagers(String instanceGroupManager)` Lists all of the instances in the managed instance group.
`com.google.api.gax.rpc.UnaryCallable<ListManagedInstancesInstanceGroupManagersHttpRequest,InstanceGroupManagersListManagedInstancesResponse>`	`listManagedInstancesInstanceGroupManagersCallable()` Lists all of the instances in the managed instance group.
`Operation`	`patchInstanceGroupManager(PatchInstanceGroupManagerHttpRequest request)` Updates a managed instance group using the information that you specify in the request.
`Operation`	`patchInstanceGroupManager(ProjectZoneInstanceGroupManagerName instanceGroupManager, InstanceGroupManager instanceGroupManagerResource, List<String> fieldMask)` Updates a managed instance group using the information that you specify in the request.
`Operation`	`patchInstanceGroupManager(String instanceGroupManager, InstanceGroupManager instanceGroupManagerResource, List<String> fieldMask)` Updates a managed instance group using the information that you specify in the request.
`com.google.api.gax.rpc.UnaryCallable<PatchInstanceGroupManagerHttpRequest,Operation>`	`patchInstanceGroupManagerCallable()` Updates a managed instance group using the information that you specify in the request.
`Operation`	`recreateInstancesInstanceGroupManager(ProjectZoneInstanceGroupManagerName instanceGroupManager, InstanceGroupManagersRecreateInstancesRequest instanceGroupManagersRecreateInstancesRequestResource)` Flags the specified instances in the managed instance group to be immediately recreated.
`Operation`	`recreateInstancesInstanceGroupManager(RecreateInstancesInstanceGroupManagerHttpRequest request)` Flags the specified instances in the managed instance group to be immediately recreated.
`Operation`	`recreateInstancesInstanceGroupManager(String instanceGroupManager, InstanceGroupManagersRecreateInstancesRequest instanceGroupManagersRecreateInstancesRequestResource)` Flags the specified instances in the managed instance group to be immediately recreated.
`com.google.api.gax.rpc.UnaryCallable<RecreateInstancesInstanceGroupManagerHttpRequest,Operation>`	`recreateInstancesInstanceGroupManagerCallable()` Flags the specified instances in the managed instance group to be immediately recreated.
`Operation`	`resizeInstanceGroupManager(Integer size, ProjectZoneInstanceGroupManagerName instanceGroupManager)` Resizes the managed instance group.
`Operation`	`resizeInstanceGroupManager(Integer size, String instanceGroupManager)` Resizes the managed instance group.
`Operation`	`resizeInstanceGroupManager(ResizeInstanceGroupManagerHttpRequest request)` Resizes the managed instance group.
`com.google.api.gax.rpc.UnaryCallable<ResizeInstanceGroupManagerHttpRequest,Operation>`	`resizeInstanceGroupManagerCallable()` Resizes the managed instance group.
`Operation`	`setInstanceTemplateInstanceGroupManager(ProjectZoneInstanceGroupManagerName instanceGroupManager, InstanceGroupManagersSetInstanceTemplateRequest instanceGroupManagersSetInstanceTemplateRequestResource)` Specifies the instance template to use when creating new instances in this group.
`Operation`	`setInstanceTemplateInstanceGroupManager(SetInstanceTemplateInstanceGroupManagerHttpRequest request)` Specifies the instance template to use when creating new instances in this group.
`Operation`	`setInstanceTemplateInstanceGroupManager(String instanceGroupManager, InstanceGroupManagersSetInstanceTemplateRequest instanceGroupManagersSetInstanceTemplateRequestResource)` Specifies the instance template to use when creating new instances in this group.
`com.google.api.gax.rpc.UnaryCallable<SetInstanceTemplateInstanceGroupManagerHttpRequest,Operation>`	`setInstanceTemplateInstanceGroupManagerCallable()` Specifies the instance template to use when creating new instances in this group.
`Operation`	`setTargetPoolsInstanceGroupManager(ProjectZoneInstanceGroupManagerName instanceGroupManager, InstanceGroupManagersSetTargetPoolsRequest instanceGroupManagersSetTargetPoolsRequestResource)` Modifies the target pools to which all instances in this managed instance group are assigned.
`Operation`	`setTargetPoolsInstanceGroupManager(SetTargetPoolsInstanceGroupManagerHttpRequest request)` Modifies the target pools to which all instances in this managed instance group are assigned.
`Operation`	`setTargetPoolsInstanceGroupManager(String instanceGroupManager, InstanceGroupManagersSetTargetPoolsRequest instanceGroupManagersSetTargetPoolsRequestResource)` Modifies the target pools to which all instances in this managed instance group are assigned.
`com.google.api.gax.rpc.UnaryCallable<SetTargetPoolsInstanceGroupManagerHttpRequest,Operation>`	`setTargetPoolsInstanceGroupManagerCallable()` Modifies the target pools to which all instances in this managed instance group are assigned.
`void`	`shutdown()`
`void`	`shutdownNow()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

InstanceGroupManagerClient
```
protected InstanceGroupManagerClient(InstanceGroupManagerSettings settings)
                              throws IOException
```
Constructs an instance of InstanceGroupManagerClient, using the given settings. This is protected so that it is easy to make a subclass, but otherwise, the static factory methods should be preferred.

Throws:

IOException

InstanceGroupManagerClient

@BetaApi(value="A restructuring of stub classes is planned, so this may break in the future")
protected InstanceGroupManagerClient(InstanceGroupManagerStub stub)

Method Detail

create

public static final InstanceGroupManagerClient create()
                                               throws IOException

Constructs an instance of InstanceGroupManagerClient with default settings.

Throws:: IOException

create
```
public static final InstanceGroupManagerClient create(InstanceGroupManagerSettings settings)
                                               throws IOException
```
Constructs an instance of InstanceGroupManagerClient, using the given settings. The channels are created based on the settings passed in, or defaults for any settings that are not set.

Throws:

IOException

create

@BetaApi(value="A restructuring of stub classes is planned, so this may break in the future")
public static final InstanceGroupManagerClient create(InstanceGroupManagerStub stub)

Constructs an instance of InstanceGroupManagerClient, using the given stub for making calls. This is for advanced usage - prefer to use InstanceGroupManagerSettings}.

getSettings

public final InstanceGroupManagerSettings getSettings()

getStub

@BetaApi(value="A restructuring of stub classes is planned, so this may break in the future")
public InstanceGroupManagerStub getStub()

abandonInstancesInstanceGroupManager
```
@BetaApi
public final Operation abandonInstancesInstanceGroupManager(ProjectZoneInstanceGroupManagerName instanceGroupManager,
                                                                     InstanceGroupManagersAbandonInstancesRequest instanceGroupManagersAbandonInstancesRequestResource)
```
Flags the specified instances to be removed from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method.
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 removed or deleted.
You can specify a maximum of 1000 instances with this method per request.
Sample code:
```
 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersAbandonInstancesRequest instanceGroupManagersAbandonInstancesRequestResource = InstanceGroupManagersAbandonInstancesRequest.newBuilder().build();
   Operation response = instanceGroupManagerClient.abandonInstancesInstanceGroupManager(instanceGroupManager, instanceGroupManagersAbandonInstancesRequestResource);
 }
 
```
Parameters:

instanceGroupManager - The name of the managed instance group.

instanceGroupManagersAbandonInstancesRequestResource -

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

abandonInstancesInstanceGroupManager
```
@BetaApi
public final Operation abandonInstancesInstanceGroupManager(String instanceGroupManager,
                                                                     InstanceGroupManagersAbandonInstancesRequest instanceGroupManagersAbandonInstancesRequestResource)
```
Flags the specified instances to be removed from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method.
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 removed or deleted.
You can specify a maximum of 1000 instances with this method per request.
Sample code:
```
 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersAbandonInstancesRequest instanceGroupManagersAbandonInstancesRequestResource = InstanceGroupManagersAbandonInstancesRequest.newBuilder().build();
   Operation response = instanceGroupManagerClient.abandonInstancesInstanceGroupManager(instanceGroupManager.toString(), instanceGroupManagersAbandonInstancesRequestResource);
 }
 
```
Parameters:

instanceGroupManager - The name of the managed instance group.

instanceGroupManagersAbandonInstancesRequestResource -

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

abandonInstancesInstanceGroupManager
```
@BetaApi
public final Operation abandonInstancesInstanceGroupManager(AbandonInstancesInstanceGroupManagerHttpRequest request)
```
Flags the specified instances to be removed from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method.
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 removed or deleted.
You can specify a maximum of 1000 instances with this method per request.
Sample code:
```
 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersAbandonInstancesRequest instanceGroupManagersAbandonInstancesRequestResource = InstanceGroupManagersAbandonInstancesRequest.newBuilder().build();
   AbandonInstancesInstanceGroupManagerHttpRequest request = AbandonInstancesInstanceGroupManagerHttpRequest.newBuilder()
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .setInstanceGroupManagersAbandonInstancesRequestResource(instanceGroupManagersAbandonInstancesRequestResource)
     .build();
   Operation response = instanceGroupManagerClient.abandonInstancesInstanceGroupManager(request);
 }
 
```
Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

abandonInstancesInstanceGroupManagerCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<AbandonInstancesInstanceGroupManagerHttpRequest,Operation> abandonInstancesInstanceGroupManagerCallable()

Flags the specified instances to be removed from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method.

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 removed or deleted.

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

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersAbandonInstancesRequest instanceGroupManagersAbandonInstancesRequestResource = InstanceGroupManagersAbandonInstancesRequest.newBuilder().build();
   AbandonInstancesInstanceGroupManagerHttpRequest request = AbandonInstancesInstanceGroupManagerHttpRequest.newBuilder()
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .setInstanceGroupManagersAbandonInstancesRequestResource(instanceGroupManagersAbandonInstancesRequestResource)
     .build();
   ApiFuture<Operation> future = instanceGroupManagerClient.abandonInstancesInstanceGroupManagerCallable().futureCall(request);
   // Do something
   Operation response = future.get();
 }

aggregatedListInstanceGroupManagers

@BetaApi
public final InstanceGroupManagerClient.AggregatedListInstanceGroupManagersPagedResponse aggregatedListInstanceGroupManagers(ProjectName project)

Retrieves the list of managed instance groups and groups them by zone.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectName project = ProjectName.of("[PROJECT]");
   for (InstanceGroupManagersScopedList element : instanceGroupManagerClient.aggregatedListInstanceGroupManagers(project).iterateAll()) {
     // doThingsWith(element);
   }
 }

Parameters:: project - Project ID for this request.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

aggregatedListInstanceGroupManagers

@BetaApi
public final InstanceGroupManagerClient.AggregatedListInstanceGroupManagersPagedResponse aggregatedListInstanceGroupManagers(String project)

Retrieves the list of managed instance groups and groups them by zone.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectName project = ProjectName.of("[PROJECT]");
   for (InstanceGroupManagersScopedList element : instanceGroupManagerClient.aggregatedListInstanceGroupManagers(project.toString()).iterateAll()) {
     // doThingsWith(element);
   }
 }

Parameters:: project - Project ID for this request.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

aggregatedListInstanceGroupManagers

@BetaApi
public final InstanceGroupManagerClient.AggregatedListInstanceGroupManagersPagedResponse aggregatedListInstanceGroupManagers(AggregatedListInstanceGroupManagersHttpRequest request)

Retrieves the list of managed instance groups and groups them by zone.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedProject = ProjectName.format("[PROJECT]");
   AggregatedListInstanceGroupManagersHttpRequest request = AggregatedListInstanceGroupManagersHttpRequest.newBuilder()
     .setProject(formattedProject)
     .build();
   for (InstanceGroupManagersScopedList element : instanceGroupManagerClient.aggregatedListInstanceGroupManagers(request).iterateAll()) {
     // doThingsWith(element);
   }
 }

Parameters:: request - The request object containing all of the parameters for the API call.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

aggregatedListInstanceGroupManagersPagedCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<AggregatedListInstanceGroupManagersHttpRequest,InstanceGroupManagerClient.AggregatedListInstanceGroupManagersPagedResponse> aggregatedListInstanceGroupManagersPagedCallable()

Retrieves the list of managed instance groups and groups them by zone.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedProject = ProjectName.format("[PROJECT]");
   AggregatedListInstanceGroupManagersHttpRequest request = AggregatedListInstanceGroupManagersHttpRequest.newBuilder()
     .setProject(formattedProject)
     .build();
   ApiFuture<AggregatedListInstanceGroupManagersPagedResponse> future = instanceGroupManagerClient.aggregatedListInstanceGroupManagersPagedCallable().futureCall(request);
   // Do something
   for (InstanceGroupManagersScopedList element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }

aggregatedListInstanceGroupManagersCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<AggregatedListInstanceGroupManagersHttpRequest,InstanceGroupManagerAggregatedList> aggregatedListInstanceGroupManagersCallable()

Retrieves the list of managed instance groups and groups them by zone.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedProject = ProjectName.format("[PROJECT]");
   AggregatedListInstanceGroupManagersHttpRequest request = AggregatedListInstanceGroupManagersHttpRequest.newBuilder()
     .setProject(formattedProject)
     .build();
   while (true) {
     InstanceGroupManagerAggregatedList response = instanceGroupManagerClient.aggregatedListInstanceGroupManagersCallable().call(request);
     for (InstanceGroupManagersScopedList element : response.getItemsMap()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }

deleteInstanceGroupManager

@BetaApi
public final Operation deleteInstanceGroupManager(ProjectZoneInstanceGroupManagerName instanceGroupManager)

Deletes the specified managed instance group and all of the instances in that group. Note that the instance group must not belong to a backend service. Read Deleting an instance group for more information.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   Operation response = instanceGroupManagerClient.deleteInstanceGroupManager(instanceGroupManager);
 }

Parameters:: instanceGroupManager - The name of the managed instance group to delete.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

deleteInstanceGroupManager

@BetaApi
public final Operation deleteInstanceGroupManager(String instanceGroupManager)

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   Operation response = instanceGroupManagerClient.deleteInstanceGroupManager(instanceGroupManager.toString());
 }

Parameters:: instanceGroupManager - The name of the managed instance group to delete.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

deleteInstanceGroupManager

@BetaApi
public final Operation deleteInstanceGroupManager(DeleteInstanceGroupManagerHttpRequest request)

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   DeleteInstanceGroupManagerHttpRequest request = DeleteInstanceGroupManagerHttpRequest.newBuilder()
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .build();
   Operation response = instanceGroupManagerClient.deleteInstanceGroupManager(request);
 }

Parameters:: request - The request object containing all of the parameters for the API call.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

deleteInstanceGroupManagerCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<DeleteInstanceGroupManagerHttpRequest,Operation> deleteInstanceGroupManagerCallable()

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   DeleteInstanceGroupManagerHttpRequest request = DeleteInstanceGroupManagerHttpRequest.newBuilder()
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .build();
   ApiFuture<Operation> future = instanceGroupManagerClient.deleteInstanceGroupManagerCallable().futureCall(request);
   // Do something
   Operation response = future.get();
 }

deleteInstancesInstanceGroupManager
```
@BetaApi
public final Operation deleteInstancesInstanceGroupManager(ProjectZoneInstanceGroupManagerName instanceGroupManager,
                                                                    InstanceGroupManagersDeleteInstancesRequest instanceGroupManagersDeleteInstancesRequestResource)
```
Flags the specified instances in the managed instance group for immediate deletion. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. This operation is marked as DONE when the action is scheduled even if the instances are still being deleted. You must separately verify the status of the deleting action with the listmanagedinstances method.
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 removed or deleted.
You can specify a maximum of 1000 instances with this method per request.
Sample code:
```
 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersDeleteInstancesRequest instanceGroupManagersDeleteInstancesRequestResource = InstanceGroupManagersDeleteInstancesRequest.newBuilder().build();
   Operation response = instanceGroupManagerClient.deleteInstancesInstanceGroupManager(instanceGroupManager, instanceGroupManagersDeleteInstancesRequestResource);
 }
 
```
Parameters:

instanceGroupManager - The name of the managed instance group.

instanceGroupManagersDeleteInstancesRequestResource -

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

deleteInstancesInstanceGroupManager
```
@BetaApi
public final Operation deleteInstancesInstanceGroupManager(String instanceGroupManager,
                                                                    InstanceGroupManagersDeleteInstancesRequest instanceGroupManagersDeleteInstancesRequestResource)
```
Flags the specified instances in the managed instance group for immediate deletion. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. This operation is marked as DONE when the action is scheduled even if the instances are still being deleted. You must separately verify the status of the deleting action with the listmanagedinstances method.
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 removed or deleted.
You can specify a maximum of 1000 instances with this method per request.
Sample code:
```
 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersDeleteInstancesRequest instanceGroupManagersDeleteInstancesRequestResource = InstanceGroupManagersDeleteInstancesRequest.newBuilder().build();
   Operation response = instanceGroupManagerClient.deleteInstancesInstanceGroupManager(instanceGroupManager.toString(), instanceGroupManagersDeleteInstancesRequestResource);
 }
 
```
Parameters:

instanceGroupManager - The name of the managed instance group.

instanceGroupManagersDeleteInstancesRequestResource -

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

deleteInstancesInstanceGroupManager
```
@BetaApi
public final Operation deleteInstancesInstanceGroupManager(DeleteInstancesInstanceGroupManagerHttpRequest request)
```
Flags the specified instances in the managed instance group for immediate deletion. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. This operation is marked as DONE when the action is scheduled even if the instances are still being deleted. You must separately verify the status of the deleting action with the listmanagedinstances method.
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 removed or deleted.
You can specify a maximum of 1000 instances with this method per request.
Sample code:
```
 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersDeleteInstancesRequest instanceGroupManagersDeleteInstancesRequestResource = InstanceGroupManagersDeleteInstancesRequest.newBuilder().build();
   DeleteInstancesInstanceGroupManagerHttpRequest request = DeleteInstancesInstanceGroupManagerHttpRequest.newBuilder()
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .setInstanceGroupManagersDeleteInstancesRequestResource(instanceGroupManagersDeleteInstancesRequestResource)
     .build();
   Operation response = instanceGroupManagerClient.deleteInstancesInstanceGroupManager(request);
 }
 
```
Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

deleteInstancesInstanceGroupManagerCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<DeleteInstancesInstanceGroupManagerHttpRequest,Operation> deleteInstancesInstanceGroupManagerCallable()

Flags the specified instances in the managed instance group for immediate deletion. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. This operation is marked as DONE when the action is scheduled even if the instances are still being deleted. You must separately verify the status of the deleting action with the listmanagedinstances method.

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

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersDeleteInstancesRequest instanceGroupManagersDeleteInstancesRequestResource = InstanceGroupManagersDeleteInstancesRequest.newBuilder().build();
   DeleteInstancesInstanceGroupManagerHttpRequest request = DeleteInstancesInstanceGroupManagerHttpRequest.newBuilder()
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .setInstanceGroupManagersDeleteInstancesRequestResource(instanceGroupManagersDeleteInstancesRequestResource)
     .build();
   ApiFuture<Operation> future = instanceGroupManagerClient.deleteInstancesInstanceGroupManagerCallable().futureCall(request);
   // Do something
   Operation response = future.get();
 }

getInstanceGroupManager

@BetaApi
public final InstanceGroupManager getInstanceGroupManager(ProjectZoneInstanceGroupManagerName instanceGroupManager)

Returns all of the details about the specified managed instance group. Gets a list of available managed instance groups by making a list() request.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManager response = instanceGroupManagerClient.getInstanceGroupManager(instanceGroupManager);
 }

Parameters:: instanceGroupManager - The name of the managed instance group.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

getInstanceGroupManager

@BetaApi
public final InstanceGroupManager getInstanceGroupManager(String instanceGroupManager)

Returns all of the details about the specified managed instance group. Gets a list of available managed instance groups by making a list() request.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManager response = instanceGroupManagerClient.getInstanceGroupManager(instanceGroupManager.toString());
 }

Parameters:: instanceGroupManager - The name of the managed instance group.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

getInstanceGroupManager

@BetaApi
public final InstanceGroupManager getInstanceGroupManager(GetInstanceGroupManagerHttpRequest request)

Returns all of the details about the specified managed instance group. Gets a list of available managed instance groups by making a list() request.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   GetInstanceGroupManagerHttpRequest request = GetInstanceGroupManagerHttpRequest.newBuilder()
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .build();
   InstanceGroupManager response = instanceGroupManagerClient.getInstanceGroupManager(request);
 }

Parameters:: request - The request object containing all of the parameters for the API call.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

getInstanceGroupManagerCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<GetInstanceGroupManagerHttpRequest,InstanceGroupManager> getInstanceGroupManagerCallable()

Returns all of the details about the specified managed instance group. Gets a list of available managed instance groups by making a list() request.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   GetInstanceGroupManagerHttpRequest request = GetInstanceGroupManagerHttpRequest.newBuilder()
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .build();
   ApiFuture<InstanceGroupManager> future = instanceGroupManagerClient.getInstanceGroupManagerCallable().futureCall(request);
   // Do something
   InstanceGroupManager response = future.get();
 }

insertInstanceGroupManager
```
@BetaApi
public final Operation insertInstanceGroupManager(ProjectZoneName zone,
                                                           InstanceGroupManager instanceGroupManagerResource)
```
Creates a managed instance group using the information that you specify in the request. After the group is created, instances in the group are created using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method.
A managed instance group can have up to 1000 VM instances per group. Please contact Cloud Support if you need an increase in this limit.
Sample code:
```
 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneName zone = ProjectZoneName.of("[PROJECT]", "[ZONE]");
   InstanceGroupManager instanceGroupManagerResource = InstanceGroupManager.newBuilder().build();
   Operation response = instanceGroupManagerClient.insertInstanceGroupManager(zone, instanceGroupManagerResource);
 }
 
```
Parameters:

zone - The name of the zone where you want to create the managed instance group.

instanceGroupManagerResource - Represents a Managed Instance Group resource.
An instance group is a collection of VM instances that you can manage as a single entity. For more information, read Instance groups.
For zonal Managed Instance Group, use the instanceGroupManagers resource.
For regional Managed Instance Group, use the regionInstanceGroupManagers resource. (== resource_for beta.instanceGroupManagers ==) (== resource_for v1.instanceGroupManagers ==) (== resource_for beta.regionInstanceGroupManagers ==) (== resource_for v1.regionInstanceGroupManagers ==)

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

insertInstanceGroupManager
```
@BetaApi
public final Operation insertInstanceGroupManager(String zone,
                                                           InstanceGroupManager instanceGroupManagerResource)
```
Creates a managed instance group using the information that you specify in the request. After the group is created, instances in the group are created using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method.
A managed instance group can have up to 1000 VM instances per group. Please contact Cloud Support if you need an increase in this limit.
Sample code:
```
 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneName zone = ProjectZoneName.of("[PROJECT]", "[ZONE]");
   InstanceGroupManager instanceGroupManagerResource = InstanceGroupManager.newBuilder().build();
   Operation response = instanceGroupManagerClient.insertInstanceGroupManager(zone.toString(), instanceGroupManagerResource);
 }
 
```
Parameters:

zone - The name of the zone where you want to create the managed instance group.

instanceGroupManagerResource - Represents a Managed Instance Group resource.
An instance group is a collection of VM instances that you can manage as a single entity. For more information, read Instance groups.
For zonal Managed Instance Group, use the instanceGroupManagers resource.
For regional Managed Instance Group, use the regionInstanceGroupManagers resource. (== resource_for beta.instanceGroupManagers ==) (== resource_for v1.instanceGroupManagers ==) (== resource_for beta.regionInstanceGroupManagers ==) (== resource_for v1.regionInstanceGroupManagers ==)

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

insertInstanceGroupManager
```
@BetaApi
public final Operation insertInstanceGroupManager(InsertInstanceGroupManagerHttpRequest request)
```
Creates a managed instance group using the information that you specify in the request. After the group is created, instances in the group are created using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method.
A managed instance group can have up to 1000 VM instances per group. Please contact Cloud Support if you need an increase in this limit.
Sample code:
```
 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedZone = ProjectZoneName.format("[PROJECT]", "[ZONE]");
   InstanceGroupManager instanceGroupManagerResource = InstanceGroupManager.newBuilder().build();
   InsertInstanceGroupManagerHttpRequest request = InsertInstanceGroupManagerHttpRequest.newBuilder()
     .setZone(formattedZone)
     .setInstanceGroupManagerResource(instanceGroupManagerResource)
     .build();
   Operation response = instanceGroupManagerClient.insertInstanceGroupManager(request);
 }
 
```
Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

insertInstanceGroupManagerCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<InsertInstanceGroupManagerHttpRequest,Operation> insertInstanceGroupManagerCallable()

Creates a managed instance group using the information that you specify in the request. After the group is created, instances in the group are created using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method.

A managed instance group can have up to 1000 VM instances per group. Please contact Cloud Support if you need an increase in this limit.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedZone = ProjectZoneName.format("[PROJECT]", "[ZONE]");
   InstanceGroupManager instanceGroupManagerResource = InstanceGroupManager.newBuilder().build();
   InsertInstanceGroupManagerHttpRequest request = InsertInstanceGroupManagerHttpRequest.newBuilder()
     .setZone(formattedZone)
     .setInstanceGroupManagerResource(instanceGroupManagerResource)
     .build();
   ApiFuture<Operation> future = instanceGroupManagerClient.insertInstanceGroupManagerCallable().futureCall(request);
   // Do something
   Operation response = future.get();
 }

listInstanceGroupManagers

@BetaApi
public final InstanceGroupManagerClient.ListInstanceGroupManagersPagedResponse listInstanceGroupManagers(ProjectZoneName zone)

Retrieves a list of managed instance groups that are contained within the specified project and zone.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneName zone = ProjectZoneName.of("[PROJECT]", "[ZONE]");
   for (InstanceGroupManager element : instanceGroupManagerClient.listInstanceGroupManagers(zone).iterateAll()) {
     // doThingsWith(element);
   }
 }

Parameters:: zone - The name of the zone where the managed instance group is located.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

listInstanceGroupManagers

@BetaApi
public final InstanceGroupManagerClient.ListInstanceGroupManagersPagedResponse listInstanceGroupManagers(String zone)

Retrieves a list of managed instance groups that are contained within the specified project and zone.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneName zone = ProjectZoneName.of("[PROJECT]", "[ZONE]");
   for (InstanceGroupManager element : instanceGroupManagerClient.listInstanceGroupManagers(zone.toString()).iterateAll()) {
     // doThingsWith(element);
   }
 }

Parameters:: zone - The name of the zone where the managed instance group is located.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

listInstanceGroupManagers

@BetaApi
public final InstanceGroupManagerClient.ListInstanceGroupManagersPagedResponse listInstanceGroupManagers(ListInstanceGroupManagersHttpRequest request)

Retrieves a list of managed instance groups that are contained within the specified project and zone.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedZone = ProjectZoneName.format("[PROJECT]", "[ZONE]");
   ListInstanceGroupManagersHttpRequest request = ListInstanceGroupManagersHttpRequest.newBuilder()
     .setZone(formattedZone)
     .build();
   for (InstanceGroupManager element : instanceGroupManagerClient.listInstanceGroupManagers(request).iterateAll()) {
     // doThingsWith(element);
   }
 }

Parameters:: request - The request object containing all of the parameters for the API call.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

listInstanceGroupManagersPagedCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<ListInstanceGroupManagersHttpRequest,InstanceGroupManagerClient.ListInstanceGroupManagersPagedResponse> listInstanceGroupManagersPagedCallable()

Retrieves a list of managed instance groups that are contained within the specified project and zone.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedZone = ProjectZoneName.format("[PROJECT]", "[ZONE]");
   ListInstanceGroupManagersHttpRequest request = ListInstanceGroupManagersHttpRequest.newBuilder()
     .setZone(formattedZone)
     .build();
   ApiFuture<ListInstanceGroupManagersPagedResponse> future = instanceGroupManagerClient.listInstanceGroupManagersPagedCallable().futureCall(request);
   // Do something
   for (InstanceGroupManager element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }

listInstanceGroupManagersCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<ListInstanceGroupManagersHttpRequest,InstanceGroupManagerList> listInstanceGroupManagersCallable()

Retrieves a list of managed instance groups that are contained within the specified project and zone.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedZone = ProjectZoneName.format("[PROJECT]", "[ZONE]");
   ListInstanceGroupManagersHttpRequest request = ListInstanceGroupManagersHttpRequest.newBuilder()
     .setZone(formattedZone)
     .build();
   while (true) {
     InstanceGroupManagerList response = instanceGroupManagerClient.listInstanceGroupManagersCallable().call(request);
     for (InstanceGroupManager element : response.getItemsList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }

listManagedInstancesInstanceGroupManagers

@BetaApi
public final InstanceGroupManagersListManagedInstancesResponse listManagedInstancesInstanceGroupManagers(ProjectZoneInstanceGroupManagerName instanceGroupManager)

Lists all of the instances in the managed instance group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is CREATING. If a previous action failed, the list displays the errors for that failed action.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersListManagedInstancesResponse response = instanceGroupManagerClient.listManagedInstancesInstanceGroupManagers(instanceGroupManager);
 }

Parameters:: instanceGroupManager - The name of the managed instance group.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

listManagedInstancesInstanceGroupManagers

@BetaApi
public final InstanceGroupManagersListManagedInstancesResponse listManagedInstancesInstanceGroupManagers(String instanceGroupManager)

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersListManagedInstancesResponse response = instanceGroupManagerClient.listManagedInstancesInstanceGroupManagers(instanceGroupManager.toString());
 }

Parameters:: instanceGroupManager - The name of the managed instance group.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

listManagedInstancesInstanceGroupManagers

@BetaApi
public final InstanceGroupManagersListManagedInstancesResponse listManagedInstancesInstanceGroupManagers(ListManagedInstancesInstanceGroupManagersHttpRequest request)

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   ListManagedInstancesInstanceGroupManagersHttpRequest request = ListManagedInstancesInstanceGroupManagersHttpRequest.newBuilder()
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .build();
   InstanceGroupManagersListManagedInstancesResponse response = instanceGroupManagerClient.listManagedInstancesInstanceGroupManagers(request);
 }

Parameters:: request - The request object containing all of the parameters for the API call.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

listManagedInstancesInstanceGroupManagersCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<ListManagedInstancesInstanceGroupManagersHttpRequest,InstanceGroupManagersListManagedInstancesResponse> listManagedInstancesInstanceGroupManagersCallable()

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   ListManagedInstancesInstanceGroupManagersHttpRequest request = ListManagedInstancesInstanceGroupManagersHttpRequest.newBuilder()
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .build();
   ApiFuture<InstanceGroupManagersListManagedInstancesResponse> future = instanceGroupManagerClient.listManagedInstancesInstanceGroupManagersCallable().futureCall(request);
   // Do something
   InstanceGroupManagersListManagedInstancesResponse response = future.get();
 }

patchInstanceGroupManager
```
@BetaApi
public final Operation patchInstanceGroupManager(ProjectZoneInstanceGroupManagerName instanceGroupManager,
                                                          InstanceGroupManager instanceGroupManagerResource,
                                                          List<String> fieldMask)
```
Updates a managed instance group using the information that you specify in the request. This operation is marked as DONE when the group is patched even if the instances in the group are still in the process of being patched. You must separately verify the status of the individual instances with the listManagedInstances method. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
Sample code:
```
 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManager instanceGroupManagerResource = InstanceGroupManager.newBuilder().build();
   List<String> fieldMask = new ArrayList<>();
   Operation response = instanceGroupManagerClient.patchInstanceGroupManager(instanceGroupManager, instanceGroupManagerResource, fieldMask);
 }
 
```
Parameters:

instanceGroupManager - The name of the instance group manager.

instanceGroupManagerResource - Represents a Managed Instance Group resource.
An instance group is a collection of VM instances that you can manage as a single entity. For more information, read Instance groups.
For zonal Managed Instance Group, use the instanceGroupManagers resource.
For regional Managed Instance Group, use the regionInstanceGroupManagers resource. (== resource_for beta.instanceGroupManagers ==) (== resource_for v1.instanceGroupManagers ==) (== resource_for beta.regionInstanceGroupManagers ==) (== resource_for v1.regionInstanceGroupManagers ==)

fieldMask - The fields that should be serialized (even if they have empty values). If the containing message object has a non-null fieldmask, then all the fields in the field mask (and only those fields in the field mask) will be serialized. If the containing object does not have a fieldmask, then only non-empty fields will be serialized.

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

patchInstanceGroupManager
```
@BetaApi
public final Operation patchInstanceGroupManager(String instanceGroupManager,
                                                          InstanceGroupManager instanceGroupManagerResource,
                                                          List<String> fieldMask)
```
Updates a managed instance group using the information that you specify in the request. This operation is marked as DONE when the group is patched even if the instances in the group are still in the process of being patched. You must separately verify the status of the individual instances with the listManagedInstances method. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
Sample code:
```
 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManager instanceGroupManagerResource = InstanceGroupManager.newBuilder().build();
   List<String> fieldMask = new ArrayList<>();
   Operation response = instanceGroupManagerClient.patchInstanceGroupManager(instanceGroupManager.toString(), instanceGroupManagerResource, fieldMask);
 }
 
```
Parameters:

instanceGroupManager - The name of the instance group manager.

instanceGroupManagerResource - Represents a Managed Instance Group resource.
An instance group is a collection of VM instances that you can manage as a single entity. For more information, read Instance groups.
For zonal Managed Instance Group, use the instanceGroupManagers resource.
For regional Managed Instance Group, use the regionInstanceGroupManagers resource. (== resource_for beta.instanceGroupManagers ==) (== resource_for v1.instanceGroupManagers ==) (== resource_for beta.regionInstanceGroupManagers ==) (== resource_for v1.regionInstanceGroupManagers ==)

fieldMask - The fields that should be serialized (even if they have empty values). If the containing message object has a non-null fieldmask, then all the fields in the field mask (and only those fields in the field mask) will be serialized. If the containing object does not have a fieldmask, then only non-empty fields will be serialized.

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

patchInstanceGroupManager

@BetaApi
public final Operation patchInstanceGroupManager(PatchInstanceGroupManagerHttpRequest request)

Updates a managed instance group using the information that you specify in the request. This operation is marked as DONE when the group is patched even if the instances in the group are still in the process of being patched. You must separately verify the status of the individual instances with the listManagedInstances method. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManager instanceGroupManagerResource = InstanceGroupManager.newBuilder().build();
   List<String> fieldMask = new ArrayList<>();
   PatchInstanceGroupManagerHttpRequest request = PatchInstanceGroupManagerHttpRequest.newBuilder()
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .setInstanceGroupManagerResource(instanceGroupManagerResource)
     .addAllFieldMask(fieldMask)
     .build();
   Operation response = instanceGroupManagerClient.patchInstanceGroupManager(request);
 }

Parameters:: request - The request object containing all of the parameters for the API call.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

patchInstanceGroupManagerCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<PatchInstanceGroupManagerHttpRequest,Operation> patchInstanceGroupManagerCallable()

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManager instanceGroupManagerResource = InstanceGroupManager.newBuilder().build();
   List<String> fieldMask = new ArrayList<>();
   PatchInstanceGroupManagerHttpRequest request = PatchInstanceGroupManagerHttpRequest.newBuilder()
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .setInstanceGroupManagerResource(instanceGroupManagerResource)
     .addAllFieldMask(fieldMask)
     .build();
   ApiFuture<Operation> future = instanceGroupManagerClient.patchInstanceGroupManagerCallable().futureCall(request);
   // Do something
   Operation response = future.get();
 }

recreateInstancesInstanceGroupManager

@BetaApi
public final Operation recreateInstancesInstanceGroupManager(ProjectZoneInstanceGroupManagerName instanceGroupManager,
                                                                      InstanceGroupManagersRecreateInstancesRequest instanceGroupManagersRecreateInstancesRequestResource)

Flags the specified instances in the managed instance group to be immediately recreated. The instances are deleted and recreated using the current instance template for the managed instance group. This operation is marked as DONE when the flag is set even if the instances have not yet been recreated. You must separately verify the status of the recreating action with the listmanagedinstances method.

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

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersRecreateInstancesRequest instanceGroupManagersRecreateInstancesRequestResource = InstanceGroupManagersRecreateInstancesRequest.newBuilder().build();
   Operation response = instanceGroupManagerClient.recreateInstancesInstanceGroupManager(instanceGroupManager, instanceGroupManagersRecreateInstancesRequestResource);
 }

Parameters:: instanceGroupManager - The name of the managed instance group.; instanceGroupManagersRecreateInstancesRequestResource -
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

recreateInstancesInstanceGroupManager

@BetaApi
public final Operation recreateInstancesInstanceGroupManager(String instanceGroupManager,
                                                                      InstanceGroupManagersRecreateInstancesRequest instanceGroupManagersRecreateInstancesRequestResource)

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

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersRecreateInstancesRequest instanceGroupManagersRecreateInstancesRequestResource = InstanceGroupManagersRecreateInstancesRequest.newBuilder().build();
   Operation response = instanceGroupManagerClient.recreateInstancesInstanceGroupManager(instanceGroupManager.toString(), instanceGroupManagersRecreateInstancesRequestResource);
 }

Parameters:: instanceGroupManager - The name of the managed instance group.; instanceGroupManagersRecreateInstancesRequestResource -
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

recreateInstancesInstanceGroupManager

@BetaApi
public final Operation recreateInstancesInstanceGroupManager(RecreateInstancesInstanceGroupManagerHttpRequest request)

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

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersRecreateInstancesRequest instanceGroupManagersRecreateInstancesRequestResource = InstanceGroupManagersRecreateInstancesRequest.newBuilder().build();
   RecreateInstancesInstanceGroupManagerHttpRequest request = RecreateInstancesInstanceGroupManagerHttpRequest.newBuilder()
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .setInstanceGroupManagersRecreateInstancesRequestResource(instanceGroupManagersRecreateInstancesRequestResource)
     .build();
   Operation response = instanceGroupManagerClient.recreateInstancesInstanceGroupManager(request);
 }

Parameters:: request - The request object containing all of the parameters for the API call.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

recreateInstancesInstanceGroupManagerCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<RecreateInstancesInstanceGroupManagerHttpRequest,Operation> recreateInstancesInstanceGroupManagerCallable()

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

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersRecreateInstancesRequest instanceGroupManagersRecreateInstancesRequestResource = InstanceGroupManagersRecreateInstancesRequest.newBuilder().build();
   RecreateInstancesInstanceGroupManagerHttpRequest request = RecreateInstancesInstanceGroupManagerHttpRequest.newBuilder()
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .setInstanceGroupManagersRecreateInstancesRequestResource(instanceGroupManagersRecreateInstancesRequestResource)
     .build();
   ApiFuture<Operation> future = instanceGroupManagerClient.recreateInstancesInstanceGroupManagerCallable().futureCall(request);
   // Do something
   Operation response = future.get();
 }

resizeInstanceGroupManager
```
@BetaApi
public final Operation resizeInstanceGroupManager(Integer size,
                                                           ProjectZoneInstanceGroupManagerName instanceGroupManager)
```
Resizes the managed instance group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes instances. The resize operation is marked DONE when the resize actions are scheduled even if the group has not yet added or deleted any instances. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method.
When resizing down, the instance group arbitrarily chooses the order in which VMs are deleted. The group takes into account some VM attributes when making the selection including:
+ The status of the VM instance. + The health of the VM instance. + The instance template version the VM is based on. + For regional managed instance groups, the location of the VM instance.
This list is subject to change.
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 removed or deleted.
Sample code:
```
 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   Integer size = 0;
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   Operation response = instanceGroupManagerClient.resizeInstanceGroupManager(size, instanceGroupManager);
 }
 
```
Parameters:

size - The number of running instances that the managed instance group should maintain at any given time. The group automatically adds or removes instances to maintain the number of instances specified by this parameter.

instanceGroupManager - The name of the managed instance group.

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

resizeInstanceGroupManager
```
@BetaApi
public final Operation resizeInstanceGroupManager(Integer size,
                                                           String instanceGroupManager)
```
Resizes the managed instance group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes instances. The resize operation is marked DONE when the resize actions are scheduled even if the group has not yet added or deleted any instances. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method.
When resizing down, the instance group arbitrarily chooses the order in which VMs are deleted. The group takes into account some VM attributes when making the selection including:
+ The status of the VM instance. + The health of the VM instance. + The instance template version the VM is based on. + For regional managed instance groups, the location of the VM instance.
This list is subject to change.
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 removed or deleted.
Sample code:
```
 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   Integer size = 0;
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   Operation response = instanceGroupManagerClient.resizeInstanceGroupManager(size, instanceGroupManager.toString());
 }
 
```
Parameters:

size - The number of running instances that the managed instance group should maintain at any given time. The group automatically adds or removes instances to maintain the number of instances specified by this parameter.

instanceGroupManager - The name of the managed instance group.

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

resizeInstanceGroupManager
```
@BetaApi
public final Operation resizeInstanceGroupManager(ResizeInstanceGroupManagerHttpRequest request)
```
Resizes the managed instance group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes instances. The resize operation is marked DONE when the resize actions are scheduled even if the group has not yet added or deleted any instances. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method.
When resizing down, the instance group arbitrarily chooses the order in which VMs are deleted. The group takes into account some VM attributes when making the selection including:
+ The status of the VM instance. + The health of the VM instance. + The instance template version the VM is based on. + For regional managed instance groups, the location of the VM instance.
This list is subject to change.
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 removed or deleted.
Sample code:
```
 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   Integer size = 0;
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   ResizeInstanceGroupManagerHttpRequest request = ResizeInstanceGroupManagerHttpRequest.newBuilder()
     .setSize(size)
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .build();
   Operation response = instanceGroupManagerClient.resizeInstanceGroupManager(request);
 }
 
```
Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

com.google.api.gax.rpc.ApiException - if the remote call fails

resizeInstanceGroupManagerCallable
```
@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<ResizeInstanceGroupManagerHttpRequest,Operation> resizeInstanceGroupManagerCallable()
```
Resizes the managed instance group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes instances. The resize operation is marked DONE when the resize actions are scheduled even if the group has not yet added or deleted any instances. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method.
When resizing down, the instance group arbitrarily chooses the order in which VMs are deleted. The group takes into account some VM attributes when making the selection including:
+ The status of the VM instance. + The health of the VM instance. + The instance template version the VM is based on. + For regional managed instance groups, the location of the VM instance.
This list is subject to change.
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 removed or deleted.
Sample code:
```
 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   Integer size = 0;
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   ResizeInstanceGroupManagerHttpRequest request = ResizeInstanceGroupManagerHttpRequest.newBuilder()
     .setSize(size)
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .build();
   ApiFuture<Operation> future = instanceGroupManagerClient.resizeInstanceGroupManagerCallable().futureCall(request);
   // Do something
   Operation response = future.get();
 }
 
```

setInstanceTemplateInstanceGroupManager

@BetaApi
public final Operation setInstanceTemplateInstanceGroupManager(ProjectZoneInstanceGroupManagerName instanceGroupManager,
                                                                        InstanceGroupManagersSetInstanceTemplateRequest instanceGroupManagersSetInstanceTemplateRequestResource)

Specifies the instance template to use when creating new instances in this group. The templates for existing instances in the group do not change unless you recreate them.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersSetInstanceTemplateRequest instanceGroupManagersSetInstanceTemplateRequestResource = InstanceGroupManagersSetInstanceTemplateRequest.newBuilder().build();
   Operation response = instanceGroupManagerClient.setInstanceTemplateInstanceGroupManager(instanceGroupManager, instanceGroupManagersSetInstanceTemplateRequestResource);
 }

Parameters:: instanceGroupManager - The name of the managed instance group.; instanceGroupManagersSetInstanceTemplateRequestResource -
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

setInstanceTemplateInstanceGroupManager

@BetaApi
public final Operation setInstanceTemplateInstanceGroupManager(String instanceGroupManager,
                                                                        InstanceGroupManagersSetInstanceTemplateRequest instanceGroupManagersSetInstanceTemplateRequestResource)

Specifies the instance template to use when creating new instances in this group. The templates for existing instances in the group do not change unless you recreate them.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersSetInstanceTemplateRequest instanceGroupManagersSetInstanceTemplateRequestResource = InstanceGroupManagersSetInstanceTemplateRequest.newBuilder().build();
   Operation response = instanceGroupManagerClient.setInstanceTemplateInstanceGroupManager(instanceGroupManager.toString(), instanceGroupManagersSetInstanceTemplateRequestResource);
 }

Parameters:: instanceGroupManager - The name of the managed instance group.; instanceGroupManagersSetInstanceTemplateRequestResource -
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

setInstanceTemplateInstanceGroupManager

@BetaApi
public final Operation setInstanceTemplateInstanceGroupManager(SetInstanceTemplateInstanceGroupManagerHttpRequest request)

Specifies the instance template to use when creating new instances in this group. The templates for existing instances in the group do not change unless you recreate them.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersSetInstanceTemplateRequest instanceGroupManagersSetInstanceTemplateRequestResource = InstanceGroupManagersSetInstanceTemplateRequest.newBuilder().build();
   SetInstanceTemplateInstanceGroupManagerHttpRequest request = SetInstanceTemplateInstanceGroupManagerHttpRequest.newBuilder()
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .setInstanceGroupManagersSetInstanceTemplateRequestResource(instanceGroupManagersSetInstanceTemplateRequestResource)
     .build();
   Operation response = instanceGroupManagerClient.setInstanceTemplateInstanceGroupManager(request);
 }

Parameters:: request - The request object containing all of the parameters for the API call.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

setInstanceTemplateInstanceGroupManagerCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<SetInstanceTemplateInstanceGroupManagerHttpRequest,Operation> setInstanceTemplateInstanceGroupManagerCallable()

Specifies the instance template to use when creating new instances in this group. The templates for existing instances in the group do not change unless you recreate them.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersSetInstanceTemplateRequest instanceGroupManagersSetInstanceTemplateRequestResource = InstanceGroupManagersSetInstanceTemplateRequest.newBuilder().build();
   SetInstanceTemplateInstanceGroupManagerHttpRequest request = SetInstanceTemplateInstanceGroupManagerHttpRequest.newBuilder()
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .setInstanceGroupManagersSetInstanceTemplateRequestResource(instanceGroupManagersSetInstanceTemplateRequestResource)
     .build();
   ApiFuture<Operation> future = instanceGroupManagerClient.setInstanceTemplateInstanceGroupManagerCallable().futureCall(request);
   // Do something
   Operation response = future.get();
 }

setTargetPoolsInstanceGroupManager

@BetaApi
public final Operation setTargetPoolsInstanceGroupManager(ProjectZoneInstanceGroupManagerName instanceGroupManager,
                                                                   InstanceGroupManagersSetTargetPoolsRequest instanceGroupManagersSetTargetPoolsRequestResource)

Modifies the target pools to which all instances in this managed instance group are assigned. The target pools automatically apply to all of the instances in the managed instance group. This operation is marked DONE when you make the request even if the instances have not yet been added to their target pools. The change might take some time to apply to all of the instances in the group depending on the size of the group.

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersSetTargetPoolsRequest instanceGroupManagersSetTargetPoolsRequestResource = InstanceGroupManagersSetTargetPoolsRequest.newBuilder().build();
   Operation response = instanceGroupManagerClient.setTargetPoolsInstanceGroupManager(instanceGroupManager, instanceGroupManagersSetTargetPoolsRequestResource);
 }

Parameters:: instanceGroupManager - The name of the managed instance group.; instanceGroupManagersSetTargetPoolsRequestResource -
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

setTargetPoolsInstanceGroupManager

@BetaApi
public final Operation setTargetPoolsInstanceGroupManager(String instanceGroupManager,
                                                                   InstanceGroupManagersSetTargetPoolsRequest instanceGroupManagersSetTargetPoolsRequestResource)

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   ProjectZoneInstanceGroupManagerName instanceGroupManager = ProjectZoneInstanceGroupManagerName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersSetTargetPoolsRequest instanceGroupManagersSetTargetPoolsRequestResource = InstanceGroupManagersSetTargetPoolsRequest.newBuilder().build();
   Operation response = instanceGroupManagerClient.setTargetPoolsInstanceGroupManager(instanceGroupManager.toString(), instanceGroupManagersSetTargetPoolsRequestResource);
 }

Parameters:: instanceGroupManager - The name of the managed instance group.; instanceGroupManagersSetTargetPoolsRequestResource -
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

setTargetPoolsInstanceGroupManager

@BetaApi
public final Operation setTargetPoolsInstanceGroupManager(SetTargetPoolsInstanceGroupManagerHttpRequest request)

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersSetTargetPoolsRequest instanceGroupManagersSetTargetPoolsRequestResource = InstanceGroupManagersSetTargetPoolsRequest.newBuilder().build();
   SetTargetPoolsInstanceGroupManagerHttpRequest request = SetTargetPoolsInstanceGroupManagerHttpRequest.newBuilder()
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .setInstanceGroupManagersSetTargetPoolsRequestResource(instanceGroupManagersSetTargetPoolsRequestResource)
     .build();
   Operation response = instanceGroupManagerClient.setTargetPoolsInstanceGroupManager(request);
 }

Parameters:: request - The request object containing all of the parameters for the API call.
Throws:: com.google.api.gax.rpc.ApiException - if the remote call fails

setTargetPoolsInstanceGroupManagerCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<SetTargetPoolsInstanceGroupManagerHttpRequest,Operation> setTargetPoolsInstanceGroupManagerCallable()

Sample code:


 try (InstanceGroupManagerClient instanceGroupManagerClient = InstanceGroupManagerClient.create()) {
   String formattedInstanceGroupManager = ProjectZoneInstanceGroupManagerName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP_MANAGER]");
   InstanceGroupManagersSetTargetPoolsRequest instanceGroupManagersSetTargetPoolsRequestResource = InstanceGroupManagersSetTargetPoolsRequest.newBuilder().build();
   SetTargetPoolsInstanceGroupManagerHttpRequest request = SetTargetPoolsInstanceGroupManagerHttpRequest.newBuilder()
     .setInstanceGroupManager(formattedInstanceGroupManager)
     .setInstanceGroupManagersSetTargetPoolsRequestResource(instanceGroupManagersSetTargetPoolsRequestResource)
     .build();
   ApiFuture<Operation> future = instanceGroupManagerClient.setTargetPoolsInstanceGroupManagerCallable().futureCall(request);
   // Do something
   Operation response = future.get();
 }

close
```
public final void close()
```
Specified by:

close in interface AutoCloseable

shutdown
```
public void shutdown()
```
Specified by:

shutdown in interface com.google.api.gax.core.BackgroundResource

isShutdown
```
public boolean isShutdown()
```
Specified by:

isShutdown in interface com.google.api.gax.core.BackgroundResource

isTerminated
```
public boolean isTerminated()
```
Specified by:

isTerminated in interface com.google.api.gax.core.BackgroundResource

shutdownNow
```
public void shutdownNow()
```
Specified by:

shutdownNow in interface com.google.api.gax.core.BackgroundResource

awaitTermination

public boolean awaitTermination(long duration,
                                TimeUnit unit)
                         throws InterruptedException

Specified by:: awaitTermination in interface com.google.api.gax.core.BackgroundResource
Throws:: InterruptedException

Class InstanceGroupManagerClient

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

InstanceGroupManagerClient

InstanceGroupManagerClient

Method Detail

create

create

create

getSettings

getStub

abandonInstancesInstanceGroupManager

abandonInstancesInstanceGroupManager

abandonInstancesInstanceGroupManager

abandonInstancesInstanceGroupManagerCallable

aggregatedListInstanceGroupManagers

aggregatedListInstanceGroupManagers

aggregatedListInstanceGroupManagers

aggregatedListInstanceGroupManagersPagedCallable

aggregatedListInstanceGroupManagersCallable

deleteInstanceGroupManager

deleteInstanceGroupManager

deleteInstanceGroupManager

deleteInstanceGroupManagerCallable

deleteInstancesInstanceGroupManager

deleteInstancesInstanceGroupManager

deleteInstancesInstanceGroupManager

deleteInstancesInstanceGroupManagerCallable

getInstanceGroupManager

getInstanceGroupManager

getInstanceGroupManager

getInstanceGroupManagerCallable

insertInstanceGroupManager

insertInstanceGroupManager

insertInstanceGroupManager

insertInstanceGroupManagerCallable

listInstanceGroupManagers

listInstanceGroupManagers

listInstanceGroupManagers

listInstanceGroupManagersPagedCallable

listInstanceGroupManagersCallable

listManagedInstancesInstanceGroupManagers

listManagedInstancesInstanceGroupManagers

listManagedInstancesInstanceGroupManagers

listManagedInstancesInstanceGroupManagersCallable

patchInstanceGroupManager

patchInstanceGroupManager

patchInstanceGroupManager

patchInstanceGroupManagerCallable

recreateInstancesInstanceGroupManager

recreateInstancesInstanceGroupManager

recreateInstancesInstanceGroupManager

recreateInstancesInstanceGroupManagerCallable

resizeInstanceGroupManager

resizeInstanceGroupManager

resizeInstanceGroupManager

resizeInstanceGroupManagerCallable

setInstanceTemplateInstanceGroupManager

setInstanceTemplateInstanceGroupManager

setInstanceTemplateInstanceGroupManager

setInstanceTemplateInstanceGroupManagerCallable

setTargetPoolsInstanceGroupManager

setTargetPoolsInstanceGroupManager

setTargetPoolsInstanceGroupManager

setTargetPoolsInstanceGroupManagerCallable

close

shutdown

isShutdown

isTerminated

shutdownNow

awaitTermination