Class NodeGroupsClient (1.88.0)

GitHub RepositoryProduct Reference

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:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 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().

Methods
Method Description Method Variants

AddNodes

Adds specified number of nodes to the node group.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • addNodesAsync(AddNodesNodeGroupRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

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

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • addNodesOperationCallable()

  • addNodesCallable()

AggregatedList

Retrieves an aggregated list of node groups. Note: use nodeGroups.listNodes for more details about each group. To prevent failure, Google recommends that you set the returnPartialSuccess parameter to true.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • aggregatedList(AggregatedListNodeGroupsRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • aggregatedList(String project)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • aggregatedListPagedCallable()

  • aggregatedListCallable()

Delete

Deletes the specified NodeGroup resource.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • deleteAsync(DeleteNodeGroupRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

  • deleteAsync(String project, String zone, String nodeGroup)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • deleteOperationCallable()

  • deleteCallable()

DeleteNodes

Deletes specified nodes from the node group.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • deleteNodesAsync(DeleteNodesNodeGroupRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

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

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • deleteNodesOperationCallable()

  • deleteNodesCallable()

Get

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.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • get(GetNodeGroupRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • get(String project, String zone, String nodeGroup)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • getCallable()

GetIamPolicy

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

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • getIamPolicy(GetIamPolicyNodeGroupRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • getIamPolicy(String project, String zone, String resource)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • getIamPolicyCallable()

Insert

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

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • insertAsync(InsertNodeGroupRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

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

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • insertOperationCallable()

  • insertCallable()

List

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

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • list(ListNodeGroupsRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • list(String project, String zone)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • listPagedCallable()

  • listCallable()

ListNodes

Lists nodes in the node group.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • listNodes(ListNodesNodeGroupsRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • listNodes(String project, String zone, String nodeGroup)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • listNodesPagedCallable()

  • listNodesCallable()

Patch

Updates the specified node group.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • patchAsync(PatchNodeGroupRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

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

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • patchOperationCallable()

  • patchCallable()

PerformMaintenance

Perform maintenance on a subset of nodes in the node group.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • performMaintenanceAsync(PerformMaintenanceNodeGroupRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

  • performMaintenanceAsync(String project, String zone, String nodeGroup, NodeGroupsPerformMaintenanceRequest nodeGroupsPerformMaintenanceRequestResource)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • performMaintenanceOperationCallable()

  • performMaintenanceCallable()

SetIamPolicy

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

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • setIamPolicy(SetIamPolicyNodeGroupRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

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

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • setIamPolicyCallable()

SetNodeTemplate

Updates the node template of the node group.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • setNodeTemplateAsync(SetNodeTemplateNodeGroupRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

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

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • setNodeTemplateOperationCallable()

  • setNodeTemplateCallable()

SimulateMaintenanceEvent

Simulates maintenance event on specified nodes from the node group.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • simulateMaintenanceEventAsync(SimulateMaintenanceEventNodeGroupRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

  • simulateMaintenanceEventAsync(String project, String zone, String nodeGroup, NodeGroupsSimulateMaintenanceEventRequest nodeGroupsSimulateMaintenanceEventRequestResource)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • simulateMaintenanceEventOperationCallable()

  • simulateMaintenanceEventCallable()

TestIamPermissions

Returns permissions that a caller has on the specified resource.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • testIamPermissions(TestIamPermissionsNodeGroupRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

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

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • testIamPermissionsCallable()

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:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 NodeGroupsSettings nodeGroupsSettings =
     NodeGroupsSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create(nodeGroupsSettings);

To customize the endpoint:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 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

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:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 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:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 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:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 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:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   AddNodesNodeGroupRequest request =
       AddNodesNodeGroupRequest.newBuilder()
           .setNodeGroup("nodeGroup443599261")
           .setNodeGroupsAddNodesRequestResource(NodeGroupsAddNodesRequest.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .setZone("zone3744684")
           .build();
   OperationFuture<Operation, Operation> future =
       nodeGroupsClient.addNodesOperationCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
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. To prevent failure, Google recommends that you set the returnPartialSuccess parameter to true.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 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)
           .setServiceProjectNumber(-1293855239)
           .build();
   for (Map.Entry<String, NodeGroupsScopedList> element :
       nodeGroupsClient.aggregatedList(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
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. To prevent failure, Google recommends that you set the returnPartialSuccess parameter to true.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (NodeGroupsClient nodeGroupsClient = NodeGroupsClient.create()) {
   String project = "project-309310695";
   for (Map.Entry<String, NodeGroupsScopedList> element :
       nodeGroupsClient.aggregatedList(project).iterateAll()) {
     // doThingsWith(element);
   }
 }
Parameter
Name Description
project String

Project ID for this request.