com.amazonaws.services.servicediscovery

Class AWSServiceDiscoveryAsyncClient

java.lang.Object

com.amazonaws.AmazonWebServiceClient

com.amazonaws.services.servicediscovery.AWSServiceDiscoveryClient

com.amazonaws.services.servicediscovery.AWSServiceDiscoveryAsyncClient

All Implemented Interfaces:

AWSServiceDiscovery, AWSServiceDiscoveryAsync

@ThreadSafe
 @Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public class AWSServiceDiscoveryAsyncClient
extends AWSServiceDiscoveryClient
implements AWSServiceDiscoveryAsync

Client for accessing ServiceDiscovery asynchronously. Each asynchronous method will return a Java Future object representing the asynchronous operation; overloads which accept an AsyncHandler can be used to receive notification when an asynchronous operation completes.

AWS Cloud Map lets you configure public DNS, private DNS, or HTTP namespaces that your microservice applications run in. When an instance of the service becomes available, you can call the AWS Cloud Map API to register the instance with AWS Cloud Map. For public or private DNS namespaces, AWS Cloud Map automatically creates DNS records and an optional health check. Clients that submit public or private DNS queries, or HTTP requests, for the service receive an answer that contains up to eight healthy records.

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceClient

LOGGING_AWS_REQUEST_METRIC

Fields inherited from interface com.amazonaws.services.servicediscovery.AWSServiceDiscovery

ENDPOINT_PREFIX

Method Summary

