Class NodeGroupsClient (1.8.1)

Version 1.8.1

• 1.62.0 (latest)
• 1.61.0
• 1.59.0
• 1.58.0
• 1.57.0
• 1.56.0
• 1.55.0
• 1.54.0
• 1.53.0
• 1.52.0
• 1.51.0
• 1.50.0
• 1.49.0
• 1.47.0
• 1.46.0
• 1.45.0
• 1.44.0
• 1.43.0
• 1.42.0
• 1.41.0
• 1.40.0
• 1.39.0
• 1.38.0
• 1.37.0
• 1.34.0
• 1.33.0
• 1.32.0
• 1.31.0
• 1.30.0
• 1.29.0
• 1.28.0
• 1.27.0
• 1.26.0
• 1.25.0
• 1.24.0
• 1.23.0
• 1.22.0
• 1.21.0
• 1.20.0
• 1.19.0
• 1.18.0
• 1.17.0
• 1.16.0
• 1.15.0
• 1.14.0
• 1.13.0
• 1.12.1
• 1.11.0
• 1.9.1
• 1.8.1
• 1.7.2
• 1.6.0-beta

public class NodeGroupsClient implements BackgroundResource

Service Description: The NodeGroups API.

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 (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   String project = "project-309310695";
   String zone = "zone3744684";
   String nodeGroup = "nodeGroup443599261";
   NodeGroup response = nodeGroupsClient.get(project, zone, nodeGroup);
 }
 

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

To customize credentials:

 NodeGroupsSettings nodeGroupsSettings =
     NodeGroupsSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create(nodeGroupsSettings);
 

To customize the endpoint:

 NodeGroupsSettings nodeGroupsSettings =
     NodeGroupsSettings.newBuilder().setEndpoint(myEndpoint).build();
 NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create(nodeGroupsSettings);
 

Please refer to the GitHub repository's samples for more quickstart code snippets.

Inheritance

java.lang.Object > NodeGroupsClient

Implements

BackgroundResource

Inherited Members

Object.clone()

Object.equals(Object)

Object.finalize()

Object.getClass()

Object.hashCode()

Object.notify()

Object.notifyAll()

Object.toString()

Object.wait()

Object.wait(long)

Object.wait(long,int)

Static Methods

create()

public static final NodeGroupsClient create()

Constructs an instance of NodeGroupsClient with default settings.

Returns

Type	Description
NodeGroupsClient

Exceptions

Type	Description
IOException

create(NodeGroupsSettings settings)

public static final NodeGroupsClient create(NodeGroupsSettings settings)

Constructs an instance of NodeGroupsClient, using the given settings. The channels are created based on the settings passed in, or defaults for any settings that are not set.

Parameter

Name	Description
settings	NodeGroupsSettings

Returns

Type	Description
NodeGroupsClient

Exceptions

Type	Description
IOException

create(NodeGroupsStub stub)

public static final NodeGroupsClient create(NodeGroupsStub stub)

Constructs an instance of NodeGroupsClient, using the given stub for making calls. This is for advanced usage - prefer using create(NodeGroupsSettings).

Parameter

Name	Description
stub	NodeGroupsStub

Returns

Type	Description
NodeGroupsClient

Constructors

NodeGroupsClient(NodeGroupsSettings settings)

protected NodeGroupsClient(NodeGroupsSettings settings)

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

Parameter

Name	Description
settings	NodeGroupsSettings

NodeGroupsClient(NodeGroupsStub stub)

protected NodeGroupsClient(NodeGroupsStub stub)

Parameter

Name	Description
stub	NodeGroupsStub

Methods

addNodesAsync(AddNodesNodeGroupRequest request)

public final OperationFuture<Operation,Operation> addNodesAsync(AddNodesNodeGroupRequest request)

Adds specified number of nodes to the node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   AddNodesNodeGroupRequest request =
       AddNodesNodeGroupRequest.newBuilder()
           .setNodeGroup("nodeGroup443599261")
           .setNodeGroupsAddNodesRequestResource(NodeGroupsAddNodesRequest.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   Operation response = nodeGroupsClient.addNodesAsync(request).get();
 }
 

Parameter

Name	Description
request	AddNodesNodeGroupRequest The request object containing all of the parameters for the API call.

Returns

Type	Description
OperationFuture<Operation,Operation>

addNodesAsync(String project, String zone, String nodeGroup, NodeGroupsAddNodesRequest nodeGroupsAddNodesRequestResource)

public final OperationFuture<Operation,Operation> addNodesAsync(String project, String zone, String nodeGroup, NodeGroupsAddNodesRequest nodeGroupsAddNodesRequestResource)

Adds specified number of nodes to the node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   String project = "project-309310695";
   String zone = "zone3744684";
   String nodeGroup = "nodeGroup443599261";
   NodeGroupsAddNodesRequest nodeGroupsAddNodesRequestResource =
       NodeGroupsAddNodesRequest.newBuilder().build();
   Operation response =
       nodeGroupsClient
           .addNodesAsync(project, zone, nodeGroup, nodeGroupsAddNodesRequestResource)
           .get();
 }
 

