com.google.cloud.compute.v1

Class InstanceGroupClient

java.lang.Object

com.google.cloud.compute.v1.InstanceGroupClient

All Implemented Interfaces:

com.google.api.gax.core.BackgroundResource, AutoCloseable

@Generated(value="by gapic-generator")
 @BetaApi
public class InstanceGroupClient
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 (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectZoneInstanceGroupName instanceGroup = ProjectZoneInstanceGroupName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroupsAddInstancesRequest instanceGroupsAddInstancesRequestResource = InstanceGroupsAddInstancesRequest.newBuilder().build();
   Operation response = instanceGroupClient.addInstancesInstanceGroup(instanceGroup, instanceGroupsAddInstancesRequestResource);
 }
 
 

Note: close() needs to be called on the instanceGroupClient 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 InstanceGroupSettings to create(). For example:

To customize credentials:

 
 InstanceGroupSettings instanceGroupSettings =
     InstanceGroupSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 InstanceGroupClient instanceGroupClient =
     InstanceGroupClient.create(instanceGroupSettings);
 
 

To customize the endpoint:

 
 InstanceGroupSettings instanceGroupSettings =
     InstanceGroupSettings.newBuilder().setEndpoint(myEndpoint).build();
 InstanceGroupClient instanceGroupClient =
     InstanceGroupClient.create(instanceGroupSettings);
 
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	InstanceGroupClient.AggregatedListInstanceGroupsFixedSizeCollection
static class	InstanceGroupClient.AggregatedListInstanceGroupsPage
static class	InstanceGroupClient.AggregatedListInstanceGroupsPagedResponse
static class	InstanceGroupClient.ListInstanceGroupsFixedSizeCollection
static class	InstanceGroupClient.ListInstanceGroupsPage
static class	InstanceGroupClient.ListInstanceGroupsPagedResponse
static class	InstanceGroupClient.ListInstancesInstanceGroupsFixedSizeCollection
static class	InstanceGroupClient.ListInstancesInstanceGroupsPage
static class	InstanceGroupClient.ListInstancesInstanceGroupsPagedResponse

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	InstanceGroupClient(InstanceGroupSettings settings) Constructs an instance of InstanceGroupClient, using the given settings.
protected	InstanceGroupClient(InstanceGroupStub stub)

Method Summary

