Class OrganizationAddressGroupServiceClient (0.77.0)

Service Description: Organization AddressGroup is created under organization. Requests against Organization AddressGroup will use project from request credential for activation/quota/visibility check.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   AddressGroupName name =
       AddressGroupName.ofOrganizationLocationAddressGroupName(
           "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]");
   AddressGroup response = organizationAddressGroupServiceClient.getAddressGroup(name);
 }

Note: close() needs to be called on the OrganizationAddressGroupServiceClient 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
ListAddressGroups	Lists address groups in a given project and location.	Request object method variants only take one parameter, a request object, which must be constructed before the call. listAddressGroups(ListAddressGroupsRequest request) "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. listAddressGroups(LocationName parent) listAddressGroups(String parent) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. listAddressGroupsPagedCallable() listAddressGroupsCallable()
GetAddressGroup	Gets details of a single address group.	Request object method variants only take one parameter, a request object, which must be constructed before the call. getAddressGroup(GetAddressGroupRequest request) "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. getAddressGroup(AddressGroupName name) getAddressGroup(String name) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. getAddressGroupCallable()
CreateAddressGroup	Creates a new address group in a given project and location.	Request object method variants only take one parameter, a request object, which must be constructed before the call. createAddressGroupAsync(CreateAddressGroupRequest request) Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. createAddressGroupAsync(LocationName parent, AddressGroup addressGroup, String addressGroupId) createAddressGroupAsync(OrganizationLocationName parent, AddressGroup addressGroup, String addressGroupId) createAddressGroupAsync(String parent, AddressGroup addressGroup, String addressGroupId) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. createAddressGroupOperationCallable() createAddressGroupCallable()
UpdateAddressGroup	Updates parameters of an address group.	Request object method variants only take one parameter, a request object, which must be constructed before the call. updateAddressGroupAsync(UpdateAddressGroupRequest request) Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. updateAddressGroupAsync(AddressGroup addressGroup, FieldMask updateMask) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. updateAddressGroupOperationCallable() updateAddressGroupCallable()
AddAddressGroupItems	Adds items to an address group.	Request object method variants only take one parameter, a request object, which must be constructed before the call. addAddressGroupItemsAsync(AddAddressGroupItemsRequest request) Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. addAddressGroupItemsAsync(AddressGroupName addressGroup, List<String> items) addAddressGroupItemsAsync(String addressGroup, List<String> items) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. addAddressGroupItemsOperationCallable() addAddressGroupItemsCallable()
RemoveAddressGroupItems	Removes items from an address group.	Request object method variants only take one parameter, a request object, which must be constructed before the call. removeAddressGroupItemsAsync(RemoveAddressGroupItemsRequest request) Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. removeAddressGroupItemsAsync(AddressGroupName addressGroup, List<String> items) removeAddressGroupItemsAsync(String addressGroup, List<String> items) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. removeAddressGroupItemsOperationCallable() removeAddressGroupItemsCallable()
CloneAddressGroupItems	Clones items from one address group to another.	Request object method variants only take one parameter, a request object, which must be constructed before the call. cloneAddressGroupItemsAsync(CloneAddressGroupItemsRequest request) Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. cloneAddressGroupItemsAsync(AddressGroupName addressGroup, AddressGroupName sourceAddressGroup) cloneAddressGroupItemsAsync(AddressGroupName addressGroup, String sourceAddressGroup) cloneAddressGroupItemsAsync(String addressGroup, AddressGroupName sourceAddressGroup) cloneAddressGroupItemsAsync(String addressGroup, String sourceAddressGroup) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. cloneAddressGroupItemsOperationCallable() cloneAddressGroupItemsCallable()
DeleteAddressGroup	Deletes an address group.	Request object method variants only take one parameter, a request object, which must be constructed before the call. deleteAddressGroupAsync(DeleteAddressGroupRequest request) Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. deleteAddressGroupAsync(AddressGroupName name) deleteAddressGroupAsync(String name) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. deleteAddressGroupOperationCallable() deleteAddressGroupCallable()
ListAddressGroupReferences	Lists references of an address group.	Request object method variants only take one parameter, a request object, which must be constructed before the call. listAddressGroupReferences(ListAddressGroupReferencesRequest request) "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. listAddressGroupReferences(AddressGroupName addressGroup) listAddressGroupReferences(String addressGroup) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. listAddressGroupReferencesPagedCallable() listAddressGroupReferencesCallable()
ListLocations	Lists information about the supported locations for this service.	Request object method variants only take one parameter, a request object, which must be constructed before the call. listLocations(ListLocationsRequest request) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. listLocationsPagedCallable() listLocationsCallable()
GetLocation	Gets information about a location.	Request object method variants only take one parameter, a request object, which must be constructed before the call. getLocation(GetLocationRequest request) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. getLocationCallable()
SetIamPolicy	Sets the access control policy on the specified resource. Replacesany existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.	Request object method variants only take one parameter, a request object, which must be constructed before the call. setIamPolicy(SetIamPolicyRequest request) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. setIamPolicyCallable()
GetIamPolicy	Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.	Request object method variants only take one parameter, a request object, which must be constructed before the call. getIamPolicy(GetIamPolicyRequest request) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. getIamPolicyCallable()
TestIamPermissions	Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.	Request object method variants only take one parameter, a request object, which must be constructed before the call. testIamPermissions(TestIamPermissionsRequest request) 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 OrganizationAddressGroupServiceSettings 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
 OrganizationAddressGroupServiceSettings organizationAddressGroupServiceSettings =
     OrganizationAddressGroupServiceSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create(organizationAddressGroupServiceSettings);

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
 OrganizationAddressGroupServiceSettings organizationAddressGroupServiceSettings =
     OrganizationAddressGroupServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
 OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create(organizationAddressGroupServiceSettings);

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

Inheritance

java.lang.Object > OrganizationAddressGroupServiceClient

Static Methods

create()

public static final OrganizationAddressGroupServiceClient create()

Constructs an instance of OrganizationAddressGroupServiceClient with default settings.

Returns
Type	Description
`OrganizationAddressGroupServiceClient`

Exceptions
Type	Description
`IOException`

create(OrganizationAddressGroupServiceSettings settings)

public static final OrganizationAddressGroupServiceClient create(OrganizationAddressGroupServiceSettings settings)

Constructs an instance of OrganizationAddressGroupServiceClient, 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`	`OrganizationAddressGroupServiceSettings`

Returns
Type	Description
`OrganizationAddressGroupServiceClient`

Exceptions
Type	Description
`IOException`

create(OrganizationAddressGroupServiceStub stub)

public static final OrganizationAddressGroupServiceClient create(OrganizationAddressGroupServiceStub stub)

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

Parameter
Name	Description
`stub`	`OrganizationAddressGroupServiceStub`

Returns
Type	Description
`OrganizationAddressGroupServiceClient`

Constructors

OrganizationAddressGroupServiceClient(OrganizationAddressGroupServiceSettings settings)

protected OrganizationAddressGroupServiceClient(OrganizationAddressGroupServiceSettings settings)

Constructs an instance of OrganizationAddressGroupServiceClient, 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`	`OrganizationAddressGroupServiceSettings`