Parameters

Name	Description
project	String Project ID for this request.
zone	String The name of the zone for this request.
nodeGroup	String Name of the NodeGroup resource.
nodeGroupsAddNodesRequestResource	NodeGroupsAddNodesRequest The body resource for this request

Returns

Type	Description
OperationFuture<Operation,Operation>

addNodesCallable()

public final UnaryCallable<AddNodesNodeGroupRequest,Operation> addNodesCallable()

Adds specified number of nodes to the node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   AddNodesNodeGroupRequest request =
       AddNodesNodeGroupRequest.newBuilder()
           .setNodeGroup("nodeGroup443599261")
           .setNodeGroupsAddNodesRequestResource(NodeGroupsAddNodesRequest.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   ApiFuture<Operation> future = nodeGroupsClient.addNodesCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 

Returns

Type	Description
UnaryCallable<AddNodesNodeGroupRequest,Operation>

addNodesOperationCallable()

public final OperationCallable<AddNodesNodeGroupRequest,Operation,Operation> addNodesOperationCallable()

Adds specified number of nodes to the node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   AddNodesNodeGroupRequest request =
       AddNodesNodeGroupRequest.newBuilder()
           .setNodeGroup("nodeGroup443599261")
           .setNodeGroupsAddNodesRequestResource(NodeGroupsAddNodesRequest.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   OperationFuture

Returns

Type	Description
OperationCallable<AddNodesNodeGroupRequest,Operation,Operation>

aggregatedList(AggregatedListNodeGroupsRequest request)

public final NodeGroupsClient.AggregatedListPagedResponse aggregatedList(AggregatedListNodeGroupsRequest request)

Retrieves an aggregated list of node groups. Note: use nodeGroups.listNodes for more details about each group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   AggregatedListNodeGroupsRequest request =
       AggregatedListNodeGroupsRequest.newBuilder()
           .setFilter("filter-1274492040")
           .setIncludeAllScopes(true)
           .setMaxResults(1128457243)
           .setOrderBy("orderBy-1207110587")
           .setPageToken("pageToken873572522")
           .setProject("project-309310695")
           .setReturnPartialSuccess(true)
           .build();
   for (Map.Entry

Parameter

Name	Description
request	AggregatedListNodeGroupsRequest The request object containing all of the parameters for the API call.

Returns

Type	Description
NodeGroupsClient.AggregatedListPagedResponse

aggregatedList(String project)

public final NodeGroupsClient.AggregatedListPagedResponse aggregatedList(String project)

Retrieves an aggregated list of node groups. Note: use nodeGroups.listNodes for more details about each group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   String project = "project-309310695";
   for (Map.Entry

Parameter

Name	Description
project	String Project ID for this request.

Returns

Type	Description
NodeGroupsClient.AggregatedListPagedResponse

aggregatedListCallable()

public final UnaryCallable<AggregatedListNodeGroupsRequest,NodeGroupAggregatedList> aggregatedListCallable()

Retrieves an aggregated list of node groups. Note: use nodeGroups.listNodes for more details about each group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   AggregatedListNodeGroupsRequest request =
       AggregatedListNodeGroupsRequest.newBuilder()
           .setFilter("filter-1274492040")
           .setIncludeAllScopes(true)
           .setMaxResults(1128457243)
           .setOrderBy("orderBy-1207110587")
           .setPageToken("pageToken873572522")
           .setProject("project-309310695")
           .setReturnPartialSuccess(true)
           .build();
   while (true) {
     NodeGroupAggregatedList response = nodeGroupsClient.aggregatedListCallable().call(request);
     for (Map.Entry

Returns

Type	Description
UnaryCallable<AggregatedListNodeGroupsRequest,NodeGroupAggregatedList>

aggregatedListPagedCallable()

public final UnaryCallable<AggregatedListNodeGroupsRequest,NodeGroupsClient.AggregatedListPagedResponse> aggregatedListPagedCallable()

Retrieves an aggregated list of node groups. Note: use nodeGroups.listNodes for more details about each group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   AggregatedListNodeGroupsRequest request =
       AggregatedListNodeGroupsRequest.newBuilder()
           .setFilter("filter-1274492040")
           .setIncludeAllScopes(true)
           .setMaxResults(1128457243)
           .setOrderBy("orderBy-1207110587")
           .setPageToken("pageToken873572522")
           .setProject("project-309310695")
           .setReturnPartialSuccess(true)
           .build();
   ApiFuture<>

Returns

Type	Description
UnaryCallable<AggregatedListNodeGroupsRequest,AggregatedListPagedResponse>

awaitTermination(long duration, TimeUnit unit)

public boolean awaitTermination(long duration, TimeUnit unit)

Parameters

Name	Description
duration	long
unit	TimeUnit

Returns

Type	Description
boolean

Exceptions

Type	Description
InterruptedException

close()

public final void close()

deleteAsync(DeleteNodeGroupRequest request)

public final OperationFuture<Operation,Operation> deleteAsync(DeleteNodeGroupRequest request)

Deletes the specified NodeGroup resource.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   DeleteNodeGroupRequest request =
       DeleteNodeGroupRequest.newBuilder()
           .setNodeGroup("nodeGroup443599261")
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   Operation response = nodeGroupsClient.deleteAsync(request).get();
 }
 

Parameter

Name	Description
request	DeleteNodeGroupRequest The request object containing all of the parameters for the API call.

Returns

Type	Description
OperationFuture<Operation,Operation>

deleteAsync(String project, String zone, String nodeGroup)

public final OperationFuture<Operation,Operation> deleteAsync(String project, String zone, String nodeGroup)

Deletes the specified NodeGroup resource.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   String project = "project-309310695";
   String zone = "zone3744684";
   String nodeGroup = "nodeGroup443599261";
   Operation response = nodeGroupsClient.deleteAsync(project, zone, nodeGroup).get();
 }
 

Parameters

Name	Description
project	String Project ID for this request.
zone	String The name of the zone for this request.
nodeGroup	String Name of the NodeGroup resource to delete.

Returns

Type	Description
OperationFuture<Operation,Operation>

deleteCallable()

public final UnaryCallable<DeleteNodeGroupRequest,Operation> deleteCallable()

Deletes the specified NodeGroup resource.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   DeleteNodeGroupRequest request =
       DeleteNodeGroupRequest.newBuilder()
           .setNodeGroup("nodeGroup443599261")
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   ApiFuture<Operation> future = nodeGroupsClient.deleteCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 

Returns

Type	Description
UnaryCallable<DeleteNodeGroupRequest,Operation>

deleteNodesAsync(DeleteNodesNodeGroupRequest request)

public final OperationFuture<Operation,Operation> deleteNodesAsync(DeleteNodesNodeGroupRequest request)

Deletes specified nodes from the node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   DeleteNodesNodeGroupRequest request =
       DeleteNodesNodeGroupRequest.newBuilder()
           .setNodeGroup("nodeGroup443599261")
           .setNodeGroupsDeleteNodesRequestResource(
               NodeGroupsDeleteNodesRequest.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   Operation response = nodeGroupsClient.deleteNodesAsync(request).get();
 }
 

Parameter

Name	Description
request	DeleteNodesNodeGroupRequest The request object containing all of the parameters for the API call.

Returns

Type	Description
OperationFuture<Operation,Operation>

deleteNodesAsync(String project, String zone, String nodeGroup, NodeGroupsDeleteNodesRequest nodeGroupsDeleteNodesRequestResource)

public final OperationFuture<Operation,Operation> deleteNodesAsync(String project, String zone, String nodeGroup, NodeGroupsDeleteNodesRequest nodeGroupsDeleteNodesRequestResource)

Deletes specified nodes from the node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   String project = "project-309310695";
   String zone = "zone3744684";
   String nodeGroup = "nodeGroup443599261";
   NodeGroupsDeleteNodesRequest nodeGroupsDeleteNodesRequestResource =
       NodeGroupsDeleteNodesRequest.newBuilder().build();
   Operation response =
       nodeGroupsClient
           .deleteNodesAsync(project, zone, nodeGroup, nodeGroupsDeleteNodesRequestResource)
           .get();
 }
 

Parameters

Name	Description
project	String Project ID for this request.
zone	String The name of the zone for this request.
nodeGroup	String Name of the NodeGroup resource whose nodes will be deleted.
nodeGroupsDeleteNodesRequestResource	NodeGroupsDeleteNodesRequest The body resource for this request

Returns

Type	Description
OperationFuture<Operation,Operation>

deleteNodesCallable()

public final UnaryCallable<DeleteNodesNodeGroupRequest,Operation> deleteNodesCallable()

Deletes specified nodes from the node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   DeleteNodesNodeGroupRequest request =
       DeleteNodesNodeGroupRequest.newBuilder()
           .setNodeGroup("nodeGroup443599261")
           .setNodeGroupsDeleteNodesRequestResource(
               NodeGroupsDeleteNodesRequest.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   ApiFuture<Operation> future = nodeGroupsClient.deleteNodesCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 

Returns

Type	Description
UnaryCallable<DeleteNodesNodeGroupRequest,Operation>

deleteNodesOperationCallable()

public final OperationCallable<DeleteNodesNodeGroupRequest,Operation,Operation> deleteNodesOperationCallable()

Deletes specified nodes from the node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   DeleteNodesNodeGroupRequest request =
       DeleteNodesNodeGroupRequest.newBuilder()
           .setNodeGroup("nodeGroup443599261")
           .setNodeGroupsDeleteNodesRequestResource(
               NodeGroupsDeleteNodesRequest.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   OperationFuture

Returns

Type	Description
OperationCallable<DeleteNodesNodeGroupRequest,Operation,Operation>

deleteOperationCallable()

public final OperationCallable<DeleteNodeGroupRequest,Operation,Operation> deleteOperationCallable()

Deletes the specified NodeGroup resource.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   DeleteNodeGroupRequest request =
       DeleteNodeGroupRequest.newBuilder()
           .setNodeGroup("nodeGroup443599261")
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   OperationFuture

Returns

Type	Description
OperationCallable<DeleteNodeGroupRequest,Operation,Operation>

get(GetNodeGroupRequest request)

public final NodeGroup get(GetNodeGroupRequest request)

Returns the specified NodeGroup. Get a list of available NodeGroups by making a list() request. Note: the "nodes" field should not be used. Use nodeGroups.listNodes instead.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   GetNodeGroupRequest request =
       GetNodeGroupRequest.newBuilder()
           .setNodeGroup("nodeGroup443599261")
           .setProject("project-309310695")
           .setZone("zone3744684")
           .build();
   NodeGroup response = nodeGroupsClient.get(request);
 }
 

Parameter

Name	Description
request	GetNodeGroupRequest The request object containing all of the parameters for the API call.

Returns

Type	Description
NodeGroup

get(String project, String zone, String nodeGroup)

public final NodeGroup get(String project, String zone, String nodeGroup)

Returns the specified NodeGroup. Get a list of available NodeGroups by making a list() request. Note: the "nodes" field should not be used. Use nodeGroups.listNodes instead.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   String project = "project-309310695";
   String zone = "zone3744684";
   String nodeGroup = "nodeGroup443599261";
   NodeGroup response = nodeGroupsClient.get(project, zone, nodeGroup);
 }
 

Parameters

Name	Description
project	String Project ID for this request.
zone	String The name of the zone for this request.
nodeGroup	String Name of the node group to return.

Returns

Type	Description
NodeGroup

getCallable()

public final UnaryCallable<GetNodeGroupRequest,NodeGroup> getCallable()

Returns the specified NodeGroup. Get a list of available NodeGroups by making a list() request. Note: the "nodes" field should not be used. Use nodeGroups.listNodes instead.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   GetNodeGroupRequest request =
       GetNodeGroupRequest.newBuilder()
           .setNodeGroup("nodeGroup443599261")
           .setProject("project-309310695")
           .setZone("zone3744684")
           .build();
   ApiFuture

Returns

Type	Description
UnaryCallable<GetNodeGroupRequest,NodeGroup>

getIamPolicy(GetIamPolicyNodeGroupRequest request)

public final Policy getIamPolicy(GetIamPolicyNodeGroupRequest request)

Gets the access control policy for a resource. May be empty if no such policy or resource exists.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   GetIamPolicyNodeGroupRequest request =
       GetIamPolicyNodeGroupRequest.newBuilder()
           .setOptionsRequestedPolicyVersion(-574521795)
           .setProject("project-309310695")
           .setResource("resource-341064690")
           .setZone("zone3744684")
           .build();
   Policy response = nodeGroupsClient.getIamPolicy(request);
 }
 

Parameter

Name	Description
request	GetIamPolicyNodeGroupRequest The request object containing all of the parameters for the API call.

Returns

Type	Description
Policy

getIamPolicy(String project, String zone, String resource)

public final Policy getIamPolicy(String project, String zone, String resource)

Gets the access control policy for a resource. May be empty if no such policy or resource exists.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   String project = "project-309310695";
   String zone = "zone3744684";
   String resource = "resource-341064690";
   Policy response = nodeGroupsClient.getIamPolicy(project, zone, resource);
 }
 

Parameters

Name	Description
project	String Project ID for this request.
zone	String The name of the zone for this request.
resource	String Name or id of the resource for this request.

Returns

Type	Description
Policy

getIamPolicyCallable()

public final UnaryCallable<GetIamPolicyNodeGroupRequest,Policy> getIamPolicyCallable()

Gets the access control policy for a resource. May be empty if no such policy or resource exists.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   GetIamPolicyNodeGroupRequest request =
       GetIamPolicyNodeGroupRequest.newBuilder()
           .setOptionsRequestedPolicyVersion(-574521795)
           .setProject("project-309310695")
           .setResource("resource-341064690")
           .setZone("zone3744684")
           .build();
   ApiFuture<Policy> future = nodeGroupsClient.getIamPolicyCallable().futureCall(request);
   // Do something.
   Policy response = future.get();
 }
 