Modifier and Type	Method and Description
Operation	addInstancesInstanceGroup(AddInstancesInstanceGroupHttpRequest request) Adds a list of instances to the specified instance group.
Operation	addInstancesInstanceGroup(ProjectZoneInstanceGroupName instanceGroup, InstanceGroupsAddInstancesRequest instanceGroupsAddInstancesRequestResource) Adds a list of instances to the specified instance group.
Operation	addInstancesInstanceGroup(String instanceGroup, InstanceGroupsAddInstancesRequest instanceGroupsAddInstancesRequestResource) Adds a list of instances to the specified instance group.
com.google.api.gax.rpc.UnaryCallable<AddInstancesInstanceGroupHttpRequest,Operation>	addInstancesInstanceGroupCallable() Adds a list of instances to the specified instance group.
InstanceGroupClient.AggregatedListInstanceGroupsPagedResponse	aggregatedListInstanceGroups(AggregatedListInstanceGroupsHttpRequest request) Retrieves the list of instance groups and sorts them by zone.
InstanceGroupClient.AggregatedListInstanceGroupsPagedResponse	aggregatedListInstanceGroups(ProjectName project) Retrieves the list of instance groups and sorts them by zone.
InstanceGroupClient.AggregatedListInstanceGroupsPagedResponse	aggregatedListInstanceGroups(String project) Retrieves the list of instance groups and sorts them by zone.
com.google.api.gax.rpc.UnaryCallable<AggregatedListInstanceGroupsHttpRequest,InstanceGroupAggregatedList>	aggregatedListInstanceGroupsCallable() Retrieves the list of instance groups and sorts them by zone.
com.google.api.gax.rpc.UnaryCallable<AggregatedListInstanceGroupsHttpRequest,InstanceGroupClient.AggregatedListInstanceGroupsPagedResponse>	aggregatedListInstanceGroupsPagedCallable() Retrieves the list of instance groups and sorts them by zone.
boolean	awaitTermination(long duration, TimeUnit unit)
void	close()
static InstanceGroupClient	create() Constructs an instance of InstanceGroupClient with default settings.
static InstanceGroupClient	create(InstanceGroupSettings settings) Constructs an instance of InstanceGroupClient, using the given settings.
static InstanceGroupClient	create(InstanceGroupStub stub) Constructs an instance of InstanceGroupClient, using the given stub for making calls.
Operation	deleteInstanceGroup(DeleteInstanceGroupHttpRequest request) Deletes the specified instance group.
Operation	deleteInstanceGroup(ProjectZoneInstanceGroupName instanceGroup) Deletes the specified instance group.
Operation	deleteInstanceGroup(String instanceGroup) Deletes the specified instance group.
com.google.api.gax.rpc.UnaryCallable<DeleteInstanceGroupHttpRequest,Operation>	deleteInstanceGroupCallable() Deletes the specified instance group.
InstanceGroup	getInstanceGroup(GetInstanceGroupHttpRequest request) Returns the specified instance group.
InstanceGroup	getInstanceGroup(ProjectZoneInstanceGroupName instanceGroup) Returns the specified instance group.
InstanceGroup	getInstanceGroup(String instanceGroup) Returns the specified instance group.
com.google.api.gax.rpc.UnaryCallable<GetInstanceGroupHttpRequest,InstanceGroup>	getInstanceGroupCallable() Returns the specified instance group.
InstanceGroupSettings	getSettings()
InstanceGroupStub	getStub()
Operation	insertInstanceGroup(InsertInstanceGroupHttpRequest request) Creates an instance group in the specified project using the parameters that are included in the request.
Operation	insertInstanceGroup(ProjectZoneName zone, InstanceGroup instanceGroupResource) Creates an instance group in the specified project using the parameters that are included in the request.
Operation	insertInstanceGroup(String zone, InstanceGroup instanceGroupResource) Creates an instance group in the specified project using the parameters that are included in the request.
com.google.api.gax.rpc.UnaryCallable<InsertInstanceGroupHttpRequest,Operation>	insertInstanceGroupCallable() Creates an instance group in the specified project using the parameters that are included in the request.
boolean	isShutdown()
boolean	isTerminated()
InstanceGroupClient.ListInstanceGroupsPagedResponse	listInstanceGroups(ListInstanceGroupsHttpRequest request) Retrieves the list of instance groups that are located in the specified project and zone.
InstanceGroupClient.ListInstanceGroupsPagedResponse	listInstanceGroups(ProjectZoneName zone) Retrieves the list of instance groups that are located in the specified project and zone.
InstanceGroupClient.ListInstanceGroupsPagedResponse	listInstanceGroups(String zone) Retrieves the list of instance groups that are located in the specified project and zone.
com.google.api.gax.rpc.UnaryCallable<ListInstanceGroupsHttpRequest,InstanceGroupList>	listInstanceGroupsCallable() Retrieves the list of instance groups that are located in the specified project and zone.
com.google.api.gax.rpc.UnaryCallable<ListInstanceGroupsHttpRequest,InstanceGroupClient.ListInstanceGroupsPagedResponse>	listInstanceGroupsPagedCallable() Retrieves the list of instance groups that are located in the specified project and zone.
InstanceGroupClient.ListInstancesInstanceGroupsPagedResponse	listInstancesInstanceGroups(ListInstancesInstanceGroupsHttpRequest request) Lists the instances in the specified instance group.
InstanceGroupClient.ListInstancesInstanceGroupsPagedResponse	listInstancesInstanceGroups(ProjectZoneInstanceGroupName instanceGroup, InstanceGroupsListInstancesRequest instanceGroupsListInstancesRequestResource) Lists the instances in the specified instance group.
InstanceGroupClient.ListInstancesInstanceGroupsPagedResponse	listInstancesInstanceGroups(String instanceGroup, InstanceGroupsListInstancesRequest instanceGroupsListInstancesRequestResource) Lists the instances in the specified instance group.
com.google.api.gax.rpc.UnaryCallable<ListInstancesInstanceGroupsHttpRequest,InstanceGroupsListInstances>	listInstancesInstanceGroupsCallable() Lists the instances in the specified instance group.
com.google.api.gax.rpc.UnaryCallable<ListInstancesInstanceGroupsHttpRequest,InstanceGroupClient.ListInstancesInstanceGroupsPagedResponse>	listInstancesInstanceGroupsPagedCallable() Lists the instances in the specified instance group.
Operation	removeInstancesInstanceGroup(ProjectZoneInstanceGroupName instanceGroup, InstanceGroupsRemoveInstancesRequest instanceGroupsRemoveInstancesRequestResource) Removes one or more instances from the specified instance group, but does not delete those instances.
Operation	removeInstancesInstanceGroup(RemoveInstancesInstanceGroupHttpRequest request) Removes one or more instances from the specified instance group, but does not delete those instances.
Operation	removeInstancesInstanceGroup(String instanceGroup, InstanceGroupsRemoveInstancesRequest instanceGroupsRemoveInstancesRequestResource) Removes one or more instances from the specified instance group, but does not delete those instances.
com.google.api.gax.rpc.UnaryCallable<RemoveInstancesInstanceGroupHttpRequest,Operation>	removeInstancesInstanceGroupCallable() Removes one or more instances from the specified instance group, but does not delete those instances.
Operation	setNamedPortsInstanceGroup(ProjectZoneInstanceGroupName instanceGroup, InstanceGroupsSetNamedPortsRequest instanceGroupsSetNamedPortsRequestResource) Sets the named ports for the specified instance group.
Operation	setNamedPortsInstanceGroup(SetNamedPortsInstanceGroupHttpRequest request) Sets the named ports for the specified instance group.
Operation	setNamedPortsInstanceGroup(String instanceGroup, InstanceGroupsSetNamedPortsRequest instanceGroupsSetNamedPortsRequestResource) Sets the named ports for the specified instance group.
com.google.api.gax.rpc.UnaryCallable<SetNamedPortsInstanceGroupHttpRequest,Operation>	setNamedPortsInstanceGroupCallable() Sets the named ports for the specified instance group.
void	shutdown()
void	shutdownNow()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