OrganizationAddressGroupServiceClient(OrganizationAddressGroupServiceStub stub)

protected OrganizationAddressGroupServiceClient(OrganizationAddressGroupServiceStub stub)

Parameter
Name	Description
`stub`	`OrganizationAddressGroupServiceStub`

Methods

addAddressGroupItemsAsync(AddAddressGroupItemsRequest request)

public final OperationFuture<AddressGroup,OperationMetadata> addAddressGroupItemsAsync(AddAddressGroupItemsRequest request)

Adds items to an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   AddAddressGroupItemsRequest request =
       AddAddressGroupItemsRequest.newBuilder()
           .setAddressGroup(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .addAllItems(new ArrayList<String>())
           .setRequestId("requestId693933066")
           .build();
   AddressGroup response =
       organizationAddressGroupServiceClient.addAddressGroupItemsAsync(request).get();
 }

Parameter
Name	Description
`request`	`AddAddressGroupItemsRequest` The request object containing all of the parameters for the API call.

Returns
Type	Description
`OperationFuture<AddressGroup,OperationMetadata>`

addAddressGroupItemsAsync(AddressGroupName addressGroup, List<String> items)

public final OperationFuture<AddressGroup,OperationMetadata> addAddressGroupItemsAsync(AddressGroupName addressGroup, List<String> items)

Adds items to an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   AddressGroupName addressGroup =
       AddressGroupName.ofOrganizationLocationAddressGroupName(
           "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]");
   List<String> items = new ArrayList<>();
   AddressGroup response =
       organizationAddressGroupServiceClient
           .addAddressGroupItemsAsync(addressGroup, items)
           .get();
 }

Parameters
Name	Description
`addressGroup`	`AddressGroupName` Required. A name of the AddressGroup to add items to. Must be in the format `projects\|organization//locations/{location}/addressGroups/`.
`items`	`List<String>` Required. List of items to add.

Returns
Type	Description
`OperationFuture<AddressGroup,OperationMetadata>`

addAddressGroupItemsAsync(String addressGroup, List<String> items)

public final OperationFuture<AddressGroup,OperationMetadata> addAddressGroupItemsAsync(String addressGroup, List<String> items)

Adds items to an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   String addressGroup =
       AddressGroupName.ofProjectLocationAddressGroupName(
               "[PROJECT]", "[LOCATION]", "[ADDRESS_GROUP]")
           .toString();
   List<String> items = new ArrayList<>();
   AddressGroup response =
       organizationAddressGroupServiceClient
           .addAddressGroupItemsAsync(addressGroup, items)
           .get();
 }

Parameters
Name	Description
`addressGroup`	`String` Required. A name of the AddressGroup to add items to. Must be in the format `projects\|organization//locations/{location}/addressGroups/`.
`items`	`List<String>` Required. List of items to add.

Returns
Type	Description
`OperationFuture<AddressGroup,OperationMetadata>`

addAddressGroupItemsCallable()

public final UnaryCallable<AddAddressGroupItemsRequest,Operation> addAddressGroupItemsCallable()

Adds items to an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   AddAddressGroupItemsRequest request =
       AddAddressGroupItemsRequest.newBuilder()
           .setAddressGroup(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .addAllItems(new ArrayList<String>())
           .setRequestId("requestId693933066")
           .build();
   ApiFuture<Operation> future =
       organizationAddressGroupServiceClient.addAddressGroupItemsCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }

Returns
Type	Description
`UnaryCallable<AddAddressGroupItemsRequest,Operation>`

addAddressGroupItemsOperationCallable()

public final OperationCallable<AddAddressGroupItemsRequest,AddressGroup,OperationMetadata> addAddressGroupItemsOperationCallable()

Adds items to an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   AddAddressGroupItemsRequest request =
       AddAddressGroupItemsRequest.newBuilder()
           .setAddressGroup(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .addAllItems(new ArrayList<String>())
           .setRequestId("requestId693933066")
           .build();
   OperationFuture<AddressGroup, OperationMetadata> future =
       organizationAddressGroupServiceClient
           .addAddressGroupItemsOperationCallable()
           .futureCall(request);
   // Do something.
   AddressGroup response = future.get();
 }

Returns
Type	Description
`OperationCallable<AddAddressGroupItemsRequest,AddressGroup,OperationMetadata>`

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`

cloneAddressGroupItemsAsync(AddressGroupName addressGroup, AddressGroupName sourceAddressGroup)

public final OperationFuture<AddressGroup,OperationMetadata> cloneAddressGroupItemsAsync(AddressGroupName addressGroup, AddressGroupName sourceAddressGroup)

Clones items from one address group to another.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   AddressGroupName addressGroup =
       AddressGroupName.ofOrganizationLocationAddressGroupName(
           "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]");
   AddressGroupName sourceAddressGroup =
       AddressGroupName.ofOrganizationLocationAddressGroupName(
           "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]");
   AddressGroup response =
       organizationAddressGroupServiceClient
           .cloneAddressGroupItemsAsync(addressGroup, sourceAddressGroup)
           .get();
 }

Parameters
Name	Description
`addressGroup`	`AddressGroupName` Required. A name of the AddressGroup to clone items to. Must be in the format `projects\|organization//locations/{location}/addressGroups/`.
`sourceAddressGroup`	`AddressGroupName` Required. Source address group to clone items from.

Returns
Type	Description
`OperationFuture<AddressGroup,OperationMetadata>`

cloneAddressGroupItemsAsync(AddressGroupName addressGroup, String sourceAddressGroup)

public final OperationFuture<AddressGroup,OperationMetadata> cloneAddressGroupItemsAsync(AddressGroupName addressGroup, String sourceAddressGroup)

Clones items from one address group to another.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   AddressGroupName addressGroup =
       AddressGroupName.ofOrganizationLocationAddressGroupName(
           "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]");
   String sourceAddressGroup =
       AddressGroupName.ofProjectLocationAddressGroupName(
               "[PROJECT]", "[LOCATION]", "[ADDRESS_GROUP]")
           .toString();
   AddressGroup response =
       organizationAddressGroupServiceClient
           .cloneAddressGroupItemsAsync(addressGroup, sourceAddressGroup)
           .get();
 }

Parameters
Name	Description
`addressGroup`	`AddressGroupName` Required. A name of the AddressGroup to clone items to. Must be in the format `projects\|organization//locations/{location}/addressGroups/`.
`sourceAddressGroup`	`String` Required. Source address group to clone items from.

Returns
Type	Description
`OperationFuture<AddressGroup,OperationMetadata>`

cloneAddressGroupItemsAsync(CloneAddressGroupItemsRequest request)

public final OperationFuture<AddressGroup,OperationMetadata> cloneAddressGroupItemsAsync(CloneAddressGroupItemsRequest request)