Returns

Type	Description
UnaryCallable<GetIamPolicyNodeGroupRequest,Policy>

getSettings()

public final NodeGroupsSettings getSettings()

Returns

Type	Description
NodeGroupsSettings

getStub()

public NodeGroupsStub getStub()

Returns

Type	Description
NodeGroupsStub

insertAsync(InsertNodeGroupRequest request)

public final OperationFuture<Operation,Operation> insertAsync(InsertNodeGroupRequest request)

Creates a NodeGroup resource in the specified project using the data included in the request.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   InsertNodeGroupRequest request =
       InsertNodeGroupRequest.newBuilder()
           .setInitialNodeCount(1682564205)
           .setNodeGroupResource(NodeGroup.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   Operation response = nodeGroupsClient.insertAsync(request).get();
 }
 

Parameter

Name	Description
request	InsertNodeGroupRequest The request object containing all of the parameters for the API call.

Returns

Type	Description
OperationFuture<Operation,Operation>

insertAsync(String project, String zone, int initialNodeCount, NodeGroup nodeGroupResource)

public final OperationFuture<Operation,Operation> insertAsync(String project, String zone, int initialNodeCount, NodeGroup nodeGroupResource)

Creates a NodeGroup resource in the specified project using the data included in the request.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   String project = "project-309310695";
   String zone = "zone3744684";
   int initialNodeCount = 1682564205;
   NodeGroup nodeGroupResource = NodeGroup.newBuilder().build();
   Operation response =
       nodeGroupsClient.insertAsync(project, zone, initialNodeCount, nodeGroupResource).get();
 }
 