InstanceGroupClient

protected InstanceGroupClient(InstanceGroupSettings settings)
                       throws IOException

Constructs an instance of InstanceGroupClient, 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

InstanceGroupClient

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

Method Detail

create

public static final InstanceGroupClient create()
                                        throws IOException

Constructs an instance of InstanceGroupClient with default settings.

Throws:

IOException

create

public static final InstanceGroupClient create(InstanceGroupSettings settings)
                                        throws IOException

Constructs an instance of InstanceGroupClient, 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 InstanceGroupClient create(InstanceGroupStub stub)

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

getSettings

public final InstanceGroupSettings getSettings()

getStub

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

addInstancesInstanceGroup

@BetaApi
public final Operation addInstancesInstanceGroup(ProjectZoneInstanceGroupName instanceGroup,
                                                          InstanceGroupsAddInstancesRequest instanceGroupsAddInstancesRequestResource)

Adds a list of instances to the specified instance group. All of the instances in the instance group must be in the same network/subnetwork. Read Adding instances for more information.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectZoneInstanceGroupName instanceGroup = ProjectZoneInstanceGroupName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroupsAddInstancesRequest instanceGroupsAddInstancesRequestResource = InstanceGroupsAddInstancesRequest.newBuilder().build();
   Operation response = instanceGroupClient.addInstancesInstanceGroup(instanceGroup, instanceGroupsAddInstancesRequestResource);
 }
 

Parameters:

instanceGroup - The name of the instance group where you are adding instances.

instanceGroupsAddInstancesRequestResource -

Throws:

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

addInstancesInstanceGroup

@BetaApi
public final Operation addInstancesInstanceGroup(String instanceGroup,
                                                          InstanceGroupsAddInstancesRequest instanceGroupsAddInstancesRequestResource)

Adds a list of instances to the specified instance group. All of the instances in the instance group must be in the same network/subnetwork. Read Adding instances for more information.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectZoneInstanceGroupName instanceGroup = ProjectZoneInstanceGroupName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroupsAddInstancesRequest instanceGroupsAddInstancesRequestResource = InstanceGroupsAddInstancesRequest.newBuilder().build();
   Operation response = instanceGroupClient.addInstancesInstanceGroup(instanceGroup.toString(), instanceGroupsAddInstancesRequestResource);
 }
 

Parameters:

instanceGroup - The name of the instance group where you are adding instances.

instanceGroupsAddInstancesRequestResource -

Throws:

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

addInstancesInstanceGroup

@BetaApi
public final Operation addInstancesInstanceGroup(AddInstancesInstanceGroupHttpRequest request)

Adds a list of instances to the specified instance group. All of the instances in the instance group must be in the same network/subnetwork. Read Adding instances for more information.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedInstanceGroup = ProjectZoneInstanceGroupName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroupsAddInstancesRequest instanceGroupsAddInstancesRequestResource = InstanceGroupsAddInstancesRequest.newBuilder().build();
   AddInstancesInstanceGroupHttpRequest request = AddInstancesInstanceGroupHttpRequest.newBuilder()
     .setInstanceGroup(formattedInstanceGroup)
     .setInstanceGroupsAddInstancesRequestResource(instanceGroupsAddInstancesRequestResource)
     .build();
   Operation response = instanceGroupClient.addInstancesInstanceGroup(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

addInstancesInstanceGroupCallable

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

Adds a list of instances to the specified instance group. All of the instances in the instance group must be in the same network/subnetwork. Read Adding instances for more information.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedInstanceGroup = ProjectZoneInstanceGroupName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroupsAddInstancesRequest instanceGroupsAddInstancesRequestResource = InstanceGroupsAddInstancesRequest.newBuilder().build();
   AddInstancesInstanceGroupHttpRequest request = AddInstancesInstanceGroupHttpRequest.newBuilder()
     .setInstanceGroup(formattedInstanceGroup)
     .setInstanceGroupsAddInstancesRequestResource(instanceGroupsAddInstancesRequestResource)
     .build();
   ApiFuture<Operation> future = instanceGroupClient.addInstancesInstanceGroupCallable().futureCall(request);
   // Do something
   Operation response = future.get();
 }
 

aggregatedListInstanceGroups

