/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.resourcegroups; import javax.annotation.Generated; import com.amazonaws.services.resourcegroups.model.*; import com.amazonaws.client.AwsAsyncClientParams; import com.amazonaws.annotation.ThreadSafe; import java.util.concurrent.ExecutorService; /** * Client for accessing Resource Groups asynchronously. Each asynchronous method will return a Java Future object * representing the asynchronous operation; overloads which accept an {@code AsyncHandler} can be used to receive * notification when an asynchronous operation completes. *

*

* Resource Groups lets you organize Amazon Web Services resources such as Amazon Elastic Compute Cloud instances, * Amazon Relational Database Service databases, and Amazon Simple Storage Service buckets into groups using criteria * that you define as tags. A resource group is a collection of resources that match the resource types specified in a * query, and share one or more tags or portions of tags. You can create a group of resources based on their roles in * your cloud infrastructure, lifecycle stages, regions, application layers, or virtually any criteria. Resource Groups * enable you to automate management tasks, such as those in Amazon Web Services Systems Manager Automation documents, * on tag-related resources in Amazon Web Services Systems Manager. Groups of tagged resources also let you quickly view * a custom console in Amazon Web Services Systems Manager that shows Config compliance and other monitoring data about * member resources. *

*

* To create a resource group, build a resource query, and specify tags that identify the criteria that members of the * group have in common. Tags are key-value pairs. *

*

* For more information about Resource Groups, see the Resource Groups User Guide. *

*

* Resource Groups uses a REST-compliant API that you can use to perform the following types of operations. *

* */ @ThreadSafe @Generated("com.amazonaws:aws-java-sdk-code-generator") public class AWSResourceGroupsAsyncClient extends AWSResourceGroupsClient implements AWSResourceGroupsAsync { private static final int DEFAULT_THREAD_POOL_SIZE = 50; private final java.util.concurrent.ExecutorService executorService; public static AWSResourceGroupsAsyncClientBuilder asyncBuilder() { return AWSResourceGroupsAsyncClientBuilder.standard(); } /** * Constructs a new asynchronous client to invoke service methods on Resource Groups using the specified parameters. * * @param asyncClientParams * Object providing client parameters. */ AWSResourceGroupsAsyncClient(AwsAsyncClientParams asyncClientParams) { this(asyncClientParams, false); } /** * Constructs a new asynchronous client to invoke service methods on Resource Groups using the specified parameters. * * @param asyncClientParams * Object providing client parameters. * @param endpointDiscoveryEnabled * true will enable endpoint discovery if the service supports it. */ AWSResourceGroupsAsyncClient(AwsAsyncClientParams asyncClientParams, boolean endpointDiscoveryEnabled) { super(asyncClientParams, endpointDiscoveryEnabled); this.executorService = asyncClientParams.getExecutor(); } /** * Returns the executor service used by this client to execute async requests. * * @return The executor service used by this client to execute async requests. */ public ExecutorService getExecutorService() { return executorService; } @Override public java.util.concurrent.Future createGroupAsync(CreateGroupRequest request) { return createGroupAsync(request, null); } @Override public java.util.concurrent.Future createGroupAsync(final CreateGroupRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final CreateGroupRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public CreateGroupResult call() throws Exception { CreateGroupResult result = null; try { result = executeCreateGroup(finalRequest); } catch (Exception ex) { if (asyncHandler != null) { asyncHandler.onError(ex); } throw ex; } if (asyncHandler != null) { asyncHandler.onSuccess(finalRequest, result); } return result; } }); } @Override public java.util.concurrent.Future deleteGroupAsync(DeleteGroupRequest request) { return deleteGroupAsync(request, null); } @Override public java.util.concurrent.Future deleteGroupAsync(final DeleteGroupRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final DeleteGroupRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public DeleteGroupResult call() throws Exception { DeleteGroupResult result = null; try { result = executeDeleteGroup(finalRequest); } catch (Exception ex) { if (asyncHandler != null) { asyncHandler.onError(ex); } throw ex; } if (asyncHandler != null) { asyncHandler.onSuccess(finalRequest, result); } return result; } }); } @Override public java.util.concurrent.Future getAccountSettingsAsync(GetAccountSettingsRequest request) { return getAccountSettingsAsync(request, null); } @Override public java.util.concurrent.Future getAccountSettingsAsync(final GetAccountSettingsRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final GetAccountSettingsRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public GetAccountSettingsResult call() throws Exception { GetAccountSettingsResult result = null; try { result = executeGetAccountSettings(finalRequest); } catch (Exception ex) { if (asyncHandler != null) { asyncHandler.onError(ex); } throw ex; } if (asyncHandler != null) { asyncHandler.onSuccess(finalRequest, result); } return result; } }); } @Override public java.util.concurrent.Future getGroupAsync(GetGroupRequest request) { return getGroupAsync(request, null); } @Override public java.util.concurrent.Future getGroupAsync(final GetGroupRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final GetGroupRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public GetGroupResult call() throws Exception { GetGroupResult result = null; try { result = executeGetGroup(finalRequest); } catch (Exception ex) { if (asyncHandler != null) { asyncHandler.onError(ex); } throw ex; } if (asyncHandler != null) { asyncHandler.onSuccess(finalRequest, result); } return result; } }); } @Override public java.util.concurrent.Future getGroupConfigurationAsync(GetGroupConfigurationRequest request) { return getGroupConfigurationAsync(request, null); } @Override public java.util.concurrent.Future getGroupConfigurationAsync(final GetGroupConfigurationRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final GetGroupConfigurationRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public GetGroupConfigurationResult call() throws Exception { GetGroupConfigurationResult result = null; try { result = executeGetGroupConfiguration(finalRequest); } catch (Exception ex) { if (asyncHandler != null) { asyncHandler.onError(ex); } throw ex; } if (asyncHandler != null) { asyncHandler.onSuccess(finalRequest, result); } return result; } }); } @Override public java.util.concurrent.Future getGroupQueryAsync(GetGroupQueryRequest request) { return getGroupQueryAsync(request, null); } @Override public java.util.concurrent.Future getGroupQueryAsync(final GetGroupQueryRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final GetGroupQueryRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public GetGroupQueryResult call() throws Exception { GetGroupQueryResult result = null; try { result = executeGetGroupQuery(finalRequest); } catch (Exception ex) { if (asyncHandler != null) { asyncHandler.onError(ex); } throw ex; } if (asyncHandler != null) { asyncHandler.onSuccess(finalRequest, result); } return result; } }); } @Override public java.util.concurrent.Future getTagsAsync(GetTagsRequest request) { return getTagsAsync(request, null); } @Override public java.util.concurrent.Future getTagsAsync(final GetTagsRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final GetTagsRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public GetTagsResult call() throws Exception { GetTagsResult result = null; try { result = executeGetTags(finalRequest); } catch (Exception ex) { if (asyncHandler != null) { asyncHandler.onError(ex); } throw ex; } if (asyncHandler != null) { asyncHandler.onSuccess(finalRequest, result); } return result; } }); } @Override public java.util.concurrent.Future groupResourcesAsync(GroupResourcesRequest request) { return groupResourcesAsync(request, null); } @Override public java.util.concurrent.Future groupResourcesAsync(final GroupResourcesRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final GroupResourcesRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public GroupResourcesResult call() throws Exception { GroupResourcesResult result = null; try { result = executeGroupResources(finalRequest); } catch (Exception ex) { if (asyncHandler != null) { asyncHandler.onError(ex); } throw ex; } if (asyncHandler != null) { asyncHandler.onSuccess(finalRequest, result); } return result; } }); } @Override public java.util.concurrent.Future listGroupResourcesAsync(ListGroupResourcesRequest request) { return listGroupResourcesAsync(request, null); } @Override public java.util.concurrent.Future listGroupResourcesAsync(final ListGroupResourcesRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final ListGroupResourcesRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public ListGroupResourcesResult call() throws Exception { ListGroupResourcesResult result = null; try { result = executeListGroupResources(finalRequest); } catch (Exception ex) { if (asyncHandler != null) { asyncHandler.onError(ex); } throw ex; } if (asyncHandler != null) { asyncHandler.onSuccess(finalRequest, result); } return result; } }); } @Override public java.util.concurrent.Future listGroupsAsync(ListGroupsRequest request) { return listGroupsAsync(request, null); } @Override public java.util.concurrent.Future listGroupsAsync(final ListGroupsRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final ListGroupsRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public ListGroupsResult call() throws Exception { ListGroupsResult result = null; try { result = executeListGroups(finalRequest); } catch (Exception ex) { if (asyncHandler != null) { asyncHandler.onError(ex); } throw ex; } if (asyncHandler != null) { asyncHandler.onSuccess(finalRequest, result); } return result; } }); } @Override public java.util.concurrent.Future putGroupConfigurationAsync(PutGroupConfigurationRequest request) { return putGroupConfigurationAsync(request, null); } @Override public java.util.concurrent.Future putGroupConfigurationAsync(final PutGroupConfigurationRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final PutGroupConfigurationRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public PutGroupConfigurationResult call() throws Exception { PutGroupConfigurationResult result = null; try { result = executePutGroupConfiguration(finalRequest); } catch (Exception ex) { if (asyncHandler != null) { asyncHandler.onError(ex); } throw ex; } if (asyncHandler != null) { asyncHandler.onSuccess(finalRequest, result); } return result; } }); } @Override public java.util.concurrent.Future searchResourcesAsync(SearchResourcesRequest request) { return searchResourcesAsync(request, null); } @Override public java.util.concurrent.Future searchResourcesAsync(final SearchResourcesRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final SearchResourcesRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public SearchResourcesResult call() throws Exception { SearchResourcesResult result = null; try { result = executeSearchResources(finalRequest); } catch (Exception ex) { if (asyncHandler != null) { asyncHandler.onError(ex); } throw ex; } if (asyncHandler != null) { asyncHandler.onSuccess(finalRequest, result); } return result; } }); } @Override public java.util.concurrent.Future tagAsync(TagRequest request) { return tagAsync(request, null); } @Override public java.util.concurrent.Future tagAsync(final TagRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final TagRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public TagResult call() throws Exception { TagResult result = null; try { result = executeTag(finalRequest); } catch (Exception ex) { if (asyncHandler != null) { asyncHandler.onError(ex); } throw ex; } if (asyncHandler != null) { asyncHandler.onSuccess(finalRequest, result); } return result; } }); } @Override public java.util.concurrent.Future ungroupResourcesAsync(UngroupResourcesRequest request) { return ungroupResourcesAsync(request, null); } @Override public java.util.concurrent.Future ungroupResourcesAsync(final UngroupResourcesRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final UngroupResourcesRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public UngroupResourcesResult call() throws Exception { UngroupResourcesResult result = null; try { result = executeUngroupResources(finalRequest); } catch (Exception ex) { if (asyncHandler != null) { asyncHandler.onError(ex); } throw ex; } if (asyncHandler != null) { asyncHandler.onSuccess(finalRequest, result); } return result; } }); } @Override public java.util.concurrent.Future untagAsync(UntagRequest request) { return untagAsync(request, null); } @Override public java.util.concurrent.Future untagAsync(final UntagRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final UntagRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public UntagResult call() throws Exception { UntagResult result = null; try { result = executeUntag(finalRequest); } catch (Exception ex) { if (asyncHandler != null) { asyncHandler.onError(ex); } throw ex; } if (asyncHandler != null) { asyncHandler.onSuccess(finalRequest, result); } return result; } }); } @Override public java.util.concurrent.Future updateAccountSettingsAsync(UpdateAccountSettingsRequest request) { return updateAccountSettingsAsync(request, null); } @Override public java.util.concurrent.Future updateAccountSettingsAsync(final UpdateAccountSettingsRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final UpdateAccountSettingsRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public UpdateAccountSettingsResult call() throws Exception { UpdateAccountSettingsResult result = null; try { result = executeUpdateAccountSettings(finalRequest); } catch (Exception ex) { if (asyncHandler != null) { asyncHandler.onError(ex); } throw ex; } if (asyncHandler != null) { asyncHandler.onSuccess(finalRequest, result); } return result; } }); } @Override public java.util.concurrent.Future updateGroupAsync(UpdateGroupRequest request) { return updateGroupAsync(request, null); } @Override public java.util.concurrent.Future updateGroupAsync(final UpdateGroupRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final UpdateGroupRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public UpdateGroupResult call() throws Exception { UpdateGroupResult result = null; try { result = executeUpdateGroup(finalRequest); } catch (Exception ex) { if (asyncHandler != null) { asyncHandler.onError(ex); } throw ex; } if (asyncHandler != null) { asyncHandler.onSuccess(finalRequest, result); } return result; } }); } @Override public java.util.concurrent.Future updateGroupQueryAsync(UpdateGroupQueryRequest request) { return updateGroupQueryAsync(request, null); } @Override public java.util.concurrent.Future updateGroupQueryAsync(final UpdateGroupQueryRequest request, final com.amazonaws.handlers.AsyncHandler asyncHandler) { final UpdateGroupQueryRequest finalRequest = beforeClientExecution(request); return executorService.submit(new java.util.concurrent.Callable() { @Override public UpdateGroupQueryResult call() throws Exception { UpdateGroupQueryResult result = null; try { result = executeUpdateGroupQuery(finalRequest); } catch (Exception ex) { if (asyncHandler != null) { asyncHandler.onError(ex); } throw ex; } if (asyncHandler != null) { asyncHandler.onSuccess(finalRequest, result); } return result; } }); } /** * Shuts down the client, releasing all managed resources. This includes forcibly terminating all pending * asynchronous service calls. Clients who wish to give pending asynchronous service calls time to complete should * call {@code getExecutorService().shutdown()} followed by {@code getExecutorService().awaitTermination()} prior to * calling this method. */ @Override public void shutdown() { super.shutdown(); executorService.shutdownNow(); } }