Clones items from one address group to another.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   CloneAddressGroupItemsRequest request =
       CloneAddressGroupItemsRequest.newBuilder()
           .setAddressGroup(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .setSourceAddressGroup(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .setRequestId("requestId693933066")
           .build();
   AddressGroup response =
       organizationAddressGroupServiceClient.cloneAddressGroupItemsAsync(request).get();
 }

Parameter
Name	Description
`request`	`CloneAddressGroupItemsRequest` The request object containing all of the parameters for the API call.

Returns
Type	Description
`OperationFuture<AddressGroup,OperationMetadata>`

cloneAddressGroupItemsAsync(String addressGroup, AddressGroupName sourceAddressGroup)

public final OperationFuture<AddressGroup,OperationMetadata> cloneAddressGroupItemsAsync(String addressGroup, AddressGroupName sourceAddressGroup)

Clones items from one address group to another.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   String addressGroup =
       AddressGroupName.ofProjectLocationAddressGroupName(
               "[PROJECT]", "[LOCATION]", "[ADDRESS_GROUP]")
           .toString();
   AddressGroupName sourceAddressGroup =
       AddressGroupName.ofOrganizationLocationAddressGroupName(
           "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]");
   AddressGroup response =
       organizationAddressGroupServiceClient
           .cloneAddressGroupItemsAsync(addressGroup, sourceAddressGroup)
           .get();
 }

Parameters
Name	Description
`addressGroup`	`String` Required. A name of the AddressGroup to clone items to. Must be in the format `projects\|organization//locations/{location}/addressGroups/`.
`sourceAddressGroup`	`AddressGroupName` Required. Source address group to clone items from.

Returns
Type	Description
`OperationFuture<AddressGroup,OperationMetadata>`

cloneAddressGroupItemsAsync(String addressGroup, String sourceAddressGroup)

public final OperationFuture<AddressGroup,OperationMetadata> cloneAddressGroupItemsAsync(String addressGroup, String sourceAddressGroup)

Clones items from one address group to another.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   String addressGroup =
       AddressGroupName.ofProjectLocationAddressGroupName(
               "[PROJECT]", "[LOCATION]", "[ADDRESS_GROUP]")
           .toString();
   String sourceAddressGroup =
       AddressGroupName.ofProjectLocationAddressGroupName(
               "[PROJECT]", "[LOCATION]", "[ADDRESS_GROUP]")
           .toString();
   AddressGroup response =
       organizationAddressGroupServiceClient
           .cloneAddressGroupItemsAsync(addressGroup, sourceAddressGroup)
           .get();
 }

Parameters
Name	Description
`addressGroup`	`String` Required. A name of the AddressGroup to clone items to. Must be in the format `projects\|organization//locations/{location}/addressGroups/`.
`sourceAddressGroup`	`String` Required. Source address group to clone items from.

Returns
Type	Description
`OperationFuture<AddressGroup,OperationMetadata>`

cloneAddressGroupItemsCallable()

public final UnaryCallable<CloneAddressGroupItemsRequest,Operation> cloneAddressGroupItemsCallable()

Clones items from one address group to another.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   CloneAddressGroupItemsRequest request =
       CloneAddressGroupItemsRequest.newBuilder()
           .setAddressGroup(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .setSourceAddressGroup(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .setRequestId("requestId693933066")
           .build();
   ApiFuture<Operation> future =
       organizationAddressGroupServiceClient
           .cloneAddressGroupItemsCallable()
           .futureCall(request);
   // Do something.
   Operation response = future.get();
 }

Returns
Type	Description
`UnaryCallable<CloneAddressGroupItemsRequest,Operation>`

cloneAddressGroupItemsOperationCallable()

public final OperationCallable<CloneAddressGroupItemsRequest,AddressGroup,OperationMetadata> cloneAddressGroupItemsOperationCallable()

Clones items from one address group to another.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   CloneAddressGroupItemsRequest request =
       CloneAddressGroupItemsRequest.newBuilder()
           .setAddressGroup(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .setSourceAddressGroup(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .setRequestId("requestId693933066")
           .build();
   OperationFuture<AddressGroup, OperationMetadata> future =
       organizationAddressGroupServiceClient
           .cloneAddressGroupItemsOperationCallable()
           .futureCall(request);
   // Do something.
   AddressGroup response = future.get();
 }

Returns
Type	Description
`OperationCallable<CloneAddressGroupItemsRequest,AddressGroup,OperationMetadata>`

close()

public final void close()

createAddressGroupAsync(CreateAddressGroupRequest request)

public final OperationFuture<AddressGroup,OperationMetadata> createAddressGroupAsync(CreateAddressGroupRequest request)

Creates a new address group in a given project and location.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   CreateAddressGroupRequest request =
       CreateAddressGroupRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setAddressGroupId("addressGroupId705215846")
           .setAddressGroup(AddressGroup.newBuilder().build())
           .setRequestId("requestId693933066")
           .build();
   AddressGroup response =
       organizationAddressGroupServiceClient.createAddressGroupAsync(request).get();
 }

Parameter
Name	Description
`request`	`CreateAddressGroupRequest` The request object containing all of the parameters for the API call.

Returns
Type	Description
`OperationFuture<AddressGroup,OperationMetadata>`

createAddressGroupAsync(LocationName parent, AddressGroup addressGroup, String addressGroupId)

public final OperationFuture<AddressGroup,OperationMetadata> createAddressGroupAsync(LocationName parent, AddressGroup addressGroup, String addressGroupId)

Creates a new address group in a given project and location.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
   AddressGroup addressGroup = AddressGroup.newBuilder().build();
   String addressGroupId = "addressGroupId705215846";
   AddressGroup response =
       organizationAddressGroupServiceClient
           .createAddressGroupAsync(parent, addressGroup, addressGroupId)
           .get();
 }

Parameters
Name	Description
`parent`	`LocationName` Required. The parent resource of the AddressGroup. Must be in the format `projects/*/locations/{location}`.
`addressGroup`	`AddressGroup` Required. AddressGroup resource to be created.
`addressGroupId`	`String` Required. Short name of the AddressGroup resource to be created. This value should be 1-63 characters long, containing only letters, numbers, hyphens, and underscores, and should not start with a number. E.g. "authz_policy".

Returns
Type	Description
`OperationFuture<AddressGroup,OperationMetadata>`

createAddressGroupAsync(OrganizationLocationName parent, AddressGroup addressGroup, String addressGroupId)

public final OperationFuture<AddressGroup,OperationMetadata> createAddressGroupAsync(OrganizationLocationName parent, AddressGroup addressGroup, String addressGroupId)

Creates a new address group in a given project and location.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   OrganizationLocationName parent = OrganizationLocationName.of("[ORGANIZATION]", "[LOCATION]");
   AddressGroup addressGroup = AddressGroup.newBuilder().build();
   String addressGroupId = "addressGroupId705215846";
   AddressGroup response =
       organizationAddressGroupServiceClient
           .createAddressGroupAsync(parent, addressGroup, addressGroupId)
           .get();
 }

Parameters
Name	Description
`parent`	`OrganizationLocationName` Required. The parent resource of the AddressGroup. Must be in the format `projects/*/locations/{location}`.
`addressGroup`	`AddressGroup` Required. AddressGroup resource to be created.
`addressGroupId`	`String` Required. Short name of the AddressGroup resource to be created. This value should be 1-63 characters long, containing only letters, numbers, hyphens, and underscores, and should not start with a number. E.g. "authz_policy".