@BetaApi
public final InstanceGroupClient.AggregatedListInstanceGroupsPagedResponse aggregatedListInstanceGroups(ProjectName project)

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

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectName project = ProjectName.of("[PROJECT]");
   for (InstanceGroupsScopedList element : instanceGroupClient.aggregatedListInstanceGroups(project).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters:

project - Project ID for this request.

Throws:

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

aggregatedListInstanceGroups

@BetaApi
public final InstanceGroupClient.AggregatedListInstanceGroupsPagedResponse aggregatedListInstanceGroups(String project)

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

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectName project = ProjectName.of("[PROJECT]");
   for (InstanceGroupsScopedList element : instanceGroupClient.aggregatedListInstanceGroups(project.toString()).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters:

project - Project ID for this request.

Throws:

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

aggregatedListInstanceGroups

@BetaApi
public final InstanceGroupClient.AggregatedListInstanceGroupsPagedResponse aggregatedListInstanceGroups(AggregatedListInstanceGroupsHttpRequest request)

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

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedProject = ProjectName.format("[PROJECT]");
   AggregatedListInstanceGroupsHttpRequest request = AggregatedListInstanceGroupsHttpRequest.newBuilder()
     .setProject(formattedProject)
     .build();
   for (InstanceGroupsScopedList element : instanceGroupClient.aggregatedListInstanceGroups(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

aggregatedListInstanceGroupsPagedCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<AggregatedListInstanceGroupsHttpRequest,InstanceGroupClient.AggregatedListInstanceGroupsPagedResponse> aggregatedListInstanceGroupsPagedCallable()

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

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedProject = ProjectName.format("[PROJECT]");
   AggregatedListInstanceGroupsHttpRequest request = AggregatedListInstanceGroupsHttpRequest.newBuilder()
     .setProject(formattedProject)
     .build();
   ApiFuture<AggregatedListInstanceGroupsPagedResponse> future = instanceGroupClient.aggregatedListInstanceGroupsPagedCallable().futureCall(request);
   // Do something
   for (InstanceGroupsScopedList element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }
 

aggregatedListInstanceGroupsCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<AggregatedListInstanceGroupsHttpRequest,InstanceGroupAggregatedList> aggregatedListInstanceGroupsCallable()

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

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedProject = ProjectName.format("[PROJECT]");
   AggregatedListInstanceGroupsHttpRequest request = AggregatedListInstanceGroupsHttpRequest.newBuilder()
     .setProject(formattedProject)
     .build();
   while (true) {
     InstanceGroupAggregatedList response = instanceGroupClient.aggregatedListInstanceGroupsCallable().call(request);
     for (InstanceGroupsScopedList element : response.getItemsMap()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
 

deleteInstanceGroup

@BetaApi
public final Operation deleteInstanceGroup(ProjectZoneInstanceGroupName instanceGroup)

Deletes the specified instance group. The instances in the group are not deleted. Note that instance group must not belong to a backend service. Read Deleting an instance group for more information.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectZoneInstanceGroupName instanceGroup = ProjectZoneInstanceGroupName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   Operation response = instanceGroupClient.deleteInstanceGroup(instanceGroup);
 }
 

Parameters:

instanceGroup - The name of the instance group to delete.

Throws:

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

deleteInstanceGroup

@BetaApi
public final Operation deleteInstanceGroup(String instanceGroup)

Deletes the specified instance group. The instances in the group are not deleted. Note that instance group must not belong to a backend service. Read Deleting an instance group for more information.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectZoneInstanceGroupName instanceGroup = ProjectZoneInstanceGroupName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   Operation response = instanceGroupClient.deleteInstanceGroup(instanceGroup.toString());
 }
 

Parameters:

instanceGroup - The name of the instance group to delete.

Throws:

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

deleteInstanceGroup

@BetaApi
public final Operation deleteInstanceGroup(DeleteInstanceGroupHttpRequest request)

Deletes the specified instance group. The instances in the group are not deleted. Note that instance group must not belong to a backend service. Read Deleting an instance group for more information.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedInstanceGroup = ProjectZoneInstanceGroupName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   DeleteInstanceGroupHttpRequest request = DeleteInstanceGroupHttpRequest.newBuilder()
     .setInstanceGroup(formattedInstanceGroup)
     .build();
   Operation response = instanceGroupClient.deleteInstanceGroup(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

deleteInstanceGroupCallable

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

Deletes the specified instance group. The instances in the group are not deleted. Note that instance group must not belong to a backend service. Read Deleting an instance group for more information.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedInstanceGroup = ProjectZoneInstanceGroupName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   DeleteInstanceGroupHttpRequest request = DeleteInstanceGroupHttpRequest.newBuilder()
     .setInstanceGroup(formattedInstanceGroup)
     .build();
   ApiFuture<Operation> future = instanceGroupClient.deleteInstanceGroupCallable().futureCall(request);
   // Do something
   Operation response = future.get();
 }
 

getInstanceGroup

@BetaApi
public final InstanceGroup getInstanceGroup(ProjectZoneInstanceGroupName instanceGroup)

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

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectZoneInstanceGroupName instanceGroup = ProjectZoneInstanceGroupName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroup response = instanceGroupClient.getInstanceGroup(instanceGroup);
 }
 

Parameters:

instanceGroup - The name of the instance group.

Throws:

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

getInstanceGroup

@BetaApi
public final InstanceGroup getInstanceGroup(String instanceGroup)

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

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectZoneInstanceGroupName instanceGroup = ProjectZoneInstanceGroupName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroup response = instanceGroupClient.getInstanceGroup(instanceGroup.toString());
 }
 

Parameters:

instanceGroup - The name of the instance group.

Throws:

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

getInstanceGroup

@BetaApi
public final InstanceGroup getInstanceGroup(GetInstanceGroupHttpRequest request)

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

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedInstanceGroup = ProjectZoneInstanceGroupName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   GetInstanceGroupHttpRequest request = GetInstanceGroupHttpRequest.newBuilder()
     .setInstanceGroup(formattedInstanceGroup)
     .build();
   InstanceGroup response = instanceGroupClient.getInstanceGroup(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

getInstanceGroupCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<GetInstanceGroupHttpRequest,InstanceGroup> getInstanceGroupCallable()

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

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedInstanceGroup = ProjectZoneInstanceGroupName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   GetInstanceGroupHttpRequest request = GetInstanceGroupHttpRequest.newBuilder()
     .setInstanceGroup(formattedInstanceGroup)
     .build();
   ApiFuture<InstanceGroup> future = instanceGroupClient.getInstanceGroupCallable().futureCall(request);
   // Do something
   InstanceGroup response = future.get();
 }
 

insertInstanceGroup

@BetaApi
public final Operation insertInstanceGroup(ProjectZoneName zone,
                                                    InstanceGroup instanceGroupResource)

Creates an instance group in the specified project using the parameters that are included in the request.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectZoneName zone = ProjectZoneName.of("[PROJECT]", "[ZONE]");
   InstanceGroup instanceGroupResource = InstanceGroup.newBuilder().build();
   Operation response = instanceGroupClient.insertInstanceGroup(zone, instanceGroupResource);
 }
 

Parameters:

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

instanceGroupResource - Represents an unmanaged Instance Group resource.

Use unmanaged instance groups if you need to apply load balancing to groups of heterogeneous instances or if you need to manage the instances yourself. For more information, read Instance groups.

For zonal unmanaged Instance Group, use instanceGroups resource.

For regional unmanaged Instance Group, use regionInstanceGroups resource. (== resource_for beta.instanceGroups ==) (== resource_for v1.instanceGroups ==) (== resource_for beta.regionInstanceGroups ==) (== resource_for v1.regionInstanceGroups ==)

Throws:

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

insertInstanceGroup

@BetaApi
public final Operation insertInstanceGroup(String zone,
                                                    InstanceGroup instanceGroupResource)

Creates an instance group in the specified project using the parameters that are included in the request.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectZoneName zone = ProjectZoneName.of("[PROJECT]", "[ZONE]");
   InstanceGroup instanceGroupResource = InstanceGroup.newBuilder().build();
   Operation response = instanceGroupClient.insertInstanceGroup(zone.toString(), instanceGroupResource);
 }
 