Parameters

Name	Description
project	String Project ID for this request.
zone	String The name of the zone for this request.
initialNodeCount	int Initial count of nodes in the node group.
nodeGroupResource	NodeGroup The body resource for this request

Returns

Type	Description
OperationFuture<Operation,Operation>

insertCallable()

public final UnaryCallable<InsertNodeGroupRequest,Operation> insertCallable()

Creates a NodeGroup resource in the specified project using the data included in the request.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   InsertNodeGroupRequest request =
       InsertNodeGroupRequest.newBuilder()
           .setInitialNodeCount(1682564205)
           .setNodeGroupResource(NodeGroup.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   ApiFuture<Operation> future = nodeGroupsClient.insertCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 

Returns

Type	Description
UnaryCallable<InsertNodeGroupRequest,Operation>

insertOperationCallable()

public final OperationCallable<InsertNodeGroupRequest,Operation,Operation> insertOperationCallable()

Creates a NodeGroup resource in the specified project using the data included in the request.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   InsertNodeGroupRequest request =
       InsertNodeGroupRequest.newBuilder()
           .setInitialNodeCount(1682564205)
           .setNodeGroupResource(NodeGroup.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   OperationFuture

Returns

Type	Description
OperationCallable<InsertNodeGroupRequest,Operation,Operation>

isShutdown()

public boolean isShutdown()

Returns

Type	Description
boolean

isTerminated()

public boolean isTerminated()

Returns

Type	Description
boolean

list(ListNodeGroupsRequest request)

public final NodeGroupsClient.ListPagedResponse list(ListNodeGroupsRequest request)

Retrieves a list of node groups available to the specified project. Note: use nodeGroups.listNodes for more details about each group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   ListNodeGroupsRequest request =
       ListNodeGroupsRequest.newBuilder()
           .setFilter("filter-1274492040")
           .setMaxResults(1128457243)
           .setOrderBy("orderBy-1207110587")
           .setPageToken("pageToken873572522")
           .setProject("project-309310695")
           .setReturnPartialSuccess(true)
           .setZone("zone3744684")
           .build();
   for (NodeGroup element : nodeGroupsClient.list(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameter

Name	Description
request	ListNodeGroupsRequest The request object containing all of the parameters for the API call.

Returns

Type	Description
NodeGroupsClient.ListPagedResponse

list(String project, String zone)

public final NodeGroupsClient.ListPagedResponse list(String project, String zone)

Retrieves a list of node groups available to the specified project. Note: use nodeGroups.listNodes for more details about each group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   String project = "project-309310695";
   String zone = "zone3744684";
   for (NodeGroup element : nodeGroupsClient.list(project, zone).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters

Name	Description
project	String Project ID for this request.
zone	String The name of the zone for this request.

Returns

Type	Description
NodeGroupsClient.ListPagedResponse

listCallable()

public final UnaryCallable<ListNodeGroupsRequest,NodeGroupList> listCallable()

Retrieves a list of node groups available to the specified project. Note: use nodeGroups.listNodes for more details about each group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   ListNodeGroupsRequest request =
       ListNodeGroupsRequest.newBuilder()
           .setFilter("filter-1274492040")
           .setMaxResults(1128457243)
           .setOrderBy("orderBy-1207110587")
           .setPageToken("pageToken873572522")
           .setProject("project-309310695")
           .setReturnPartialSuccess(true)
           .setZone("zone3744684")
           .build();
   while (true) {
     NodeGroupList response = nodeGroupsClient.listCallable().call(request);
     for (NodeGroup element : response.getResponsesList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
 

Returns

Type	Description
UnaryCallable<ListNodeGroupsRequest,NodeGroupList>

listNodes(ListNodesNodeGroupsRequest request)

public final NodeGroupsClient.ListNodesPagedResponse listNodes(ListNodesNodeGroupsRequest request)

Lists nodes in the node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   ListNodesNodeGroupsRequest request =
       ListNodesNodeGroupsRequest.newBuilder()
           .setFilter("filter-1274492040")
           .setMaxResults(1128457243)
           .setNodeGroup("nodeGroup443599261")
           .setOrderBy("orderBy-1207110587")
           .setPageToken("pageToken873572522")
           .setProject("project-309310695")
           .setReturnPartialSuccess(true)
           .setZone("zone3744684")
           .build();
   for (NodeGroupNode element : nodeGroupsClient.listNodes(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameter

Name	Description
request	ListNodesNodeGroupsRequest The request object containing all of the parameters for the API call.

Returns

Type	Description
NodeGroupsClient.ListNodesPagedResponse

listNodes(String project, String zone, String nodeGroup)

public final NodeGroupsClient.ListNodesPagedResponse listNodes(String project, String zone, String nodeGroup)

Lists nodes in the node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   String project = "project-309310695";
   String zone = "zone3744684";
   String nodeGroup = "nodeGroup443599261";
   for (NodeGroupNode element :
       nodeGroupsClient.listNodes(project, zone, nodeGroup).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters

Name	Description
project	String Project ID for this request.
zone	String The name of the zone for this request.
nodeGroup	String Name of the NodeGroup resource whose nodes you want to list.

Returns

Type	Description
NodeGroupsClient.ListNodesPagedResponse

listNodesCallable()

public final UnaryCallable<ListNodesNodeGroupsRequest,NodeGroupsListNodes> listNodesCallable()

Lists nodes in the node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   ListNodesNodeGroupsRequest request =
       ListNodesNodeGroupsRequest.newBuilder()
           .setFilter("filter-1274492040")
           .setMaxResults(1128457243)
           .setNodeGroup("nodeGroup443599261")
           .setOrderBy("orderBy-1207110587")
           .setPageToken("pageToken873572522")
           .setProject("project-309310695")
           .setReturnPartialSuccess(true)
           .setZone("zone3744684")
           .build();
   while (true) {
     NodeGroupsListNodes response = nodeGroupsClient.listNodesCallable().call(request);
     for (NodeGroupNode element : response.getResponsesList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
 

Returns

Type	Description
UnaryCallable<ListNodesNodeGroupsRequest,NodeGroupsListNodes>

listNodesPagedCallable()

public final UnaryCallable<ListNodesNodeGroupsRequest,NodeGroupsClient.ListNodesPagedResponse> listNodesPagedCallable()

Lists nodes in the node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   ListNodesNodeGroupsRequest request =
       ListNodesNodeGroupsRequest.newBuilder()
           .setFilter("filter-1274492040")
           .setMaxResults(1128457243)
           .setNodeGroup("nodeGroup443599261")
           .setOrderBy("orderBy-1207110587")
           .setPageToken("pageToken873572522")
           .setProject("project-309310695")
           .setReturnPartialSuccess(true)
           .setZone("zone3744684")
           .build();
   ApiFuture

Returns

Type	Description
UnaryCallable<ListNodesNodeGroupsRequest,ListNodesPagedResponse>

listPagedCallable()

public final UnaryCallable<ListNodeGroupsRequest,NodeGroupsClient.ListPagedResponse> listPagedCallable()

Retrieves a list of node groups available to the specified project. Note: use nodeGroups.listNodes for more details about each group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   ListNodeGroupsRequest request =
       ListNodeGroupsRequest.newBuilder()
           .setFilter("filter-1274492040")
           .setMaxResults(1128457243)
           .setOrderBy("orderBy-1207110587")
           .setPageToken("pageToken873572522")
           .setProject("project-309310695")
           .setReturnPartialSuccess(true)
           .setZone("zone3744684")
           .build();
   ApiFuture

Returns

Type	Description
UnaryCallable<ListNodeGroupsRequest,ListPagedResponse>

patchAsync(PatchNodeGroupRequest request)

public final OperationFuture<Operation,Operation> patchAsync(PatchNodeGroupRequest request)

Updates the specified node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   PatchNodeGroupRequest request =
       PatchNodeGroupRequest.newBuilder()
           .setNodeGroup("nodeGroup443599261")
           .setNodeGroupResource(NodeGroup.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   Operation response = nodeGroupsClient.patchAsync(request).get();
 }
 

Parameter

Name	Description
request	PatchNodeGroupRequest The request object containing all of the parameters for the API call.

Returns

Type	Description
OperationFuture<Operation,Operation>

patchAsync(String project, String zone, String nodeGroup, NodeGroup nodeGroupResource)

public final OperationFuture<Operation,Operation> patchAsync(String project, String zone, String nodeGroup, NodeGroup nodeGroupResource)

Updates the specified node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   String project = "project-309310695";
   String zone = "zone3744684";
   String nodeGroup = "nodeGroup443599261";
   NodeGroup nodeGroupResource = NodeGroup.newBuilder().build();
   Operation response =
       nodeGroupsClient.patchAsync(project, zone, nodeGroup, nodeGroupResource).get();
 }
 

Parameters

Name	Description
project	String Project ID for this request.
zone	String The name of the zone for this request.
nodeGroup	String Name of the NodeGroup resource to update.
nodeGroupResource	NodeGroup The body resource for this request

Returns

Type	Description
OperationFuture<Operation,Operation>

patchCallable()

public final UnaryCallable<PatchNodeGroupRequest,Operation> patchCallable()

Updates the specified node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   PatchNodeGroupRequest request =
       PatchNodeGroupRequest.newBuilder()
           .setNodeGroup("nodeGroup443599261")
           .setNodeGroupResource(NodeGroup.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   ApiFuture<Operation> future = nodeGroupsClient.patchCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 

Returns

Type	Description
UnaryCallable<PatchNodeGroupRequest,Operation>

patchOperationCallable()

public final OperationCallable<PatchNodeGroupRequest,Operation,Operation> patchOperationCallable()

Updates the specified node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   PatchNodeGroupRequest request =
       PatchNodeGroupRequest.newBuilder()
           .setNodeGroup("nodeGroup443599261")
           .setNodeGroupResource(NodeGroup.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   OperationFuture

Returns

Type	Description
OperationCallable<PatchNodeGroupRequest,Operation,Operation>

setIamPolicy(SetIamPolicyNodeGroupRequest request)

public final Policy setIamPolicy(SetIamPolicyNodeGroupRequest request)

Sets the access control policy on the specified resource. Replaces any existing policy.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   SetIamPolicyNodeGroupRequest request =
       SetIamPolicyNodeGroupRequest.newBuilder()
           .setProject("project-309310695")
           .setResource("resource-341064690")
           .setZone("zone3744684")
           .setZoneSetPolicyRequestResource(ZoneSetPolicyRequest.newBuilder().build())
           .build();
   Policy response = nodeGroupsClient.setIamPolicy(request);
 }
 

Parameter

Name	Description
request	SetIamPolicyNodeGroupRequest The request object containing all of the parameters for the API call.

Returns

Type	Description
Policy

setIamPolicy(String project, String zone, String resource, ZoneSetPolicyRequest zoneSetPolicyRequestResource)

public final Policy setIamPolicy(String project, String zone, String resource, ZoneSetPolicyRequest zoneSetPolicyRequestResource)

Sets the access control policy on the specified resource. Replaces any existing policy.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   String project = "project-309310695";
   String zone = "zone3744684";
   String resource = "resource-341064690";
   ZoneSetPolicyRequest zoneSetPolicyRequestResource = ZoneSetPolicyRequest.newBuilder().build();
   Policy response =
       nodeGroupsClient.setIamPolicy(project, zone, resource, zoneSetPolicyRequestResource);
 }
 

Parameters

Name	Description
project	String Project ID for this request.
zone	String The name of the zone for this request.
resource	String Name or id of the resource for this request.
zoneSetPolicyRequestResource	ZoneSetPolicyRequest The body resource for this request

Returns

Type	Description
Policy

setIamPolicyCallable()

public final UnaryCallable<SetIamPolicyNodeGroupRequest,Policy> setIamPolicyCallable()

Sets the access control policy on the specified resource. Replaces any existing policy.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   SetIamPolicyNodeGroupRequest request =
       SetIamPolicyNodeGroupRequest.newBuilder()
           .setProject("project-309310695")
           .setResource("resource-341064690")
           .setZone("zone3744684")
           .setZoneSetPolicyRequestResource(ZoneSetPolicyRequest.newBuilder().build())
           .build();
   ApiFuture<Policy> future = nodeGroupsClient.setIamPolicyCallable().futureCall(request);
   // Do something.
   Policy response = future.get();
 }
 

Returns

Type	Description
UnaryCallable<SetIamPolicyNodeGroupRequest,Policy>

setNodeTemplateAsync(SetNodeTemplateNodeGroupRequest request)

public final OperationFuture<Operation,Operation> setNodeTemplateAsync(SetNodeTemplateNodeGroupRequest request)

Updates the node template of the node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   SetNodeTemplateNodeGroupRequest request =
       SetNodeTemplateNodeGroupRequest.newBuilder()
           .setNodeGroup("nodeGroup443599261")
           .setNodeGroupsSetNodeTemplateRequestResource(
               NodeGroupsSetNodeTemplateRequest.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   Operation response = nodeGroupsClient.setNodeTemplateAsync(request).get();
 }
 

Parameter

Name	Description
request	SetNodeTemplateNodeGroupRequest The request object containing all of the parameters for the API call.

Returns

Type	Description
OperationFuture<Operation,Operation>

setNodeTemplateAsync(String project, String zone, String nodeGroup, NodeGroupsSetNodeTemplateRequest nodeGroupsSetNodeTemplateRequestResource)

public final OperationFuture<Operation,Operation> setNodeTemplateAsync(String project, String zone, String nodeGroup, NodeGroupsSetNodeTemplateRequest nodeGroupsSetNodeTemplateRequestResource)

Updates the node template of the node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   String project = "project-309310695";
   String zone = "zone3744684";
   String nodeGroup = "nodeGroup443599261";
   NodeGroupsSetNodeTemplateRequest nodeGroupsSetNodeTemplateRequestResource =
       NodeGroupsSetNodeTemplateRequest.newBuilder().build();
   Operation response =
       nodeGroupsClient
           .setNodeTemplateAsync(
               project, zone, nodeGroup, nodeGroupsSetNodeTemplateRequestResource)
           .get();
 }
 

Parameters

Name	Description
project	String Project ID for this request.
zone	String The name of the zone for this request.
nodeGroup	String Name of the NodeGroup resource to update.
nodeGroupsSetNodeTemplateRequestResource	NodeGroupsSetNodeTemplateRequest The body resource for this request

Returns

Type	Description
OperationFuture<Operation,Operation>

setNodeTemplateCallable()

public final UnaryCallable<SetNodeTemplateNodeGroupRequest,Operation> setNodeTemplateCallable()

Updates the node template of the node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   SetNodeTemplateNodeGroupRequest request =
       SetNodeTemplateNodeGroupRequest.newBuilder()
           .setNodeGroup("nodeGroup443599261")
           .setNodeGroupsSetNodeTemplateRequestResource(
               NodeGroupsSetNodeTemplateRequest.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   ApiFuture<Operation> future = nodeGroupsClient.setNodeTemplateCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 

Returns

Type	Description
UnaryCallable<SetNodeTemplateNodeGroupRequest,Operation>

setNodeTemplateOperationCallable()

public final OperationCallable<SetNodeTemplateNodeGroupRequest,Operation,Operation> setNodeTemplateOperationCallable()

Updates the node template of the node group.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   SetNodeTemplateNodeGroupRequest request =
       SetNodeTemplateNodeGroupRequest.newBuilder()
           .setNodeGroup("nodeGroup443599261")
           .setNodeGroupsSetNodeTemplateRequestResource(
               NodeGroupsSetNodeTemplateRequest.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   OperationFuture

Returns

Type	Description
OperationCallable<SetNodeTemplateNodeGroupRequest,Operation,Operation>

shutdown()

public void shutdown()

shutdownNow()

public void shutdownNow()

testIamPermissions(TestIamPermissionsNodeGroupRequest request)

public final TestPermissionsResponse testIamPermissions(TestIamPermissionsNodeGroupRequest request)

Returns permissions that a caller has on the specified resource.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   TestIamPermissionsNodeGroupRequest request =
       TestIamPermissionsNodeGroupRequest.newBuilder()
           .setProject("project-309310695")
           .setResource("resource-341064690")
           .setTestPermissionsRequestResource(TestPermissionsRequest.newBuilder().build())
           .setZone("zone3744684")
           .build();
   TestPermissionsResponse response = nodeGroupsClient.testIamPermissions(request);
 }
 

Parameter

Name	Description
request	TestIamPermissionsNodeGroupRequest The request object containing all of the parameters for the API call.

Returns

Type	Description
TestPermissionsResponse

testIamPermissions(String project, String zone, String resource, TestPermissionsRequest testPermissionsRequestResource)

public final TestPermissionsResponse testIamPermissions(String project, String zone, String resource, TestPermissionsRequest testPermissionsRequestResource)

Returns permissions that a caller has on the specified resource.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   String project = "project-309310695";
   String zone = "zone3744684";
   String resource = "resource-341064690";
   TestPermissionsRequest testPermissionsRequestResource =
       TestPermissionsRequest.newBuilder().build();
   TestPermissionsResponse response =
       nodeGroupsClient.testIamPermissions(
           project, zone, resource, testPermissionsRequestResource);
 }
 

Parameters

Name	Description
project	String Project ID for this request.
zone	String The name of the zone for this request.
resource	String Name or id of the resource for this request.
testPermissionsRequestResource	TestPermissionsRequest The body resource for this request

Returns

Type	Description
TestPermissionsResponse

testIamPermissionsCallable()

public final UnaryCallable<TestIamPermissionsNodeGroupRequest,TestPermissionsResponse> testIamPermissionsCallable()

Returns permissions that a caller has on the specified resource.

Sample code:

 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   TestIamPermissionsNodeGroupRequest request =
       TestIamPermissionsNodeGroupRequest.newBuilder()
           .setProject("project-309310695")
           .setResource("resource-341064690")
           .setTestPermissionsRequestResource(TestPermissionsRequest.newBuilder().build())
           .setZone("zone3744684")
           .build();
   ApiFuture

Returns

Type	Description
UnaryCallable<TestIamPermissionsNodeGroupRequest,TestPermissionsResponse>