/*
* 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.migrationhubconfig;
import javax.annotation.Generated;
import com.amazonaws.services.migrationhubconfig.model.*;
/**
* Interface for accessing AWS Migration Hub Config 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.
*
* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from
* {@link com.amazonaws.services.migrationhubconfig.AbstractAWSMigrationHubConfigAsync} instead.
*
*
*
* The AWS Migration Hub home region APIs are available specifically for working with your Migration Hub home region.
* You can use these APIs to determine a home region, as well as to create and work with controls that describe the home
* region.
*
*
* -
*
* You must make API calls for write actions (create, notify, associate, disassociate, import, or put) while in your
* home region, or a HomeRegionNotSetException error is returned.
*
*
* -
*
* API calls for read actions (list, describe, stop, and delete) are permitted outside of your home region.
*
*
* -
*
* If you call a write API outside the home region, an InvalidInputException is returned.
*
*
* -
*
* You can call GetHomeRegion action to obtain the account's Migration Hub home region.
*
*
*
*
* For specific API usage, see the sections that follow in this AWS Migration Hub Home Region API reference.
*
*/
@Generated("com.amazonaws:aws-java-sdk-code-generator")
public interface AWSMigrationHubConfigAsync extends AWSMigrationHubConfig {
/**
*
* This API sets up the home region for the calling account only.
*
*
* @param createHomeRegionControlRequest
* @return A Java Future containing the result of the CreateHomeRegionControl operation returned by the service.
* @sample AWSMigrationHubConfigAsync.CreateHomeRegionControl
* @see AWS API Documentation
*/
java.util.concurrent.Future createHomeRegionControlAsync(CreateHomeRegionControlRequest createHomeRegionControlRequest);
/**
*
* This API sets up the home region for the calling account only.
*
*
* @param createHomeRegionControlRequest
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
* implementation of the callback methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the CreateHomeRegionControl operation returned by the service.
* @sample AWSMigrationHubConfigAsyncHandler.CreateHomeRegionControl
* @see AWS API Documentation
*/
java.util.concurrent.Future createHomeRegionControlAsync(CreateHomeRegionControlRequest createHomeRegionControlRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This API permits filtering on the ControlId and HomeRegion fields.
*
*
* @param describeHomeRegionControlsRequest
* @return A Java Future containing the result of the DescribeHomeRegionControls operation returned by the service.
* @sample AWSMigrationHubConfigAsync.DescribeHomeRegionControls
* @see AWS API Documentation
*/
java.util.concurrent.Future describeHomeRegionControlsAsync(
DescribeHomeRegionControlsRequest describeHomeRegionControlsRequest);
/**
*
* This API permits filtering on the ControlId and HomeRegion fields.
*
*
* @param describeHomeRegionControlsRequest
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
* implementation of the callback methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the DescribeHomeRegionControls operation returned by the service.
* @sample AWSMigrationHubConfigAsyncHandler.DescribeHomeRegionControls
* @see AWS API Documentation
*/
java.util.concurrent.Future describeHomeRegionControlsAsync(
DescribeHomeRegionControlsRequest describeHomeRegionControlsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns the calling account’s home region, if configured. This API is used by other AWS services to determine the
* regional endpoint for calling AWS Application Discovery Service and Migration Hub. You must call
* GetHomeRegion at least once before you call any other AWS Application Discovery Service and AWS
* Migration Hub APIs, to obtain the account's Migration Hub home region.
*
*
* @param getHomeRegionRequest
* @return A Java Future containing the result of the GetHomeRegion operation returned by the service.
* @sample AWSMigrationHubConfigAsync.GetHomeRegion
* @see AWS API Documentation
*/
java.util.concurrent.Future getHomeRegionAsync(GetHomeRegionRequest getHomeRegionRequest);
/**
*
* Returns the calling account’s home region, if configured. This API is used by other AWS services to determine the
* regional endpoint for calling AWS Application Discovery Service and Migration Hub. You must call
* GetHomeRegion at least once before you call any other AWS Application Discovery Service and AWS
* Migration Hub APIs, to obtain the account's Migration Hub home region.
*
*
* @param getHomeRegionRequest
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
* implementation of the callback methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the GetHomeRegion operation returned by the service.
* @sample AWSMigrationHubConfigAsyncHandler.GetHomeRegion
* @see AWS API Documentation
*/
java.util.concurrent.Future getHomeRegionAsync(GetHomeRegionRequest getHomeRegionRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
}