Returns
Type	Description
`OperationFuture<AddressGroup,OperationMetadata>`

createAddressGroupAsync(String parent, AddressGroup addressGroup, String addressGroupId)

public final OperationFuture<AddressGroup,OperationMetadata> createAddressGroupAsync(String parent, AddressGroup addressGroup, String addressGroupId)

Creates a new address group in a given project and location.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
   AddressGroup addressGroup = AddressGroup.newBuilder().build();
   String addressGroupId = "addressGroupId705215846";
   AddressGroup response =
       organizationAddressGroupServiceClient
           .createAddressGroupAsync(parent, addressGroup, addressGroupId)
           .get();
 }

Parameters
Name	Description
`parent`	`String` Required. The parent resource of the AddressGroup. Must be in the format `projects/*/locations/{location}`.
`addressGroup`	`AddressGroup` Required. AddressGroup resource to be created.
`addressGroupId`	`String` Required. Short name of the AddressGroup resource to be created. This value should be 1-63 characters long, containing only letters, numbers, hyphens, and underscores, and should not start with a number. E.g. "authz_policy".

Returns
Type	Description
`OperationFuture<AddressGroup,OperationMetadata>`

createAddressGroupCallable()

public final UnaryCallable<CreateAddressGroupRequest,Operation> createAddressGroupCallable()

Creates a new address group in a given project and location.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   CreateAddressGroupRequest request =
       CreateAddressGroupRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setAddressGroupId("addressGroupId705215846")
           .setAddressGroup(AddressGroup.newBuilder().build())
           .setRequestId("requestId693933066")
           .build();
   ApiFuture<Operation> future =
       organizationAddressGroupServiceClient.createAddressGroupCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }

Returns
Type	Description
`UnaryCallable<CreateAddressGroupRequest,Operation>`

createAddressGroupOperationCallable()

public final OperationCallable<CreateAddressGroupRequest,AddressGroup,OperationMetadata> createAddressGroupOperationCallable()

Creates a new address group in a given project and location.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   CreateAddressGroupRequest request =
       CreateAddressGroupRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setAddressGroupId("addressGroupId705215846")
           .setAddressGroup(AddressGroup.newBuilder().build())
           .setRequestId("requestId693933066")
           .build();
   OperationFuture<AddressGroup, OperationMetadata> future =
       organizationAddressGroupServiceClient
           .createAddressGroupOperationCallable()
           .futureCall(request);
   // Do something.
   AddressGroup response = future.get();
 }

Returns
Type	Description
`OperationCallable<CreateAddressGroupRequest,AddressGroup,OperationMetadata>`

deleteAddressGroupAsync(AddressGroupName name)

public final OperationFuture<Empty,OperationMetadata> deleteAddressGroupAsync(AddressGroupName name)

Deletes an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   AddressGroupName name =
       AddressGroupName.ofOrganizationLocationAddressGroupName(
           "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]");
   organizationAddressGroupServiceClient.deleteAddressGroupAsync(name).get();
 }

Parameter
Name	Description
`name`	`AddressGroupName` Required. A name of the AddressGroup to delete. Must be in the format `projects//locations/{location}/addressGroups/`.

Returns
Type	Description
`OperationFuture<Empty,OperationMetadata>`

deleteAddressGroupAsync(DeleteAddressGroupRequest request)

public final OperationFuture<Empty,OperationMetadata> deleteAddressGroupAsync(DeleteAddressGroupRequest request)

Deletes an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   DeleteAddressGroupRequest request =
       DeleteAddressGroupRequest.newBuilder()
           .setName(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .setRequestId("requestId693933066")
           .build();
   organizationAddressGroupServiceClient.deleteAddressGroupAsync(request).get();
 }

Parameter
Name	Description
`request`	`DeleteAddressGroupRequest` The request object containing all of the parameters for the API call.

Returns
Type	Description
`OperationFuture<Empty,OperationMetadata>`

deleteAddressGroupAsync(String name)

public final OperationFuture<Empty,OperationMetadata> deleteAddressGroupAsync(String name)

Deletes an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   String name =
       AddressGroupName.ofProjectLocationAddressGroupName(
               "[PROJECT]", "[LOCATION]", "[ADDRESS_GROUP]")
           .toString();
   organizationAddressGroupServiceClient.deleteAddressGroupAsync(name).get();
 }

Parameter
Name	Description
`name`	`String` Required. A name of the AddressGroup to delete. Must be in the format `projects//locations/{location}/addressGroups/`.

Returns
Type	Description
`OperationFuture<Empty,OperationMetadata>`

deleteAddressGroupCallable()

public final UnaryCallable<DeleteAddressGroupRequest,Operation> deleteAddressGroupCallable()

Deletes an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   DeleteAddressGroupRequest request =
       DeleteAddressGroupRequest.newBuilder()
           .setName(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .setRequestId("requestId693933066")
           .build();
   ApiFuture<Operation> future =
       organizationAddressGroupServiceClient.deleteAddressGroupCallable().futureCall(request);
   // Do something.
   future.get();
 }

Returns
Type	Description
`UnaryCallable<DeleteAddressGroupRequest,Operation>`

deleteAddressGroupOperationCallable()

public final OperationCallable<DeleteAddressGroupRequest,Empty,OperationMetadata> deleteAddressGroupOperationCallable()

Deletes an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   DeleteAddressGroupRequest request =
       DeleteAddressGroupRequest.newBuilder()
           .setName(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .setRequestId("requestId693933066")
           .build();
   OperationFuture<Empty, OperationMetadata> future =
       organizationAddressGroupServiceClient
           .deleteAddressGroupOperationCallable()
           .futureCall(request);
   // Do something.
   future.get();
 }

Returns
Type	Description
`OperationCallable<DeleteAddressGroupRequest,Empty,OperationMetadata>`

getAddressGroup(AddressGroupName name)

public final AddressGroup getAddressGroup(AddressGroupName name)

Gets details of a single address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   AddressGroupName name =
       AddressGroupName.ofOrganizationLocationAddressGroupName(
           "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]");
   AddressGroup response = organizationAddressGroupServiceClient.getAddressGroup(name);
 }

Parameter
Name	Description
`name`	`AddressGroupName` Required. A name of the AddressGroup to get. Must be in the format `projects//locations/{location}/addressGroups/`.

Returns
Type	Description
`AddressGroup`

getAddressGroup(GetAddressGroupRequest request)

public final AddressGroup getAddressGroup(GetAddressGroupRequest request)

Gets details of a single address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   GetAddressGroupRequest request =
       GetAddressGroupRequest.newBuilder()
           .setName(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .build();
   AddressGroup response = organizationAddressGroupServiceClient.getAddressGroup(request);
 }

Parameter
Name	Description
`request`	`GetAddressGroupRequest` The request object containing all of the parameters for the API call.

Returns
Type	Description
`AddressGroup`

getAddressGroup(String name)

public final AddressGroup getAddressGroup(String name)