Modifier and Type	Method and Description
static AWSServiceDiscoveryAsyncClientBuilder	asyncBuilder()
Future<CreateHttpNamespaceResult>	createHttpNamespaceAsync(CreateHttpNamespaceRequest request) Creates an HTTP namespace.
Future<CreateHttpNamespaceResult>	createHttpNamespaceAsync(CreateHttpNamespaceRequest request, AsyncHandler<CreateHttpNamespaceRequest,CreateHttpNamespaceResult> asyncHandler) Creates an HTTP namespace.
Future<CreatePrivateDnsNamespaceResult>	createPrivateDnsNamespaceAsync(CreatePrivateDnsNamespaceRequest request) Creates a private namespace based on DNS, which will be visible only inside a specified Amazon VPC.
Future<CreatePrivateDnsNamespaceResult>	createPrivateDnsNamespaceAsync(CreatePrivateDnsNamespaceRequest request, AsyncHandler<CreatePrivateDnsNamespaceRequest,CreatePrivateDnsNamespaceResult> asyncHandler) Creates a private namespace based on DNS, which will be visible only inside a specified Amazon VPC.
Future<CreatePublicDnsNamespaceResult>	createPublicDnsNamespaceAsync(CreatePublicDnsNamespaceRequest request) Creates a public namespace based on DNS, which will be visible on the internet.
Future<CreatePublicDnsNamespaceResult>	createPublicDnsNamespaceAsync(CreatePublicDnsNamespaceRequest request, AsyncHandler<CreatePublicDnsNamespaceRequest,CreatePublicDnsNamespaceResult> asyncHandler) Creates a public namespace based on DNS, which will be visible on the internet.
Future<CreateServiceResult>	createServiceAsync(CreateServiceRequest request) Creates a service, which defines the configuration for the following entities:
Future<CreateServiceResult>	createServiceAsync(CreateServiceRequest request, AsyncHandler<CreateServiceRequest,CreateServiceResult> asyncHandler) Creates a service, which defines the configuration for the following entities:
Future<DeleteNamespaceResult>	deleteNamespaceAsync(DeleteNamespaceRequest request) Deletes a namespace from the current account.
Future<DeleteNamespaceResult>	deleteNamespaceAsync(DeleteNamespaceRequest request, AsyncHandler<DeleteNamespaceRequest,DeleteNamespaceResult> asyncHandler) Deletes a namespace from the current account.
Future<DeleteServiceResult>	deleteServiceAsync(DeleteServiceRequest request) Deletes a specified service.
Future<DeleteServiceResult>	deleteServiceAsync(DeleteServiceRequest request, AsyncHandler<DeleteServiceRequest,DeleteServiceResult> asyncHandler) Deletes a specified service.
Future<DeregisterInstanceResult>	deregisterInstanceAsync(DeregisterInstanceRequest request) Deletes the Amazon Route 53 DNS records and health check, if any, that AWS Cloud Map created for the specified instance.
Future<DeregisterInstanceResult>	deregisterInstanceAsync(DeregisterInstanceRequest request, AsyncHandler<DeregisterInstanceRequest,DeregisterInstanceResult> asyncHandler) Deletes the Amazon Route 53 DNS records and health check, if any, that AWS Cloud Map created for the specified instance.
Future<DiscoverInstancesResult>	discoverInstancesAsync(DiscoverInstancesRequest request) Discovers registered instances for a specified namespace and service.
Future<DiscoverInstancesResult>	discoverInstancesAsync(DiscoverInstancesRequest request, AsyncHandler<DiscoverInstancesRequest,DiscoverInstancesResult> asyncHandler) Discovers registered instances for a specified namespace and service.
ExecutorService	getExecutorService() Returns the executor service used by this client to execute async requests.
Future<GetInstanceResult>	getInstanceAsync(GetInstanceRequest request) Gets information about a specified instance.
Future<GetInstanceResult>	getInstanceAsync(GetInstanceRequest request, AsyncHandler<GetInstanceRequest,GetInstanceResult> asyncHandler) Gets information about a specified instance.
Future<GetInstancesHealthStatusResult>	getInstancesHealthStatusAsync(GetInstancesHealthStatusRequest request) Gets the current health status (Healthy, Unhealthy, or Unknown) of one or more instances that are associated with a specified service.
Future<GetInstancesHealthStatusResult>	getInstancesHealthStatusAsync(GetInstancesHealthStatusRequest request, AsyncHandler<GetInstancesHealthStatusRequest,GetInstancesHealthStatusResult> asyncHandler) Gets the current health status (Healthy, Unhealthy, or Unknown) of one or more instances that are associated with a specified service.
Future<GetNamespaceResult>	getNamespaceAsync(GetNamespaceRequest request) Gets information about a namespace.
Future<GetNamespaceResult>	getNamespaceAsync(GetNamespaceRequest request, AsyncHandler<GetNamespaceRequest,GetNamespaceResult> asyncHandler) Gets information about a namespace.
Future<GetOperationResult>	getOperationAsync(GetOperationRequest request) Gets information about any operation that returns an operation ID in the response, such as a CreateService request.
Future<GetOperationResult>	getOperationAsync(GetOperationRequest request, AsyncHandler<GetOperationRequest,GetOperationResult> asyncHandler) Gets information about any operation that returns an operation ID in the response, such as a CreateService request.
Future<GetServiceResult>	getServiceAsync(GetServiceRequest request) Gets the settings for a specified service.
Future<GetServiceResult>	getServiceAsync(GetServiceRequest request, AsyncHandler<GetServiceRequest,GetServiceResult> asyncHandler) Gets the settings for a specified service.
Future<ListInstancesResult>	listInstancesAsync(ListInstancesRequest request) Lists summary information about the instances that you registered by using a specified service.
Future<ListInstancesResult>	listInstancesAsync(ListInstancesRequest request, AsyncHandler<ListInstancesRequest,ListInstancesResult> asyncHandler) Lists summary information about the instances that you registered by using a specified service.
Future<ListNamespacesResult>	listNamespacesAsync(ListNamespacesRequest request) Lists summary information about the namespaces that were created by the current AWS account.
Future<ListNamespacesResult>	listNamespacesAsync(ListNamespacesRequest request, AsyncHandler<ListNamespacesRequest,ListNamespacesResult> asyncHandler) Lists summary information about the namespaces that were created by the current AWS account.
Future<ListOperationsResult>	listOperationsAsync(ListOperationsRequest request) Lists operations that match the criteria that you specify.
Future<ListOperationsResult>	listOperationsAsync(ListOperationsRequest request, AsyncHandler<ListOperationsRequest,ListOperationsResult> asyncHandler) Lists operations that match the criteria that you specify.
Future<ListServicesResult>	listServicesAsync(ListServicesRequest request) Lists summary information for all the services that are associated with one or more specified namespaces.
Future<ListServicesResult>	listServicesAsync(ListServicesRequest request, AsyncHandler<ListServicesRequest,ListServicesResult> asyncHandler) Lists summary information for all the services that are associated with one or more specified namespaces.
Future<RegisterInstanceResult>	registerInstanceAsync(RegisterInstanceRequest request) Creates or updates one or more records and, optionally, creates a health check based on the settings in a specified service.
Future<RegisterInstanceResult>	registerInstanceAsync(RegisterInstanceRequest request, AsyncHandler<RegisterInstanceRequest,RegisterInstanceResult> asyncHandler) Creates or updates one or more records and, optionally, creates a health check based on the settings in a specified service.
void	shutdown() Shuts down the client, releasing all managed resources.
Future<UpdateInstanceCustomHealthStatusResult>	updateInstanceCustomHealthStatusAsync(UpdateInstanceCustomHealthStatusRequest request) Submits a request to change the health status of a custom health check to healthy or unhealthy.
Future<UpdateInstanceCustomHealthStatusResult>	updateInstanceCustomHealthStatusAsync(UpdateInstanceCustomHealthStatusRequest request, AsyncHandler<UpdateInstanceCustomHealthStatusRequest,UpdateInstanceCustomHealthStatusResult> asyncHandler) Submits a request to change the health status of a custom health check to healthy or unhealthy.
Future<UpdateServiceResult>	updateServiceAsync(UpdateServiceRequest request) Submits a request to perform the following operations:
Future<UpdateServiceResult>	updateServiceAsync(UpdateServiceRequest request, AsyncHandler<UpdateServiceRequest,UpdateServiceResult> asyncHandler) Submits a request to perform the following operations:

