@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AWSServiceDiscoveryAsyncClient extends AWSServiceDiscoveryClient implements AWSServiceDiscoveryAsync
AsyncHandler can be used to receive
notification when an asynchronous operation completes.
Amazon Route 53 auto naming lets you configure public or private namespaces that your microservice applications run in. When instances of the service become available, you can call the auto naming API to register the instance, and Route 53 automatically creates up to five DNS records and an optional health check. Clients that submit DNS queries for the service receive an answer that contains up to eight healthy records.
LOGGING_AWS_REQUEST_METRICENDPOINT_PREFIXbuilder, createPrivateDnsNamespace, createPublicDnsNamespace, createService, deleteNamespace, deleteService, deregisterInstance, getCachedResponseMetadata, getInstance, getInstancesHealthStatus, getNamespace, getOperation, getService, listInstances, listNamespaces, listOperations, listServices, registerInstance, updateInstanceCustomHealthStatus, updateServiceaddRequestHandler, addRequestHandler, configureRegion, getEndpointPrefix, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffsetequals, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitcreatePrivateDnsNamespace, createPublicDnsNamespace, createService, deleteNamespace, deleteService, deregisterInstance, getCachedResponseMetadata, getInstance, getInstancesHealthStatus, getNamespace, getOperation, getService, listInstances, listNamespaces, listOperations, listServices, registerInstance, updateInstanceCustomHealthStatus, updateServicepublic static AWSServiceDiscoveryAsyncClientBuilder asyncBuilder()
public ExecutorService getExecutorService()
public Future<CreatePrivateDnsNamespaceResult> createPrivateDnsNamespaceAsync(CreatePrivateDnsNamespaceRequest request)
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 Limits on Auto Naming in the Route 53 Developer Guide.
createPrivateDnsNamespaceAsync in interface AWSServiceDiscoveryAsyncpublic Future<CreatePrivateDnsNamespaceResult> createPrivateDnsNamespaceAsync(CreatePrivateDnsNamespaceRequest request, AsyncHandler<CreatePrivateDnsNamespaceRequest,CreatePrivateDnsNamespaceResult> asyncHandler)
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 Limits on Auto Naming in the Route 53 Developer Guide.
createPrivateDnsNamespaceAsync in interface AWSServiceDiscoveryAsyncasyncHandler - 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.public Future<CreatePublicDnsNamespaceResult> createPublicDnsNamespaceAsync(CreatePublicDnsNamespaceRequest request)
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 Limits on Auto Naming in the Route 53 Developer Guide.
createPublicDnsNamespaceAsync in interface AWSServiceDiscoveryAsyncpublic Future<CreatePublicDnsNamespaceResult> createPublicDnsNamespaceAsync(CreatePublicDnsNamespaceRequest request, AsyncHandler<CreatePublicDnsNamespaceRequest,CreatePublicDnsNamespaceResult> asyncHandler)
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 Limits on Auto Naming in the Route 53 Developer Guide.
createPublicDnsNamespaceAsync in interface AWSServiceDiscoveryAsyncasyncHandler - 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.public Future<CreateServiceResult> createServiceAsync(CreateServiceRequest request)
AWSServiceDiscoveryAsyncCreates a service, which defines the configuration for the following entities:
Up to three records (A, AAAA, and SRV) or one CNAME record
Optionally, a health check
After you create the service, you can submit a RegisterInstance request, and Amazon Route 53 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 Limits on Auto Naming in the Route 53 Developer Guide.
createServiceAsync in interface AWSServiceDiscoveryAsyncpublic Future<CreateServiceResult> createServiceAsync(CreateServiceRequest request, AsyncHandler<CreateServiceRequest,CreateServiceResult> asyncHandler)
AWSServiceDiscoveryAsyncCreates a service, which defines the configuration for the following entities:
Up to three records (A, AAAA, and SRV) or one CNAME record
Optionally, a health check
After you create the service, you can submit a RegisterInstance request, and Amazon Route 53 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 Limits on Auto Naming in the Route 53 Developer Guide.
createServiceAsync in interface AWSServiceDiscoveryAsyncasyncHandler - 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.public Future<DeleteNamespaceResult> deleteNamespaceAsync(DeleteNamespaceRequest request)
AWSServiceDiscoveryAsyncDeletes a namespace from the current account. If the namespace still contains one or more services, the request fails.
deleteNamespaceAsync in interface AWSServiceDiscoveryAsyncpublic Future<DeleteNamespaceResult> deleteNamespaceAsync(DeleteNamespaceRequest request, AsyncHandler<DeleteNamespaceRequest,DeleteNamespaceResult> asyncHandler)
AWSServiceDiscoveryAsyncDeletes a namespace from the current account. If the namespace still contains one or more services, the request fails.
deleteNamespaceAsync in interface AWSServiceDiscoveryAsyncasyncHandler - 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.public Future<DeleteServiceResult> deleteServiceAsync(DeleteServiceRequest request)
AWSServiceDiscoveryAsyncDeletes a specified service. If the service still contains one or more registered instances, the request fails.
deleteServiceAsync in interface AWSServiceDiscoveryAsyncpublic Future<DeleteServiceResult> deleteServiceAsync(DeleteServiceRequest request, AsyncHandler<DeleteServiceRequest,DeleteServiceResult> asyncHandler)
AWSServiceDiscoveryAsyncDeletes a specified service. If the service still contains one or more registered instances, the request fails.
deleteServiceAsync in interface AWSServiceDiscoveryAsyncasyncHandler - 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.public Future<DeregisterInstanceResult> deregisterInstanceAsync(DeregisterInstanceRequest request)
AWSServiceDiscoveryAsyncDeletes the records and the health check, if any, that Amazon Route 53 created for the specified instance.
deregisterInstanceAsync in interface AWSServiceDiscoveryAsyncpublic Future<DeregisterInstanceResult> deregisterInstanceAsync(DeregisterInstanceRequest request, AsyncHandler<DeregisterInstanceRequest,DeregisterInstanceResult> asyncHandler)
AWSServiceDiscoveryAsyncDeletes the records and the health check, if any, that Amazon Route 53 created for the specified instance.
deregisterInstanceAsync in interface AWSServiceDiscoveryAsyncasyncHandler - 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.public Future<GetInstanceResult> getInstanceAsync(GetInstanceRequest request)
AWSServiceDiscoveryAsyncGets information about a specified instance.
getInstanceAsync in interface AWSServiceDiscoveryAsyncpublic Future<GetInstanceResult> getInstanceAsync(GetInstanceRequest request, AsyncHandler<GetInstanceRequest,GetInstanceResult> asyncHandler)
AWSServiceDiscoveryAsyncGets information about a specified instance.
getInstanceAsync in interface AWSServiceDiscoveryAsyncasyncHandler - 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.public Future<GetInstancesHealthStatusResult> getInstancesHealthStatusAsync(GetInstancesHealthStatusRequest request)
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.
getInstancesHealthStatusAsync in interface AWSServiceDiscoveryAsyncpublic Future<GetInstancesHealthStatusResult> getInstancesHealthStatusAsync(GetInstancesHealthStatusRequest request, AsyncHandler<GetInstancesHealthStatusRequest,GetInstancesHealthStatusResult> asyncHandler)
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.
getInstancesHealthStatusAsync in interface AWSServiceDiscoveryAsyncasyncHandler - 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.public Future<GetNamespaceResult> getNamespaceAsync(GetNamespaceRequest request)
AWSServiceDiscoveryAsyncGets information about a namespace.
getNamespaceAsync in interface AWSServiceDiscoveryAsyncpublic Future<GetNamespaceResult> getNamespaceAsync(GetNamespaceRequest request, AsyncHandler<GetNamespaceRequest,GetNamespaceResult> asyncHandler)
AWSServiceDiscoveryAsyncGets information about a namespace.
getNamespaceAsync in interface AWSServiceDiscoveryAsyncasyncHandler - 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.public Future<GetOperationResult> getOperationAsync(GetOperationRequest request)
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.
getOperationAsync in interface AWSServiceDiscoveryAsyncpublic Future<GetOperationResult> getOperationAsync(GetOperationRequest request, AsyncHandler<GetOperationRequest,GetOperationResult> asyncHandler)
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.
getOperationAsync in interface AWSServiceDiscoveryAsyncasyncHandler - 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.public Future<GetServiceResult> getServiceAsync(GetServiceRequest request)
AWSServiceDiscoveryAsyncGets the settings for a specified service.
getServiceAsync in interface AWSServiceDiscoveryAsyncpublic Future<GetServiceResult> getServiceAsync(GetServiceRequest request, AsyncHandler<GetServiceRequest,GetServiceResult> asyncHandler)
AWSServiceDiscoveryAsyncGets the settings for a specified service.
getServiceAsync in interface AWSServiceDiscoveryAsyncasyncHandler - 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.public Future<ListInstancesResult> listInstancesAsync(ListInstancesRequest request)
AWSServiceDiscoveryAsyncLists summary information about the instances that you registered by using a specified service.
listInstancesAsync in interface AWSServiceDiscoveryAsyncpublic Future<ListInstancesResult> listInstancesAsync(ListInstancesRequest request, AsyncHandler<ListInstancesRequest,ListInstancesResult> asyncHandler)
AWSServiceDiscoveryAsyncLists summary information about the instances that you registered by using a specified service.
listInstancesAsync in interface AWSServiceDiscoveryAsyncasyncHandler - 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.public Future<ListNamespacesResult> listNamespacesAsync(ListNamespacesRequest request)
AWSServiceDiscoveryAsyncLists summary information about the namespaces that were created by the current AWS account.
listNamespacesAsync in interface AWSServiceDiscoveryAsyncpublic Future<ListNamespacesResult> listNamespacesAsync(ListNamespacesRequest request, AsyncHandler<ListNamespacesRequest,ListNamespacesResult> asyncHandler)
AWSServiceDiscoveryAsyncLists summary information about the namespaces that were created by the current AWS account.
listNamespacesAsync in interface AWSServiceDiscoveryAsyncasyncHandler - 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.public Future<ListOperationsResult> listOperationsAsync(ListOperationsRequest request)
AWSServiceDiscoveryAsyncLists operations that match the criteria that you specify.
listOperationsAsync in interface AWSServiceDiscoveryAsyncpublic Future<ListOperationsResult> listOperationsAsync(ListOperationsRequest request, AsyncHandler<ListOperationsRequest,ListOperationsResult> asyncHandler)
AWSServiceDiscoveryAsyncLists operations that match the criteria that you specify.
listOperationsAsync in interface AWSServiceDiscoveryAsyncasyncHandler - 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.public Future<ListServicesResult> listServicesAsync(ListServicesRequest request)
AWSServiceDiscoveryAsyncLists summary information for all the services that are associated with one or more specified namespaces.
listServicesAsync in interface AWSServiceDiscoveryAsyncpublic Future<ListServicesResult> listServicesAsync(ListServicesRequest request, AsyncHandler<ListServicesRequest,ListServicesResult> asyncHandler)
AWSServiceDiscoveryAsyncLists summary information for all the services that are associated with one or more specified namespaces.
listServicesAsync in interface AWSServiceDiscoveryAsyncasyncHandler - 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.public Future<RegisterInstanceResult> registerInstanceAsync(RegisterInstanceRequest request)
AWSServiceDiscoveryAsync
Creates or updates one or more records and optionally a health check based on the settings in a specified
service. When you submit a RegisterInstance request, Amazon Route 53 does the following:
For each DNS record that you define in the service specified by ServiceId, creates or updates a
record in the hosted zone that is associated with the corresponding namespace
If the service includes HealthCheckConfig, creates or updates a health check based on the settings
in the health check configuration
Associates the health check, if any, with each of the 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 Route 53 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 Limits on Auto Naming in the Route 53 Developer Guide.
registerInstanceAsync in interface AWSServiceDiscoveryAsyncpublic Future<RegisterInstanceResult> registerInstanceAsync(RegisterInstanceRequest request, AsyncHandler<RegisterInstanceRequest,RegisterInstanceResult> asyncHandler)
AWSServiceDiscoveryAsync
Creates or updates one or more records and optionally a health check based on the settings in a specified
service. When you submit a RegisterInstance request, Amazon Route 53 does the following:
For each DNS record that you define in the service specified by ServiceId, creates or updates a
record in the hosted zone that is associated with the corresponding namespace
If the service includes HealthCheckConfig, creates or updates a health check based on the settings
in the health check configuration
Associates the health check, if any, with each of the 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 Route 53 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 Limits on Auto Naming in the Route 53 Developer Guide.
registerInstanceAsync in interface AWSServiceDiscoveryAsyncasyncHandler - 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.public Future<UpdateInstanceCustomHealthStatusResult> updateInstanceCustomHealthStatusAsync(UpdateInstanceCustomHealthStatusRequest request)
updateInstanceCustomHealthStatusAsync in interface AWSServiceDiscoveryAsyncpublic Future<UpdateInstanceCustomHealthStatusResult> updateInstanceCustomHealthStatusAsync(UpdateInstanceCustomHealthStatusRequest request, AsyncHandler<UpdateInstanceCustomHealthStatusRequest,UpdateInstanceCustomHealthStatusResult> asyncHandler)
updateInstanceCustomHealthStatusAsync in interface AWSServiceDiscoveryAsyncasyncHandler - 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.public Future<UpdateServiceResult> updateServiceAsync(UpdateServiceRequest request)
AWSServiceDiscoveryAsyncSubmits 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
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, Amazon Route 53 also updates the corresponding settings in all the records and health checks that were created by using the specified service.
updateServiceAsync in interface AWSServiceDiscoveryAsyncpublic Future<UpdateServiceResult> updateServiceAsync(UpdateServiceRequest request, AsyncHandler<UpdateServiceRequest,UpdateServiceResult> asyncHandler)
AWSServiceDiscoveryAsyncSubmits 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
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, Amazon Route 53 also updates the corresponding settings in all the records and health checks that were created by using the specified service.
updateServiceAsync in interface AWSServiceDiscoveryAsyncasyncHandler - 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.public void shutdown()
getExecutorService().shutdown() followed by getExecutorService().awaitTermination() prior to
calling this method.shutdown in interface AWSServiceDiscoveryshutdown in class AmazonWebServiceClientCopyright © 2013 Amazon Web Services, Inc. All Rights Reserved.