Gets details of a single address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   String name =
       AddressGroupName.ofProjectLocationAddressGroupName(
               "[PROJECT]", "[LOCATION]", "[ADDRESS_GROUP]")
           .toString();
   AddressGroup response = organizationAddressGroupServiceClient.getAddressGroup(name);
 }

Parameter
Name	Description
`name`	`String` Required. A name of the AddressGroup to get. Must be in the format `projects//locations/{location}/addressGroups/`.

Returns
Type	Description
`AddressGroup`

getAddressGroupCallable()

public final UnaryCallable<GetAddressGroupRequest,AddressGroup> getAddressGroupCallable()

Gets details of a single address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   GetAddressGroupRequest request =
       GetAddressGroupRequest.newBuilder()
           .setName(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .build();
   ApiFuture<AddressGroup> future =
       organizationAddressGroupServiceClient.getAddressGroupCallable().futureCall(request);
   // Do something.
   AddressGroup response = future.get();
 }

Returns
Type	Description
`UnaryCallable<GetAddressGroupRequest,AddressGroup>`

getIamPolicy(GetIamPolicyRequest request)

public final Policy getIamPolicy(GetIamPolicyRequest request)

Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   GetIamPolicyRequest request =
       GetIamPolicyRequest.newBuilder()
           .setResource(
               AddressGroupName.ofProjectLocationAddressGroupName(
                       "[PROJECT]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .setOptions(GetPolicyOptions.newBuilder().build())
           .build();
   Policy response = organizationAddressGroupServiceClient.getIamPolicy(request);
 }

Parameter
Name	Description
`request`	`com.google.iam.v1.GetIamPolicyRequest` The request object containing all of the parameters for the API call.

Returns
Type	Description
`com.google.iam.v1.Policy`

getIamPolicyCallable()

public final UnaryCallable<GetIamPolicyRequest,Policy> getIamPolicyCallable()

Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   GetIamPolicyRequest request =
       GetIamPolicyRequest.newBuilder()
           .setResource(
               AddressGroupName.ofProjectLocationAddressGroupName(
                       "[PROJECT]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .setOptions(GetPolicyOptions.newBuilder().build())
           .build();
   ApiFuture<Policy> future =
       organizationAddressGroupServiceClient.getIamPolicyCallable().futureCall(request);
   // Do something.
   Policy response = future.get();
 }

Returns
Type	Description
`UnaryCallable<com.google.iam.v1.GetIamPolicyRequest,com.google.iam.v1.Policy>`

getLocation(GetLocationRequest request)

public final Location getLocation(GetLocationRequest request)

Gets information about a location.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   GetLocationRequest request = GetLocationRequest.newBuilder().setName("name3373707").build();
   Location response = organizationAddressGroupServiceClient.getLocation(request);
 }

Parameter
Name	Description
`request`	`com.google.cloud.location.GetLocationRequest` The request object containing all of the parameters for the API call.

Returns
Type	Description
`com.google.cloud.location.Location`

getLocationCallable()

public final UnaryCallable<GetLocationRequest,Location> getLocationCallable()

Gets information about a location.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   GetLocationRequest request = GetLocationRequest.newBuilder().setName("name3373707").build();
   ApiFuture<Location> future =
       organizationAddressGroupServiceClient.getLocationCallable().futureCall(request);
   // Do something.
   Location response = future.get();
 }

Returns
Type	Description
`UnaryCallable<com.google.cloud.location.GetLocationRequest,com.google.cloud.location.Location>`

getOperationsClient()

public final OperationsClient getOperationsClient()

Returns the OperationsClient that can be used to query the status of a long-running operation returned by another API method call.

Returns
Type	Description
`OperationsClient`

getSettings()

public final OrganizationAddressGroupServiceSettings getSettings()

Returns
Type	Description
`OrganizationAddressGroupServiceSettings`

getStub()

public OrganizationAddressGroupServiceStub getStub()

Returns
Type	Description
`OrganizationAddressGroupServiceStub`

isShutdown()

public boolean isShutdown()

Returns
Type	Description
`boolean`

isTerminated()

public boolean isTerminated()

Returns
Type	Description
`boolean`

listAddressGroupReferences(AddressGroupName addressGroup)

public final OrganizationAddressGroupServiceClient.ListAddressGroupReferencesPagedResponse listAddressGroupReferences(AddressGroupName addressGroup)

Lists references of an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   AddressGroupName addressGroup =
       AddressGroupName.ofOrganizationLocationAddressGroupName(
           "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]");
   for (ListAddressGroupReferencesResponse.AddressGroupReference element :
       organizationAddressGroupServiceClient
           .listAddressGroupReferences(addressGroup)
           .iterateAll()) {
     // doThingsWith(element);
   }
 }

Parameter
Name	Description
`addressGroup`	`AddressGroupName` Required. A name of the AddressGroup to clone items to. Must be in the format `projects\|organization//locations/{location}/addressGroups/`.

Returns
Type	Description
`OrganizationAddressGroupServiceClient.ListAddressGroupReferencesPagedResponse`

listAddressGroupReferences(ListAddressGroupReferencesRequest request)

public final OrganizationAddressGroupServiceClient.ListAddressGroupReferencesPagedResponse listAddressGroupReferences(ListAddressGroupReferencesRequest request)

Lists references of an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   ListAddressGroupReferencesRequest request =
       ListAddressGroupReferencesRequest.newBuilder()
           .setAddressGroup(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   for (ListAddressGroupReferencesResponse.AddressGroupReference element :
       organizationAddressGroupServiceClient.listAddressGroupReferences(request).iterateAll()) {
     // doThingsWith(element);
   }
 }

Parameter
Name	Description
`request`	`ListAddressGroupReferencesRequest` The request object containing all of the parameters for the API call.

Returns
Type	Description
`OrganizationAddressGroupServiceClient.ListAddressGroupReferencesPagedResponse`

listAddressGroupReferences(String addressGroup)

public final OrganizationAddressGroupServiceClient.ListAddressGroupReferencesPagedResponse listAddressGroupReferences(String addressGroup)

Lists references of an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   String addressGroup =
       AddressGroupName.ofProjectLocationAddressGroupName(
               "[PROJECT]", "[LOCATION]", "[ADDRESS_GROUP]")
           .toString();
   for (ListAddressGroupReferencesResponse.AddressGroupReference element :
       organizationAddressGroupServiceClient
           .listAddressGroupReferences(addressGroup)
           .iterateAll()) {
     // doThingsWith(element);
   }
 }

Parameter
Name	Description
`addressGroup`	`String` Required. A name of the AddressGroup to clone items to. Must be in the format `projects\|organization//locations/{location}/addressGroups/`.

Returns
Type	Description
`OrganizationAddressGroupServiceClient.ListAddressGroupReferencesPagedResponse`

listAddressGroupReferencesCallable()

public final UnaryCallable<ListAddressGroupReferencesRequest,ListAddressGroupReferencesResponse> listAddressGroupReferencesCallable()