Parameters:

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

instanceGroupResource - Represents an unmanaged Instance Group resource.

Use unmanaged instance groups if you need to apply load balancing to groups of heterogeneous instances or if you need to manage the instances yourself. For more information, read Instance groups.

For zonal unmanaged Instance Group, use instanceGroups resource.

For regional unmanaged Instance Group, use regionInstanceGroups resource. (== resource_for beta.instanceGroups ==) (== resource_for v1.instanceGroups ==) (== resource_for beta.regionInstanceGroups ==) (== resource_for v1.regionInstanceGroups ==)

Throws:

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

insertInstanceGroup

@BetaApi
public final Operation insertInstanceGroup(InsertInstanceGroupHttpRequest request)

Creates an instance group in the specified project using the parameters that are included in the request.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedZone = ProjectZoneName.format("[PROJECT]", "[ZONE]");
   InstanceGroup instanceGroupResource = InstanceGroup.newBuilder().build();
   InsertInstanceGroupHttpRequest request = InsertInstanceGroupHttpRequest.newBuilder()
     .setZone(formattedZone)
     .setInstanceGroupResource(instanceGroupResource)
     .build();
   Operation response = instanceGroupClient.insertInstanceGroup(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

insertInstanceGroupCallable

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

Creates an instance group in the specified project using the parameters that are included in the request.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedZone = ProjectZoneName.format("[PROJECT]", "[ZONE]");
   InstanceGroup instanceGroupResource = InstanceGroup.newBuilder().build();
   InsertInstanceGroupHttpRequest request = InsertInstanceGroupHttpRequest.newBuilder()
     .setZone(formattedZone)
     .setInstanceGroupResource(instanceGroupResource)
     .build();
   ApiFuture<Operation> future = instanceGroupClient.insertInstanceGroupCallable().futureCall(request);
   // Do something
   Operation response = future.get();
 }
 