Methods inherited from class com.amazonaws.services.servicediscovery.AWSServiceDiscoveryClient

builder, createHttpNamespace, createPrivateDnsNamespace, createPublicDnsNamespace, createService, deleteNamespace, deleteService, deregisterInstance, discoverInstances, getCachedResponseMetadata, getInstance, getInstancesHealthStatus, getNamespace, getOperation, getService, listInstances, listNamespaces, listOperations, listServices, registerInstance, updateInstanceCustomHealthStatus, updateService

Methods inherited from class com.amazonaws.AmazonWebServiceClient

addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffset

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.amazonaws.services.servicediscovery.AWSServiceDiscovery

createHttpNamespace, createPrivateDnsNamespace, createPublicDnsNamespace, createService, deleteNamespace, deleteService, deregisterInstance, discoverInstances, getCachedResponseMetadata, getInstance, getInstancesHealthStatus, getNamespace, getOperation, getService, listInstances, listNamespaces, listOperations, listServices, registerInstance, updateInstanceCustomHealthStatus, updateService

Method Detail

asyncBuilder

public static AWSServiceDiscoveryAsyncClientBuilder asyncBuilder()

getExecutorService

public ExecutorService getExecutorService()

Returns the executor service used by this client to execute async requests.

Returns:

The executor service used by this client to execute async requests.

createHttpNamespaceAsync