Lists references of an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   ListAddressGroupReferencesRequest request =
       ListAddressGroupReferencesRequest.newBuilder()
           .setAddressGroup(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   while (true) {
     ListAddressGroupReferencesResponse response =
         organizationAddressGroupServiceClient
             .listAddressGroupReferencesCallable()
             .call(request);
     for (ListAddressGroupReferencesResponse.AddressGroupReference element :
         response.getAddressGroupReferencesList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }

Returns
Type	Description
`UnaryCallable<ListAddressGroupReferencesRequest,ListAddressGroupReferencesResponse>`

listAddressGroupReferencesPagedCallable()

public final UnaryCallable<ListAddressGroupReferencesRequest,OrganizationAddressGroupServiceClient.ListAddressGroupReferencesPagedResponse> listAddressGroupReferencesPagedCallable()

Lists references of an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   ListAddressGroupReferencesRequest request =
       ListAddressGroupReferencesRequest.newBuilder()
           .setAddressGroup(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   ApiFuture<ListAddressGroupReferencesResponse.AddressGroupReference> future =
       organizationAddressGroupServiceClient
           .listAddressGroupReferencesPagedCallable()
           .futureCall(request);
   // Do something.
   for (ListAddressGroupReferencesResponse.AddressGroupReference element :
       future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }

Returns
Type	Description
`UnaryCallable<ListAddressGroupReferencesRequest,ListAddressGroupReferencesPagedResponse>`

listAddressGroups(ListAddressGroupsRequest request)

public final OrganizationAddressGroupServiceClient.ListAddressGroupsPagedResponse listAddressGroups(ListAddressGroupsRequest request)

Lists address groups in a given project and location.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   ListAddressGroupsRequest request =
       ListAddressGroupsRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setReturnPartialSuccess(true)
           .build();
   for (AddressGroup element :
       organizationAddressGroupServiceClient.listAddressGroups(request).iterateAll()) {
     // doThingsWith(element);
   }
 }

Parameter
Name	Description
`request`	`ListAddressGroupsRequest` The request object containing all of the parameters for the API call.

Returns
Type	Description
`OrganizationAddressGroupServiceClient.ListAddressGroupsPagedResponse`

listAddressGroups(LocationName parent)

public final OrganizationAddressGroupServiceClient.ListAddressGroupsPagedResponse listAddressGroups(LocationName parent)

Lists address groups in a given project and location.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
   for (AddressGroup element :
       organizationAddressGroupServiceClient.listAddressGroups(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }

Parameter
Name	Description
`parent`	`LocationName` Required. The project and location from which the AddressGroups should be listed, specified in the format `projects/*/locations/{location}`.

Returns
Type	Description
`OrganizationAddressGroupServiceClient.ListAddressGroupsPagedResponse`

listAddressGroups(String parent)

public final OrganizationAddressGroupServiceClient.ListAddressGroupsPagedResponse listAddressGroups(String parent)

Lists address groups in a given project and location.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
   for (AddressGroup element :
       organizationAddressGroupServiceClient.listAddressGroups(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }

Parameter
Name	Description
`parent`	`String` Required. The project and location from which the AddressGroups should be listed, specified in the format `projects/*/locations/{location}`.

Returns
Type	Description
`OrganizationAddressGroupServiceClient.ListAddressGroupsPagedResponse`

listAddressGroupsCallable()

public final UnaryCallable<ListAddressGroupsRequest,ListAddressGroupsResponse> listAddressGroupsCallable()

Lists address groups in a given project and location.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   ListAddressGroupsRequest request =
       ListAddressGroupsRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setReturnPartialSuccess(true)
           .build();
   while (true) {
     ListAddressGroupsResponse response =
         organizationAddressGroupServiceClient.listAddressGroupsCallable().call(request);
     for (AddressGroup element : response.getAddressGroupsList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }

Returns
Type	Description
`UnaryCallable<ListAddressGroupsRequest,ListAddressGroupsResponse>`

listAddressGroupsPagedCallable()

public final UnaryCallable<ListAddressGroupsRequest,OrganizationAddressGroupServiceClient.ListAddressGroupsPagedResponse> listAddressGroupsPagedCallable()

Lists address groups in a given project and location.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   ListAddressGroupsRequest request =
       ListAddressGroupsRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setReturnPartialSuccess(true)
           .build();
   ApiFuture<AddressGroup> future =
       organizationAddressGroupServiceClient
           .listAddressGroupsPagedCallable()
           .futureCall(request);
   // Do something.
   for (AddressGroup element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }

Returns
Type	Description
`UnaryCallable<ListAddressGroupsRequest,ListAddressGroupsPagedResponse>`

listLocations(ListLocationsRequest request)

public final OrganizationAddressGroupServiceClient.ListLocationsPagedResponse listLocations(ListLocationsRequest request)

Lists information about the supported locations for this service.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   ListLocationsRequest request =
       ListLocationsRequest.newBuilder()
           .setName("name3373707")
           .setFilter("filter-1274492040")
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   for (Location element :
       organizationAddressGroupServiceClient.listLocations(request).iterateAll()) {
     // doThingsWith(element);
   }
 }

Parameter
Name	Description
`request`	`com.google.cloud.location.ListLocationsRequest` The request object containing all of the parameters for the API call.

Returns
Type	Description
`OrganizationAddressGroupServiceClient.ListLocationsPagedResponse`

listLocationsCallable()

public final UnaryCallable<ListLocationsRequest,ListLocationsResponse> listLocationsCallable()

Lists information about the supported locations for this service.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   ListLocationsRequest request =
       ListLocationsRequest.newBuilder()
           .setName("name3373707")
           .setFilter("filter-1274492040")
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   while (true) {
     ListLocationsResponse response =
         organizationAddressGroupServiceClient.listLocationsCallable().call(request);
     for (Location element : response.getLocationsList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }

Returns
Type	Description
`UnaryCallable<com.google.cloud.location.ListLocationsRequest,com.google.cloud.location.ListLocationsResponse>`

listLocationsPagedCallable()

public final UnaryCallable<ListLocationsRequest,OrganizationAddressGroupServiceClient.ListLocationsPagedResponse> listLocationsPagedCallable()

Lists information about the supported locations for this service.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   ListLocationsRequest request =
       ListLocationsRequest.newBuilder()
           .setName("name3373707")
           .setFilter("filter-1274492040")
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   ApiFuture<Location> future =
       organizationAddressGroupServiceClient.listLocationsPagedCallable().futureCall(request);
   // Do something.
   for (Location element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }

Returns
Type	Description
`UnaryCallable<com.google.cloud.location.ListLocationsRequest,ListLocationsPagedResponse>`

removeAddressGroupItemsAsync(AddressGroupName addressGroup, List<String> items)

public final OperationFuture<AddressGroup,OperationMetadata> removeAddressGroupItemsAsync(AddressGroupName addressGroup, List<String> items)

Removes items from an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   AddressGroupName addressGroup =
       AddressGroupName.ofOrganizationLocationAddressGroupName(
           "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]");
   List<String> items = new ArrayList<>();
   AddressGroup response =
       organizationAddressGroupServiceClient
           .removeAddressGroupItemsAsync(addressGroup, items)
           .get();
 }

Parameters
Name	Description
`addressGroup`	`AddressGroupName` Required. A name of the AddressGroup to remove items from. Must be in the format `projects\|organization//locations/{location}/addressGroups/`.
`items`	`List<String>` Required. List of items to remove.

Returns
Type	Description
`OperationFuture<AddressGroup,OperationMetadata>`

removeAddressGroupItemsAsync(RemoveAddressGroupItemsRequest request)

public final OperationFuture<AddressGroup,OperationMetadata> removeAddressGroupItemsAsync(RemoveAddressGroupItemsRequest request)

Removes items from an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   RemoveAddressGroupItemsRequest request =
       RemoveAddressGroupItemsRequest.newBuilder()
           .setAddressGroup(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .addAllItems(new ArrayList<String>())
           .setRequestId("requestId693933066")
           .build();
   AddressGroup response =
       organizationAddressGroupServiceClient.removeAddressGroupItemsAsync(request).get();
 }

Parameter
Name	Description
`request`	`RemoveAddressGroupItemsRequest` The request object containing all of the parameters for the API call.

Returns
Type	Description
`OperationFuture<AddressGroup,OperationMetadata>`

removeAddressGroupItemsAsync(String addressGroup, List<String> items)

public final OperationFuture<AddressGroup,OperationMetadata> removeAddressGroupItemsAsync(String addressGroup, List<String> items)

Removes items from an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   String addressGroup =
       AddressGroupName.ofProjectLocationAddressGroupName(
               "[PROJECT]", "[LOCATION]", "[ADDRESS_GROUP]")
           .toString();
   List<String> items = new ArrayList<>();
   AddressGroup response =
       organizationAddressGroupServiceClient
           .removeAddressGroupItemsAsync(addressGroup, items)
           .get();
 }

Parameters
Name	Description
`addressGroup`	`String` Required. A name of the AddressGroup to remove items from. Must be in the format `projects\|organization//locations/{location}/addressGroups/`.
`items`	`List<String>` Required. List of items to remove.

Returns
Type	Description
`OperationFuture<AddressGroup,OperationMetadata>`

removeAddressGroupItemsCallable()

public final UnaryCallable<RemoveAddressGroupItemsRequest,Operation> removeAddressGroupItemsCallable()

Removes items from an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   RemoveAddressGroupItemsRequest request =
       RemoveAddressGroupItemsRequest.newBuilder()
           .setAddressGroup(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .addAllItems(new ArrayList<String>())
           .setRequestId("requestId693933066")
           .build();
   ApiFuture<Operation> future =
       organizationAddressGroupServiceClient
           .removeAddressGroupItemsCallable()
           .futureCall(request);
   // Do something.
   Operation response = future.get();
 }

Returns
Type	Description
`UnaryCallable<RemoveAddressGroupItemsRequest,Operation>`

removeAddressGroupItemsOperationCallable()

public final OperationCallable<RemoveAddressGroupItemsRequest,AddressGroup,OperationMetadata> removeAddressGroupItemsOperationCallable()

Removes items from an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   RemoveAddressGroupItemsRequest request =
       RemoveAddressGroupItemsRequest.newBuilder()
           .setAddressGroup(
               AddressGroupName.ofOrganizationLocationAddressGroupName(
                       "[ORGANIZATION]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .addAllItems(new ArrayList<String>())
           .setRequestId("requestId693933066")
           .build();
   OperationFuture<AddressGroup, OperationMetadata> future =
       organizationAddressGroupServiceClient
           .removeAddressGroupItemsOperationCallable()
           .futureCall(request);
   // Do something.
   AddressGroup response = future.get();
 }

Returns
Type	Description
`OperationCallable<RemoveAddressGroupItemsRequest,AddressGroup,OperationMetadata>`

setIamPolicy(SetIamPolicyRequest request)

public final Policy setIamPolicy(SetIamPolicyRequest request)

Sets the access control policy on the specified resource. Replacesany existing policy.

Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIEDerrors.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   SetIamPolicyRequest request =
       SetIamPolicyRequest.newBuilder()
           .setResource(
               AddressGroupName.ofProjectLocationAddressGroupName(
                       "[PROJECT]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .setPolicy(Policy.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   Policy response = organizationAddressGroupServiceClient.setIamPolicy(request);
 }

Parameter
Name	Description
`request`	`com.google.iam.v1.SetIamPolicyRequest` The request object containing all of the parameters for the API call.

Returns
Type	Description
`com.google.iam.v1.Policy`

setIamPolicyCallable()

public final UnaryCallable<SetIamPolicyRequest,Policy> setIamPolicyCallable()

Sets the access control policy on the specified resource. Replacesany existing policy.

Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIEDerrors.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   SetIamPolicyRequest request =
       SetIamPolicyRequest.newBuilder()
           .setResource(
               AddressGroupName.ofProjectLocationAddressGroupName(
                       "[PROJECT]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .setPolicy(Policy.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   ApiFuture<Policy> future =
       organizationAddressGroupServiceClient.setIamPolicyCallable().futureCall(request);
   // Do something.
   Policy response = future.get();
 }

Returns
Type	Description
`UnaryCallable<com.google.iam.v1.SetIamPolicyRequest,com.google.iam.v1.Policy>`

shutdown()

public void shutdown()

shutdownNow()

public void shutdownNow()

testIamPermissions(TestIamPermissionsRequest request)

public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsRequest request)

Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a NOT_FOUND error.

Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   TestIamPermissionsRequest request =
       TestIamPermissionsRequest.newBuilder()
           .setResource(
               AddressGroupName.ofProjectLocationAddressGroupName(
                       "[PROJECT]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .addAllPermissions(new ArrayList<String>())
           .build();
   TestIamPermissionsResponse response =
       organizationAddressGroupServiceClient.testIamPermissions(request);
 }

Parameter
Name	Description
`request`	`com.google.iam.v1.TestIamPermissionsRequest` The request object containing all of the parameters for the API call.

Returns
Type	Description
`com.google.iam.v1.TestIamPermissionsResponse`

testIamPermissionsCallable()

public final UnaryCallable<TestIamPermissionsRequest,TestIamPermissionsResponse> testIamPermissionsCallable()

Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a NOT_FOUND error.

Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.

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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   TestIamPermissionsRequest request =
       TestIamPermissionsRequest.newBuilder()
           .setResource(
               AddressGroupName.ofProjectLocationAddressGroupName(
                       "[PROJECT]", "[LOCATION]", "[ADDRESS_GROUP]")
                   .toString())
           .addAllPermissions(new ArrayList<String>())
           .build();
   ApiFuture<TestIamPermissionsResponse> future =
       organizationAddressGroupServiceClient.testIamPermissionsCallable().futureCall(request);
   // Do something.
   TestIamPermissionsResponse response = future.get();
 }

Returns
Type	Description
`UnaryCallable<com.google.iam.v1.TestIamPermissionsRequest,com.google.iam.v1.TestIamPermissionsResponse>`

updateAddressGroupAsync(AddressGroup addressGroup, FieldMask updateMask)

public final OperationFuture<AddressGroup,OperationMetadata> updateAddressGroupAsync(AddressGroup addressGroup, FieldMask updateMask)

Updates parameters of an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   AddressGroup addressGroup = AddressGroup.newBuilder().build();
   FieldMask updateMask = FieldMask.newBuilder().build();
   AddressGroup response =
       organizationAddressGroupServiceClient
           .updateAddressGroupAsync(addressGroup, updateMask)
           .get();
 }

Parameters
Name	Description
`addressGroup`	`AddressGroup` Required. Updated AddressGroup resource.
`updateMask`	`FieldMask` Optional. Field mask is used to specify the fields to be overwritten in the AddressGroup resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.

Returns
Type	Description
`OperationFuture<AddressGroup,OperationMetadata>`

updateAddressGroupAsync(UpdateAddressGroupRequest request)

public final OperationFuture<AddressGroup,OperationMetadata> updateAddressGroupAsync(UpdateAddressGroupRequest request)

Updates parameters of an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   UpdateAddressGroupRequest request =
       UpdateAddressGroupRequest.newBuilder()
           .setUpdateMask(FieldMask.newBuilder().build())
           .setAddressGroup(AddressGroup.newBuilder().build())
           .setRequestId("requestId693933066")
           .build();
   AddressGroup response =
       organizationAddressGroupServiceClient.updateAddressGroupAsync(request).get();
 }

Parameter
Name	Description
`request`	`UpdateAddressGroupRequest` The request object containing all of the parameters for the API call.

Returns
Type	Description
`OperationFuture<AddressGroup,OperationMetadata>`

updateAddressGroupCallable()

public final UnaryCallable<UpdateAddressGroupRequest,Operation> updateAddressGroupCallable()

Updates parameters of an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   UpdateAddressGroupRequest request =
       UpdateAddressGroupRequest.newBuilder()
           .setUpdateMask(FieldMask.newBuilder().build())
           .setAddressGroup(AddressGroup.newBuilder().build())
           .setRequestId("requestId693933066")
           .build();
   ApiFuture<Operation> future =
       organizationAddressGroupServiceClient.updateAddressGroupCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }

Returns
Type	Description
`UnaryCallable<UpdateAddressGroupRequest,Operation>`

updateAddressGroupOperationCallable()

public final OperationCallable<UpdateAddressGroupRequest,AddressGroup,OperationMetadata> updateAddressGroupOperationCallable()

Updates parameters of an address 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 (OrganizationAddressGroupServiceClient organizationAddressGroupServiceClient =
     OrganizationAddressGroupServiceClient.create()) {
   UpdateAddressGroupRequest request =
       UpdateAddressGroupRequest.newBuilder()
           .setUpdateMask(FieldMask.newBuilder().build())
           .setAddressGroup(AddressGroup.newBuilder().build())
           .setRequestId("requestId693933066")
           .build();
   OperationFuture<AddressGroup, OperationMetadata> future =
       organizationAddressGroupServiceClient
           .updateAddressGroupOperationCallable()
           .futureCall(request);
   // Do something.
   AddressGroup response = future.get();
 }

Returns
Type	Description
`OperationCallable<UpdateAddressGroupRequest,AddressGroup,OperationMetadata>`

Class OrganizationAddressGroupServiceClient (0.77.0) Stay organized with collections Save and categorize content based on your preferences.

Inheritance

Static Methods

create()

create(OrganizationAddressGroupServiceSettings settings)

create(OrganizationAddressGroupServiceStub stub)

Constructors

OrganizationAddressGroupServiceClient(OrganizationAddressGroupServiceSettings settings)

OrganizationAddressGroupServiceClient(OrganizationAddressGroupServiceStub stub)

Methods

addAddressGroupItemsAsync(AddAddressGroupItemsRequest request)

addAddressGroupItemsAsync(AddressGroupName addressGroup, List<String> items)

addAddressGroupItemsAsync(String addressGroup, List<String> items)

addAddressGroupItemsCallable()

addAddressGroupItemsOperationCallable()

awaitTermination(long duration, TimeUnit unit)

cloneAddressGroupItemsAsync(AddressGroupName addressGroup, AddressGroupName sourceAddressGroup)

cloneAddressGroupItemsAsync(AddressGroupName addressGroup, String sourceAddressGroup)

cloneAddressGroupItemsAsync(CloneAddressGroupItemsRequest request)

cloneAddressGroupItemsAsync(String addressGroup, AddressGroupName sourceAddressGroup)

cloneAddressGroupItemsAsync(String addressGroup, String sourceAddressGroup)

cloneAddressGroupItemsCallable()

cloneAddressGroupItemsOperationCallable()

close()

createAddressGroupAsync(CreateAddressGroupRequest request)

createAddressGroupAsync(LocationName parent, AddressGroup addressGroup, String addressGroupId)

createAddressGroupAsync(OrganizationLocationName parent, AddressGroup addressGroup, String addressGroupId)

createAddressGroupAsync(String parent, AddressGroup addressGroup, String addressGroupId)

createAddressGroupCallable()

createAddressGroupOperationCallable()

deleteAddressGroupAsync(AddressGroupName name)

deleteAddressGroupAsync(DeleteAddressGroupRequest request)

deleteAddressGroupAsync(String name)

deleteAddressGroupCallable()

deleteAddressGroupOperationCallable()

getAddressGroup(AddressGroupName name)

getAddressGroup(GetAddressGroupRequest request)

getAddressGroup(String name)

getAddressGroupCallable()

getIamPolicy(GetIamPolicyRequest request)

getIamPolicyCallable()

getLocation(GetLocationRequest request)

getLocationCallable()

getOperationsClient()

getSettings()

getStub()

isShutdown()

isTerminated()

listAddressGroupReferences(AddressGroupName addressGroup)

listAddressGroupReferences(ListAddressGroupReferencesRequest request)

listAddressGroupReferences(String addressGroup)

listAddressGroupReferencesCallable()

listAddressGroupReferencesPagedCallable()

listAddressGroups(ListAddressGroupsRequest request)

listAddressGroups(LocationName parent)

listAddressGroups(String parent)

listAddressGroupsCallable()

listAddressGroupsPagedCallable()

listLocations(ListLocationsRequest request)

listLocationsCallable()

listLocationsPagedCallable()

removeAddressGroupItemsAsync(AddressGroupName addressGroup, List<String> items)

removeAddressGroupItemsAsync(RemoveAddressGroupItemsRequest request)

removeAddressGroupItemsAsync(String addressGroup, List<String> items)

removeAddressGroupItemsCallable()

removeAddressGroupItemsOperationCallable()

setIamPolicy(SetIamPolicyRequest request)

setIamPolicyCallable()

shutdown()

shutdownNow()

testIamPermissions(TestIamPermissionsRequest request)

testIamPermissionsCallable()

updateAddressGroupAsync(AddressGroup addressGroup, FieldMask updateMask)

updateAddressGroupAsync(UpdateAddressGroupRequest request)

updateAddressGroupCallable()

updateAddressGroupOperationCallable()

Class OrganizationAddressGroupServiceClient (0.77.0)