listInstanceGroups

@BetaApi
public final InstanceGroupClient.ListInstanceGroupsPagedResponse listInstanceGroups(ProjectZoneName zone)

Retrieves the list of instance groups that are located in the specified project and zone.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectZoneName zone = ProjectZoneName.of("[PROJECT]", "[ZONE]");
   for (InstanceGroup element : instanceGroupClient.listInstanceGroups(zone).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters:

zone - The name of the zone where the instance group is located.

Throws:

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

listInstanceGroups

@BetaApi
public final InstanceGroupClient.ListInstanceGroupsPagedResponse listInstanceGroups(String zone)

Retrieves the list of instance groups that are located in the specified project and zone.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectZoneName zone = ProjectZoneName.of("[PROJECT]", "[ZONE]");
   for (InstanceGroup element : instanceGroupClient.listInstanceGroups(zone.toString()).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters:

zone - The name of the zone where the instance group is located.

Throws:

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

listInstanceGroups

@BetaApi
public final InstanceGroupClient.ListInstanceGroupsPagedResponse listInstanceGroups(ListInstanceGroupsHttpRequest request)

Retrieves the list of instance groups that are located in the specified project and zone.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedZone = ProjectZoneName.format("[PROJECT]", "[ZONE]");
   ListInstanceGroupsHttpRequest request = ListInstanceGroupsHttpRequest.newBuilder()
     .setZone(formattedZone)
     .build();
   for (InstanceGroup element : instanceGroupClient.listInstanceGroups(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

listInstanceGroupsPagedCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<ListInstanceGroupsHttpRequest,InstanceGroupClient.ListInstanceGroupsPagedResponse> listInstanceGroupsPagedCallable()

Retrieves the list of instance groups that are located in the specified project and zone.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedZone = ProjectZoneName.format("[PROJECT]", "[ZONE]");
   ListInstanceGroupsHttpRequest request = ListInstanceGroupsHttpRequest.newBuilder()
     .setZone(formattedZone)
     .build();
   ApiFuture<ListInstanceGroupsPagedResponse> future = instanceGroupClient.listInstanceGroupsPagedCallable().futureCall(request);
   // Do something
   for (InstanceGroup element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }
 

listInstanceGroupsCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<ListInstanceGroupsHttpRequest,InstanceGroupList> listInstanceGroupsCallable()

Retrieves the list of instance groups that are located in the specified project and zone.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedZone = ProjectZoneName.format("[PROJECT]", "[ZONE]");
   ListInstanceGroupsHttpRequest request = ListInstanceGroupsHttpRequest.newBuilder()
     .setZone(formattedZone)
     .build();
   while (true) {
     InstanceGroupList response = instanceGroupClient.listInstanceGroupsCallable().call(request);
     for (InstanceGroup element : response.getItemsList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
 

listInstancesInstanceGroups

@BetaApi
public final InstanceGroupClient.ListInstancesInstanceGroupsPagedResponse listInstancesInstanceGroups(ProjectZoneInstanceGroupName instanceGroup,
                                                                                                               InstanceGroupsListInstancesRequest instanceGroupsListInstancesRequestResource)

Lists the instances in the specified instance group.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectZoneInstanceGroupName instanceGroup = ProjectZoneInstanceGroupName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroupsListInstancesRequest instanceGroupsListInstancesRequestResource = InstanceGroupsListInstancesRequest.newBuilder().build();
   for (InstanceWithNamedPorts element : instanceGroupClient.listInstancesInstanceGroups(instanceGroup, instanceGroupsListInstancesRequestResource).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters:

instanceGroup - The name of the instance group from which you want to generate a list of included instances.

instanceGroupsListInstancesRequestResource -

Throws:

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

listInstancesInstanceGroups

@BetaApi
public final InstanceGroupClient.ListInstancesInstanceGroupsPagedResponse listInstancesInstanceGroups(String instanceGroup,
                                                                                                               InstanceGroupsListInstancesRequest instanceGroupsListInstancesRequestResource)

Lists the instances in the specified instance group.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectZoneInstanceGroupName instanceGroup = ProjectZoneInstanceGroupName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroupsListInstancesRequest instanceGroupsListInstancesRequestResource = InstanceGroupsListInstancesRequest.newBuilder().build();
   for (InstanceWithNamedPorts element : instanceGroupClient.listInstancesInstanceGroups(instanceGroup.toString(), instanceGroupsListInstancesRequestResource).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters:

instanceGroup - The name of the instance group from which you want to generate a list of included instances.

instanceGroupsListInstancesRequestResource -

Throws:

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

listInstancesInstanceGroups

@BetaApi
public final InstanceGroupClient.ListInstancesInstanceGroupsPagedResponse listInstancesInstanceGroups(ListInstancesInstanceGroupsHttpRequest request)

Lists the instances in the specified instance group.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedInstanceGroup = ProjectZoneInstanceGroupName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroupsListInstancesRequest instanceGroupsListInstancesRequestResource = InstanceGroupsListInstancesRequest.newBuilder().build();
   ListInstancesInstanceGroupsHttpRequest request = ListInstancesInstanceGroupsHttpRequest.newBuilder()
     .setInstanceGroup(formattedInstanceGroup)
     .setInstanceGroupsListInstancesRequestResource(instanceGroupsListInstancesRequestResource)
     .build();
   for (InstanceWithNamedPorts element : instanceGroupClient.listInstancesInstanceGroups(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

listInstancesInstanceGroupsPagedCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<ListInstancesInstanceGroupsHttpRequest,InstanceGroupClient.ListInstancesInstanceGroupsPagedResponse> listInstancesInstanceGroupsPagedCallable()

Lists the instances in the specified instance group.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedInstanceGroup = ProjectZoneInstanceGroupName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroupsListInstancesRequest instanceGroupsListInstancesRequestResource = InstanceGroupsListInstancesRequest.newBuilder().build();
   ListInstancesInstanceGroupsHttpRequest request = ListInstancesInstanceGroupsHttpRequest.newBuilder()
     .setInstanceGroup(formattedInstanceGroup)
     .setInstanceGroupsListInstancesRequestResource(instanceGroupsListInstancesRequestResource)
     .build();
   ApiFuture<ListInstancesInstanceGroupsPagedResponse> future = instanceGroupClient.listInstancesInstanceGroupsPagedCallable().futureCall(request);
   // Do something
   for (InstanceWithNamedPorts element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }
 

listInstancesInstanceGroupsCallable

@BetaApi
public final com.google.api.gax.rpc.UnaryCallable<ListInstancesInstanceGroupsHttpRequest,InstanceGroupsListInstances> listInstancesInstanceGroupsCallable()

Lists the instances in the specified instance group.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedInstanceGroup = ProjectZoneInstanceGroupName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroupsListInstancesRequest instanceGroupsListInstancesRequestResource = InstanceGroupsListInstancesRequest.newBuilder().build();
   ListInstancesInstanceGroupsHttpRequest request = ListInstancesInstanceGroupsHttpRequest.newBuilder()
     .setInstanceGroup(formattedInstanceGroup)
     .setInstanceGroupsListInstancesRequestResource(instanceGroupsListInstancesRequestResource)
     .build();
   while (true) {
     InstanceGroupsListInstances response = instanceGroupClient.listInstancesInstanceGroupsCallable().call(request);
     for (InstanceWithNamedPorts element : response.getItemsList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
 

removeInstancesInstanceGroup

@BetaApi
public final Operation removeInstancesInstanceGroup(ProjectZoneInstanceGroupName instanceGroup,
                                                             InstanceGroupsRemoveInstancesRequest instanceGroupsRemoveInstancesRequestResource)

Removes one or more instances from the specified instance group, but does not delete those instances.

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 before the VM instance is removed or deleted.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectZoneInstanceGroupName instanceGroup = ProjectZoneInstanceGroupName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroupsRemoveInstancesRequest instanceGroupsRemoveInstancesRequestResource = InstanceGroupsRemoveInstancesRequest.newBuilder().build();
   Operation response = instanceGroupClient.removeInstancesInstanceGroup(instanceGroup, instanceGroupsRemoveInstancesRequestResource);
 }
 

Parameters:

instanceGroup - The name of the instance group where the specified instances will be removed.

instanceGroupsRemoveInstancesRequestResource -

Throws:

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

removeInstancesInstanceGroup

@BetaApi
public final Operation removeInstancesInstanceGroup(String instanceGroup,
                                                             InstanceGroupsRemoveInstancesRequest instanceGroupsRemoveInstancesRequestResource)

Removes one or more instances from the specified instance group, but does not delete those instances.

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 before the VM instance is removed or deleted.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectZoneInstanceGroupName instanceGroup = ProjectZoneInstanceGroupName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroupsRemoveInstancesRequest instanceGroupsRemoveInstancesRequestResource = InstanceGroupsRemoveInstancesRequest.newBuilder().build();
   Operation response = instanceGroupClient.removeInstancesInstanceGroup(instanceGroup.toString(), instanceGroupsRemoveInstancesRequestResource);
 }
 

Parameters:

instanceGroup - The name of the instance group where the specified instances will be removed.

instanceGroupsRemoveInstancesRequestResource -

Throws:

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

removeInstancesInstanceGroup

@BetaApi
public final Operation removeInstancesInstanceGroup(RemoveInstancesInstanceGroupHttpRequest request)

Removes one or more instances from the specified instance group, but does not delete those instances.

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 before the VM instance is removed or deleted.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedInstanceGroup = ProjectZoneInstanceGroupName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroupsRemoveInstancesRequest instanceGroupsRemoveInstancesRequestResource = InstanceGroupsRemoveInstancesRequest.newBuilder().build();
   RemoveInstancesInstanceGroupHttpRequest request = RemoveInstancesInstanceGroupHttpRequest.newBuilder()
     .setInstanceGroup(formattedInstanceGroup)
     .setInstanceGroupsRemoveInstancesRequestResource(instanceGroupsRemoveInstancesRequestResource)
     .build();
   Operation response = instanceGroupClient.removeInstancesInstanceGroup(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

removeInstancesInstanceGroupCallable

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

Removes one or more instances from the specified instance group, but does not delete those instances.

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 before the VM instance is removed or deleted.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedInstanceGroup = ProjectZoneInstanceGroupName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroupsRemoveInstancesRequest instanceGroupsRemoveInstancesRequestResource = InstanceGroupsRemoveInstancesRequest.newBuilder().build();
   RemoveInstancesInstanceGroupHttpRequest request = RemoveInstancesInstanceGroupHttpRequest.newBuilder()
     .setInstanceGroup(formattedInstanceGroup)
     .setInstanceGroupsRemoveInstancesRequestResource(instanceGroupsRemoveInstancesRequestResource)
     .build();
   ApiFuture<Operation> future = instanceGroupClient.removeInstancesInstanceGroupCallable().futureCall(request);
   // Do something
   Operation response = future.get();
 }
 

setNamedPortsInstanceGroup

@BetaApi
public final Operation setNamedPortsInstanceGroup(ProjectZoneInstanceGroupName instanceGroup,
                                                           InstanceGroupsSetNamedPortsRequest instanceGroupsSetNamedPortsRequestResource)

Sets the named ports for the specified instance group.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectZoneInstanceGroupName instanceGroup = ProjectZoneInstanceGroupName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroupsSetNamedPortsRequest instanceGroupsSetNamedPortsRequestResource = InstanceGroupsSetNamedPortsRequest.newBuilder().build();
   Operation response = instanceGroupClient.setNamedPortsInstanceGroup(instanceGroup, instanceGroupsSetNamedPortsRequestResource);
 }
 

Parameters:

instanceGroup - The name of the instance group where the named ports are updated.

instanceGroupsSetNamedPortsRequestResource -

Throws:

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

setNamedPortsInstanceGroup

@BetaApi
public final Operation setNamedPortsInstanceGroup(String instanceGroup,
                                                           InstanceGroupsSetNamedPortsRequest instanceGroupsSetNamedPortsRequestResource)

Sets the named ports for the specified instance group.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   ProjectZoneInstanceGroupName instanceGroup = ProjectZoneInstanceGroupName.of("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroupsSetNamedPortsRequest instanceGroupsSetNamedPortsRequestResource = InstanceGroupsSetNamedPortsRequest.newBuilder().build();
   Operation response = instanceGroupClient.setNamedPortsInstanceGroup(instanceGroup.toString(), instanceGroupsSetNamedPortsRequestResource);
 }
 

Parameters:

instanceGroup - The name of the instance group where the named ports are updated.

instanceGroupsSetNamedPortsRequestResource -

Throws:

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

setNamedPortsInstanceGroup

@BetaApi
public final Operation setNamedPortsInstanceGroup(SetNamedPortsInstanceGroupHttpRequest request)

Sets the named ports for the specified instance group.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedInstanceGroup = ProjectZoneInstanceGroupName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroupsSetNamedPortsRequest instanceGroupsSetNamedPortsRequestResource = InstanceGroupsSetNamedPortsRequest.newBuilder().build();
   SetNamedPortsInstanceGroupHttpRequest request = SetNamedPortsInstanceGroupHttpRequest.newBuilder()
     .setInstanceGroup(formattedInstanceGroup)
     .setInstanceGroupsSetNamedPortsRequestResource(instanceGroupsSetNamedPortsRequestResource)
     .build();
   Operation response = instanceGroupClient.setNamedPortsInstanceGroup(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

setNamedPortsInstanceGroupCallable

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

Sets the named ports for the specified instance group.

Sample code:

 try (InstanceGroupClient instanceGroupClient = InstanceGroupClient.create()) {
   String formattedInstanceGroup = ProjectZoneInstanceGroupName.format("[PROJECT]", "[ZONE]", "[INSTANCE_GROUP]");
   InstanceGroupsSetNamedPortsRequest instanceGroupsSetNamedPortsRequestResource = InstanceGroupsSetNamedPortsRequest.newBuilder().build();
   SetNamedPortsInstanceGroupHttpRequest request = SetNamedPortsInstanceGroupHttpRequest.newBuilder()
     .setInstanceGroup(formattedInstanceGroup)
     .setInstanceGroupsSetNamedPortsRequestResource(instanceGroupsSetNamedPortsRequestResource)
     .build();
   ApiFuture<Operation> future = instanceGroupClient.setNamedPortsInstanceGroupCallable().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