public Future<CreateHttpNamespaceResult> createHttpNamespaceAsync(CreateHttpNamespaceRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Creates an HTTP namespace. Service instances that you register using an HTTP namespace can be discovered using a DiscoverInstances request but can't be discovered using DNS.

For the current limit on the number of namespaces that you can create using the same AWS account, see AWS Cloud Map Limits in the AWS Cloud Map Developer Guide.

Specified by:

createHttpNamespaceAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the CreateHttpNamespace operation returned by the service.

See Also:

AWS API Documentation

createHttpNamespaceAsync

public Future<CreateHttpNamespaceResult> createHttpNamespaceAsync(CreateHttpNamespaceRequest request,
                                                                  AsyncHandler<CreateHttpNamespaceRequest,CreateHttpNamespaceResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Creates an HTTP namespace. Service instances that you register using an HTTP namespace can be discovered using a DiscoverInstances request but can't be discovered using DNS.

For the current limit on the number of namespaces that you can create using the same AWS account, see AWS Cloud Map Limits in the AWS Cloud Map Developer Guide.

Specified by:

createHttpNamespaceAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the CreateHttpNamespace operation returned by the service.

See Also:

AWS API Documentation

createPrivateDnsNamespaceAsync

public Future<CreatePrivateDnsNamespaceResult> createPrivateDnsNamespaceAsync(CreatePrivateDnsNamespaceRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Creates a private namespace based on DNS, which will be visible only inside a specified Amazon VPC. The namespace defines your service naming scheme. For example, if you name your namespace example.com and name your service backend, the resulting DNS name for the service will be backend.example.com. For the current limit on the number of namespaces that you can create using the same AWS account, see AWS Cloud Map Limits in the AWS Cloud Map Developer Guide.

Specified by:

createPrivateDnsNamespaceAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the CreatePrivateDnsNamespace operation returned by the service.

See Also:

AWS API Documentation

createPrivateDnsNamespaceAsync

public Future<CreatePrivateDnsNamespaceResult> createPrivateDnsNamespaceAsync(CreatePrivateDnsNamespaceRequest request,
                                                                              AsyncHandler<CreatePrivateDnsNamespaceRequest,CreatePrivateDnsNamespaceResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Creates a private namespace based on DNS, which will be visible only inside a specified Amazon VPC. The namespace defines your service naming scheme. For example, if you name your namespace example.com and name your service backend, the resulting DNS name for the service will be backend.example.com. For the current limit on the number of namespaces that you can create using the same AWS account, see AWS Cloud Map Limits in the AWS Cloud Map Developer Guide.

Specified by:

createPrivateDnsNamespaceAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the CreatePrivateDnsNamespace operation returned by the service.

See Also:

AWS API Documentation

createPublicDnsNamespaceAsync

public Future<CreatePublicDnsNamespaceResult> createPublicDnsNamespaceAsync(CreatePublicDnsNamespaceRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Creates a public namespace based on DNS, which will be visible on the internet. The namespace defines your service naming scheme. For example, if you name your namespace example.com and name your service backend, the resulting DNS name for the service will be backend.example.com. For the current limit on the number of namespaces that you can create using the same AWS account, see AWS Cloud Map Limits in the AWS Cloud Map Developer Guide.

Specified by:

createPublicDnsNamespaceAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the CreatePublicDnsNamespace operation returned by the service.

See Also:

AWS API Documentation

createPublicDnsNamespaceAsync

public Future<CreatePublicDnsNamespaceResult> createPublicDnsNamespaceAsync(CreatePublicDnsNamespaceRequest request,
                                                                            AsyncHandler<CreatePublicDnsNamespaceRequest,CreatePublicDnsNamespaceResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Creates a public namespace based on DNS, which will be visible on the internet. The namespace defines your service naming scheme. For example, if you name your namespace example.com and name your service backend, the resulting DNS name for the service will be backend.example.com. For the current limit on the number of namespaces that you can create using the same AWS account, see AWS Cloud Map Limits in the AWS Cloud Map Developer Guide.

Specified by:

createPublicDnsNamespaceAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the CreatePublicDnsNamespace operation returned by the service.

See Also:

AWS API Documentation

createServiceAsync

public Future<CreateServiceResult> createServiceAsync(CreateServiceRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Creates a service, which defines the configuration for the following entities:

• For public and private DNS namespaces, one of the following combinations of DNS records in Amazon Route 53:

  • A

  • AAAA

  • A and AAAA

  • SRV

  • CNAME

• Optionally, a health check

After you create the service, you can submit a RegisterInstance request, and AWS Cloud Map uses the values in the configuration to create the specified entities.

For the current limit on the number of instances that you can register using the same namespace and using the same service, see AWS Cloud Map Limits in the AWS Cloud Map Developer Guide.

Specified by:

createServiceAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the CreateService operation returned by the service.

See Also:

AWS API Documentation

createServiceAsync

public Future<CreateServiceResult> createServiceAsync(CreateServiceRequest request,
                                                      AsyncHandler<CreateServiceRequest,CreateServiceResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Creates a service, which defines the configuration for the following entities:

• For public and private DNS namespaces, one of the following combinations of DNS records in Amazon Route 53:

  • A

  • AAAA

  • A and AAAA

  • SRV

  • CNAME

• Optionally, a health check

After you create the service, you can submit a RegisterInstance request, and AWS Cloud Map uses the values in the configuration to create the specified entities.

For the current limit on the number of instances that you can register using the same namespace and using the same service, see AWS Cloud Map Limits in the AWS Cloud Map Developer Guide.

Specified by:

createServiceAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the CreateService operation returned by the service.

See Also:

AWS API Documentation

deleteNamespaceAsync

public Future<DeleteNamespaceResult> deleteNamespaceAsync(DeleteNamespaceRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Deletes a namespace from the current account. If the namespace still contains one or more services, the request fails.

Specified by:

deleteNamespaceAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the DeleteNamespace operation returned by the service.

See Also:

AWS API Documentation

deleteNamespaceAsync

public Future<DeleteNamespaceResult> deleteNamespaceAsync(DeleteNamespaceRequest request,
                                                          AsyncHandler<DeleteNamespaceRequest,DeleteNamespaceResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Deletes a namespace from the current account. If the namespace still contains one or more services, the request fails.

Specified by:

deleteNamespaceAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the DeleteNamespace operation returned by the service.

See Also:

AWS API Documentation

deleteServiceAsync

public Future<DeleteServiceResult> deleteServiceAsync(DeleteServiceRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Deletes a specified service. If the service still contains one or more registered instances, the request fails.

Specified by:

deleteServiceAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the DeleteService operation returned by the service.

See Also:

AWS API Documentation

deleteServiceAsync

public Future<DeleteServiceResult> deleteServiceAsync(DeleteServiceRequest request,
                                                      AsyncHandler<DeleteServiceRequest,DeleteServiceResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Deletes a specified service. If the service still contains one or more registered instances, the request fails.

Specified by:

deleteServiceAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the DeleteService operation returned by the service.

See Also:

AWS API Documentation

deregisterInstanceAsync

public Future<DeregisterInstanceResult> deregisterInstanceAsync(DeregisterInstanceRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Deletes the Amazon Route 53 DNS records and health check, if any, that AWS Cloud Map created for the specified instance.

Specified by:

deregisterInstanceAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the DeregisterInstance operation returned by the service.

See Also:

AWS API Documentation

deregisterInstanceAsync

public Future<DeregisterInstanceResult> deregisterInstanceAsync(DeregisterInstanceRequest request,
                                                                AsyncHandler<DeregisterInstanceRequest,DeregisterInstanceResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Deletes the Amazon Route 53 DNS records and health check, if any, that AWS Cloud Map created for the specified instance.

Specified by:

deregisterInstanceAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the DeregisterInstance operation returned by the service.

See Also:

AWS API Documentation

discoverInstancesAsync

public Future<DiscoverInstancesResult> discoverInstancesAsync(DiscoverInstancesRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Discovers registered instances for a specified namespace and service.

Specified by:

discoverInstancesAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the DiscoverInstances operation returned by the service.

See Also:

AWS API Documentation

discoverInstancesAsync

public Future<DiscoverInstancesResult> discoverInstancesAsync(DiscoverInstancesRequest request,
                                                              AsyncHandler<DiscoverInstancesRequest,DiscoverInstancesResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Discovers registered instances for a specified namespace and service.

Specified by:

discoverInstancesAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the DiscoverInstances operation returned by the service.

See Also:

AWS API Documentation

getInstanceAsync

public Future<GetInstanceResult> getInstanceAsync(GetInstanceRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Gets information about a specified instance.

Specified by:

getInstanceAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the GetInstance operation returned by the service.

See Also:

AWS API Documentation

getInstanceAsync

public Future<GetInstanceResult> getInstanceAsync(GetInstanceRequest request,
                                                  AsyncHandler<GetInstanceRequest,GetInstanceResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Gets information about a specified instance.

Specified by:

getInstanceAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the GetInstance operation returned by the service.

See Also:

AWS API Documentation

getInstancesHealthStatusAsync

public Future<GetInstancesHealthStatusResult> getInstancesHealthStatusAsync(GetInstancesHealthStatusRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Gets the current health status (Healthy, Unhealthy, or Unknown) of one or more instances that are associated with a specified service.

There is a brief delay between when you register an instance and when the health status for the instance is available.

Specified by:

getInstancesHealthStatusAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the GetInstancesHealthStatus operation returned by the service.

See Also:

AWS API Documentation

getInstancesHealthStatusAsync

public Future<GetInstancesHealthStatusResult> getInstancesHealthStatusAsync(GetInstancesHealthStatusRequest request,
                                                                            AsyncHandler<GetInstancesHealthStatusRequest,GetInstancesHealthStatusResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Gets the current health status (Healthy, Unhealthy, or Unknown) of one or more instances that are associated with a specified service.

There is a brief delay between when you register an instance and when the health status for the instance is available.

Specified by:

getInstancesHealthStatusAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the GetInstancesHealthStatus operation returned by the service.

See Also:

AWS API Documentation

getNamespaceAsync

public Future<GetNamespaceResult> getNamespaceAsync(GetNamespaceRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Gets information about a namespace.

Specified by:

getNamespaceAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the GetNamespace operation returned by the service.

See Also:

AWS API Documentation

getNamespaceAsync

public Future<GetNamespaceResult> getNamespaceAsync(GetNamespaceRequest request,
                                                    AsyncHandler<GetNamespaceRequest,GetNamespaceResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Gets information about a namespace.

Specified by:

getNamespaceAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the GetNamespace operation returned by the service.

See Also:

AWS API Documentation

getOperationAsync

public Future<GetOperationResult> getOperationAsync(GetOperationRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Gets information about any operation that returns an operation ID in the response, such as a CreateService request.

To get a list of operations that match specified criteria, see ListOperations.

Specified by:

getOperationAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the GetOperation operation returned by the service.

See Also:

AWS API Documentation

getOperationAsync

public Future<GetOperationResult> getOperationAsync(GetOperationRequest request,
                                                    AsyncHandler<GetOperationRequest,GetOperationResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Gets information about any operation that returns an operation ID in the response, such as a CreateService request.

To get a list of operations that match specified criteria, see ListOperations.

Specified by:

getOperationAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the GetOperation operation returned by the service.

See Also:

AWS API Documentation

getServiceAsync

public Future<GetServiceResult> getServiceAsync(GetServiceRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Gets the settings for a specified service.

Specified by:

getServiceAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the GetService operation returned by the service.

See Also:

AWS API Documentation

getServiceAsync

public Future<GetServiceResult> getServiceAsync(GetServiceRequest request,
                                                AsyncHandler<GetServiceRequest,GetServiceResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Gets the settings for a specified service.

Specified by:

getServiceAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the GetService operation returned by the service.

See Also:

AWS API Documentation

listInstancesAsync

public Future<ListInstancesResult> listInstancesAsync(ListInstancesRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Lists summary information about the instances that you registered by using a specified service.

Specified by:

listInstancesAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the ListInstances operation returned by the service.

See Also:

AWS API Documentation

listInstancesAsync

public Future<ListInstancesResult> listInstancesAsync(ListInstancesRequest request,
                                                      AsyncHandler<ListInstancesRequest,ListInstancesResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Lists summary information about the instances that you registered by using a specified service.

Specified by:

listInstancesAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the ListInstances operation returned by the service.

See Also:

AWS API Documentation

listNamespacesAsync

public Future<ListNamespacesResult> listNamespacesAsync(ListNamespacesRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Lists summary information about the namespaces that were created by the current AWS account.

Specified by:

listNamespacesAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the ListNamespaces operation returned by the service.

See Also:

AWS API Documentation

listNamespacesAsync

public Future<ListNamespacesResult> listNamespacesAsync(ListNamespacesRequest request,
                                                        AsyncHandler<ListNamespacesRequest,ListNamespacesResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Lists summary information about the namespaces that were created by the current AWS account.

Specified by:

listNamespacesAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the ListNamespaces operation returned by the service.

See Also:

AWS API Documentation

listOperationsAsync

public Future<ListOperationsResult> listOperationsAsync(ListOperationsRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Lists operations that match the criteria that you specify.

Specified by:

listOperationsAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the ListOperations operation returned by the service.

See Also:

AWS API Documentation

listOperationsAsync

public Future<ListOperationsResult> listOperationsAsync(ListOperationsRequest request,
                                                        AsyncHandler<ListOperationsRequest,ListOperationsResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Lists operations that match the criteria that you specify.

Specified by:

listOperationsAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the ListOperations operation returned by the service.

See Also:

AWS API Documentation

listServicesAsync

public Future<ListServicesResult> listServicesAsync(ListServicesRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Lists summary information for all the services that are associated with one or more specified namespaces.

Specified by:

listServicesAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the ListServices operation returned by the service.

See Also:

AWS API Documentation

listServicesAsync

public Future<ListServicesResult> listServicesAsync(ListServicesRequest request,
                                                    AsyncHandler<ListServicesRequest,ListServicesResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Lists summary information for all the services that are associated with one or more specified namespaces.

Specified by:

listServicesAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the ListServices operation returned by the service.

See Also:

AWS API Documentation

registerInstanceAsync

public Future<RegisterInstanceResult> registerInstanceAsync(RegisterInstanceRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Creates or updates one or more records and, optionally, creates a health check based on the settings in a specified service. When you submit a RegisterInstance request, the following occurs:

• For each DNS record that you define in the service that is specified by ServiceId, a record is created or updated in the hosted zone that is associated with the corresponding namespace.

• If the service includes HealthCheckConfig, a health check is created based on the settings in the health check configuration.

• The health check, if any, is associated with each of the new or updated records.

One RegisterInstance request must complete before you can submit another request and specify the same service ID and instance ID.

For more information, see CreateService.

When AWS Cloud Map receives a DNS query for the specified DNS name, it returns the applicable value:

• If the health check is healthy: returns all the records

• If the health check is unhealthy: returns the applicable value for the last healthy instance

• If you didn't specify a health check configuration: returns all the records

For the current limit on the number of instances that you can register using the same namespace and using the same service, see AWS Cloud Map Limits in the AWS Cloud Map Developer Guide.

Specified by:

registerInstanceAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the RegisterInstance operation returned by the service.

See Also:

AWS API Documentation

registerInstanceAsync

public Future<RegisterInstanceResult> registerInstanceAsync(RegisterInstanceRequest request,
                                                            AsyncHandler<RegisterInstanceRequest,RegisterInstanceResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Creates or updates one or more records and, optionally, creates a health check based on the settings in a specified service. When you submit a RegisterInstance request, the following occurs:

• For each DNS record that you define in the service that is specified by ServiceId, a record is created or updated in the hosted zone that is associated with the corresponding namespace.

• If the service includes HealthCheckConfig, a health check is created based on the settings in the health check configuration.

• The health check, if any, is associated with each of the new or updated records.

One RegisterInstance request must complete before you can submit another request and specify the same service ID and instance ID.

For more information, see CreateService.

When AWS Cloud Map receives a DNS query for the specified DNS name, it returns the applicable value:

• If the health check is healthy: returns all the records

• If the health check is unhealthy: returns the applicable value for the last healthy instance

• If you didn't specify a health check configuration: returns all the records

For the current limit on the number of instances that you can register using the same namespace and using the same service, see AWS Cloud Map Limits in the AWS Cloud Map Developer Guide.

Specified by:

registerInstanceAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the RegisterInstance operation returned by the service.

See Also:

AWS API Documentation

updateInstanceCustomHealthStatusAsync

public Future<UpdateInstanceCustomHealthStatusResult> updateInstanceCustomHealthStatusAsync(UpdateInstanceCustomHealthStatusRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Submits a request to change the health status of a custom health check to healthy or unhealthy.

You can use UpdateInstanceCustomHealthStatus to change the status only for custom health checks, which you define using HealthCheckCustomConfig when you create a service. You can't use it to change the status for Route 53 health checks, which you define using HealthCheckConfig.

For more information, see HealthCheckCustomConfig.

Specified by:

updateInstanceCustomHealthStatusAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the UpdateInstanceCustomHealthStatus operation returned by the service.

See Also:

AWS API Documentation

updateInstanceCustomHealthStatusAsync

public Future<UpdateInstanceCustomHealthStatusResult> updateInstanceCustomHealthStatusAsync(UpdateInstanceCustomHealthStatusRequest request,
                                                                                            AsyncHandler<UpdateInstanceCustomHealthStatusRequest,UpdateInstanceCustomHealthStatusResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Submits a request to change the health status of a custom health check to healthy or unhealthy.

You can use UpdateInstanceCustomHealthStatus to change the status only for custom health checks, which you define using HealthCheckCustomConfig when you create a service. You can't use it to change the status for Route 53 health checks, which you define using HealthCheckConfig.

For more information, see HealthCheckCustomConfig.

Specified by:

updateInstanceCustomHealthStatusAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the UpdateInstanceCustomHealthStatus operation returned by the service.

See Also:

AWS API Documentation

updateServiceAsync

public Future<UpdateServiceResult> updateServiceAsync(UpdateServiceRequest request)

Description copied from interface: AWSServiceDiscoveryAsync

Submits a request to perform the following operations:

• Add or delete DnsRecords configurations

• Update the TTL setting for existing DnsRecords configurations

• Add, update, or delete HealthCheckConfig for a specified service

For public and private DNS namespaces, you must specify all DnsRecords configurations (and, optionally, HealthCheckConfig) that you want to appear in the updated service. Any current configurations that don't appear in an UpdateService request are deleted.

When you update the TTL setting for a service, AWS Cloud Map also updates the corresponding settings in all the records and health checks that were created by using the specified service.

Specified by:

updateServiceAsync in interface AWSServiceDiscoveryAsync

Returns:

A Java Future containing the result of the UpdateService operation returned by the service.

See Also:

AWS API Documentation

updateServiceAsync

public Future<UpdateServiceResult> updateServiceAsync(UpdateServiceRequest request,
                                                      AsyncHandler<UpdateServiceRequest,UpdateServiceResult> asyncHandler)

Description copied from interface: AWSServiceDiscoveryAsync

Submits a request to perform the following operations:

• Add or delete DnsRecords configurations

• Update the TTL setting for existing DnsRecords configurations

• Add, update, or delete HealthCheckConfig for a specified service

For public and private DNS namespaces, you must specify all DnsRecords configurations (and, optionally, HealthCheckConfig) that you want to appear in the updated service. Any current configurations that don't appear in an UpdateService request are deleted.

When you update the TTL setting for a service, AWS Cloud Map also updates the corresponding settings in all the records and health checks that were created by using the specified service.

Specified by:

updateServiceAsync in interface AWSServiceDiscoveryAsync

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.

Returns:

A Java Future containing the result of the UpdateService operation returned by the service.

See Also:

AWS API Documentation

shutdown

public void shutdown()

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 getExecutorService().shutdown() followed by getExecutorService().awaitTermination() prior to calling this method.

Specified by:

shutdown in interface AWSServiceDiscovery

Overrides:

shutdown in class AmazonWebServiceClient