com.amazonaws.services.servicediscovery.AWSServiceDiscoveryAsync Maven / Gradle / Ivy
Show all versions of aws-java-sdk-servicediscovery Show documentation
/*
* Copyright 2019-2024 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.servicediscovery;
import javax.annotation.Generated;
import com.amazonaws.services.servicediscovery.model.*;
/**
* Interface for accessing ServiceDiscovery 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.servicediscovery.AbstractAWSServiceDiscoveryAsync} instead.
*
*
* Cloud Map
*
* With Cloud Map, you can configure public DNS, private DNS, or HTTP namespaces that your microservice applications run
* in. When an instance becomes available, you can call the Cloud Map API to register the instance with Cloud Map. For
* public or private DNS namespaces, 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.
*
*/
@Generated("com.amazonaws:aws-java-sdk-code-generator")
public interface AWSServiceDiscoveryAsync extends AWSServiceDiscovery {
/**
*
* Creates an HTTP namespace. Service instances registered using an HTTP namespace can be discovered using a
* DiscoverInstances request but can't be discovered using DNS.
*
*
* For the current quota on the number of namespaces that you can create using the same Amazon Web Services account,
* see Cloud Map quotas in the
* Cloud Map Developer Guide.
*
*
* @param createHttpNamespaceRequest
* @return A Java Future containing the result of the CreateHttpNamespace operation returned by the service.
* @sample AWSServiceDiscoveryAsync.CreateHttpNamespace
* @see AWS API Documentation
*/
java.util.concurrent.Future createHttpNamespaceAsync(CreateHttpNamespaceRequest createHttpNamespaceRequest);
/**
*
* Creates an HTTP namespace. Service instances registered using an HTTP namespace can be discovered using a
* DiscoverInstances request but can't be discovered using DNS.
*
*
* For the current quota on the number of namespaces that you can create using the same Amazon Web Services account,
* see Cloud Map quotas in the
* Cloud Map Developer Guide.
*
*
* @param createHttpNamespaceRequest
* @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 CreateHttpNamespace operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.CreateHttpNamespace
* @see AWS API Documentation
*/
java.util.concurrent.Future createHttpNamespaceAsync(CreateHttpNamespaceRequest createHttpNamespaceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Creates a private namespace based on DNS, which is 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 is backend.example.com.
* Service instances that are registered using a private DNS namespace can be discovered using either a
* DiscoverInstances request or using DNS. For the current quota on the number of namespaces that you
* can create using the same Amazon Web Services account, see Cloud Map quotas in the Cloud
* Map Developer Guide.
*
*
* @param createPrivateDnsNamespaceRequest
* @return A Java Future containing the result of the CreatePrivateDnsNamespace operation returned by the service.
* @sample AWSServiceDiscoveryAsync.CreatePrivateDnsNamespace
* @see AWS API Documentation
*/
java.util.concurrent.Future createPrivateDnsNamespaceAsync(
CreatePrivateDnsNamespaceRequest createPrivateDnsNamespaceRequest);
/**
*
* Creates a private namespace based on DNS, which is 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 is backend.example.com.
* Service instances that are registered using a private DNS namespace can be discovered using either a
* DiscoverInstances request or using DNS. For the current quota on the number of namespaces that you
* can create using the same Amazon Web Services account, see Cloud Map quotas in the Cloud
* Map Developer Guide.
*
*
* @param createPrivateDnsNamespaceRequest
* @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 CreatePrivateDnsNamespace operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.CreatePrivateDnsNamespace
* @see AWS API Documentation
*/
java.util.concurrent.Future createPrivateDnsNamespaceAsync(
CreatePrivateDnsNamespaceRequest createPrivateDnsNamespaceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Creates a public namespace based on DNS, which is 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 is backend.example.com. You can
* discover instances that were registered with a public DNS namespace by using either a
* DiscoverInstances request or using DNS. For the current quota on the number of namespaces that you
* can create using the same Amazon Web Services account, see Cloud Map quotas in the Cloud
* Map Developer Guide.
*
*
*
* The CreatePublicDnsNamespace API operation is not supported in the Amazon Web Services GovCloud (US)
* Regions.
*
*
*
* @param createPublicDnsNamespaceRequest
* @return A Java Future containing the result of the CreatePublicDnsNamespace operation returned by the service.
* @sample AWSServiceDiscoveryAsync.CreatePublicDnsNamespace
* @see AWS API Documentation
*/
java.util.concurrent.Future createPublicDnsNamespaceAsync(CreatePublicDnsNamespaceRequest createPublicDnsNamespaceRequest);
/**
*
* Creates a public namespace based on DNS, which is 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 is backend.example.com. You can
* discover instances that were registered with a public DNS namespace by using either a
* DiscoverInstances request or using DNS. For the current quota on the number of namespaces that you
* can create using the same Amazon Web Services account, see Cloud Map quotas in the Cloud
* Map Developer Guide.
*
*
*
* The CreatePublicDnsNamespace API operation is not supported in the Amazon Web Services GovCloud (US)
* Regions.
*
*
*
* @param createPublicDnsNamespaceRequest
* @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 CreatePublicDnsNamespace operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.CreatePublicDnsNamespace
* @see AWS API Documentation
*/
java.util.concurrent.Future createPublicDnsNamespaceAsync(CreatePublicDnsNamespaceRequest createPublicDnsNamespaceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Creates a service. This action 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 Cloud Map uses the values in the configuration to create the specified entities.
*
*
* For the current quota on the number of instances that you can register using the same namespace and using the
* same service, see Cloud Map
* quotas in the Cloud Map Developer Guide.
*
*
* @param createServiceRequest
* @return A Java Future containing the result of the CreateService operation returned by the service.
* @sample AWSServiceDiscoveryAsync.CreateService
* @see AWS
* API Documentation
*/
java.util.concurrent.Future createServiceAsync(CreateServiceRequest createServiceRequest);
/**
*
* Creates a service. This action 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 Cloud Map uses the values in the configuration to create the specified entities.
*
*
* For the current quota on the number of instances that you can register using the same namespace and using the
* same service, see Cloud Map
* quotas in the Cloud Map Developer Guide.
*
*
* @param createServiceRequest
* @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 CreateService operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.CreateService
* @see AWS
* API Documentation
*/
java.util.concurrent.Future createServiceAsync(CreateServiceRequest createServiceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Deletes a namespace from the current account. If the namespace still contains one or more services, the request
* fails.
*
*
* @param deleteNamespaceRequest
* @return A Java Future containing the result of the DeleteNamespace operation returned by the service.
* @sample AWSServiceDiscoveryAsync.DeleteNamespace
* @see AWS API Documentation
*/
java.util.concurrent.Future deleteNamespaceAsync(DeleteNamespaceRequest deleteNamespaceRequest);
/**
*
* Deletes a namespace from the current account. If the namespace still contains one or more services, the request
* fails.
*
*
* @param deleteNamespaceRequest
* @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 DeleteNamespace operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.DeleteNamespace
* @see AWS API Documentation
*/
java.util.concurrent.Future deleteNamespaceAsync(DeleteNamespaceRequest deleteNamespaceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Deletes a specified service. If the service still contains one or more registered instances, the request fails.
*
*
* @param deleteServiceRequest
* @return A Java Future containing the result of the DeleteService operation returned by the service.
* @sample AWSServiceDiscoveryAsync.DeleteService
* @see AWS
* API Documentation
*/
java.util.concurrent.Future deleteServiceAsync(DeleteServiceRequest deleteServiceRequest);
/**
*
* Deletes a specified service. If the service still contains one or more registered instances, the request fails.
*
*
* @param deleteServiceRequest
* @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 DeleteService operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.DeleteService
* @see AWS
* API Documentation
*/
java.util.concurrent.Future deleteServiceAsync(DeleteServiceRequest deleteServiceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Deletes the Amazon Route 53 DNS records and health check, if any, that Cloud Map created for the specified
* instance.
*
*
* @param deregisterInstanceRequest
* @return A Java Future containing the result of the DeregisterInstance operation returned by the service.
* @sample AWSServiceDiscoveryAsync.DeregisterInstance
* @see AWS API Documentation
*/
java.util.concurrent.Future deregisterInstanceAsync(DeregisterInstanceRequest deregisterInstanceRequest);
/**
*
* Deletes the Amazon Route 53 DNS records and health check, if any, that Cloud Map created for the specified
* instance.
*
*
* @param deregisterInstanceRequest
* @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 DeregisterInstance operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.DeregisterInstance
* @see AWS API Documentation
*/
java.util.concurrent.Future deregisterInstanceAsync(DeregisterInstanceRequest deregisterInstanceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Discovers registered instances for a specified namespace and service. You can use DiscoverInstances
* to discover instances for any type of namespace. DiscoverInstances returns a randomized list of
* instances allowing customers to distribute traffic evenly across instances. For public and private DNS
* namespaces, you can also use DNS queries to discover instances.
*
*
* @param discoverInstancesRequest
* @return A Java Future containing the result of the DiscoverInstances operation returned by the service.
* @sample AWSServiceDiscoveryAsync.DiscoverInstances
* @see AWS API Documentation
*/
java.util.concurrent.Future discoverInstancesAsync(DiscoverInstancesRequest discoverInstancesRequest);
/**
*
* Discovers registered instances for a specified namespace and service. You can use DiscoverInstances
* to discover instances for any type of namespace. DiscoverInstances returns a randomized list of
* instances allowing customers to distribute traffic evenly across instances. For public and private DNS
* namespaces, you can also use DNS queries to discover instances.
*
*
* @param discoverInstancesRequest
* @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 DiscoverInstances operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.DiscoverInstances
* @see AWS API Documentation
*/
java.util.concurrent.Future discoverInstancesAsync(DiscoverInstancesRequest discoverInstancesRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Discovers the increasing revision associated with an instance.
*
*
* @param discoverInstancesRevisionRequest
* @return A Java Future containing the result of the DiscoverInstancesRevision operation returned by the service.
* @sample AWSServiceDiscoveryAsync.DiscoverInstancesRevision
* @see AWS API Documentation
*/
java.util.concurrent.Future discoverInstancesRevisionAsync(
DiscoverInstancesRevisionRequest discoverInstancesRevisionRequest);
/**
*
* Discovers the increasing revision associated with an instance.
*
*
* @param discoverInstancesRevisionRequest
* @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 DiscoverInstancesRevision operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.DiscoverInstancesRevision
* @see AWS API Documentation
*/
java.util.concurrent.Future discoverInstancesRevisionAsync(
DiscoverInstancesRevisionRequest discoverInstancesRevisionRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Gets information about a specified instance.
*
*
* @param getInstanceRequest
* @return A Java Future containing the result of the GetInstance operation returned by the service.
* @sample AWSServiceDiscoveryAsync.GetInstance
* @see AWS
* API Documentation
*/
java.util.concurrent.Future getInstanceAsync(GetInstanceRequest getInstanceRequest);
/**
*
* Gets information about a specified instance.
*
*
* @param getInstanceRequest
* @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 GetInstance operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.GetInstance
* @see AWS
* API Documentation
*/
java.util.concurrent.Future getInstanceAsync(GetInstanceRequest getInstanceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Gets the current health status (Healthy, Unhealthy, or Unknown) of one or
* more instances that are associated with a specified service.
*
*
*
* There's a brief delay between when you register an instance and when the health status for the instance is
* available.
*
*
*
* @param getInstancesHealthStatusRequest
* @return A Java Future containing the result of the GetInstancesHealthStatus operation returned by the service.
* @sample AWSServiceDiscoveryAsync.GetInstancesHealthStatus
* @see AWS API Documentation
*/
java.util.concurrent.Future getInstancesHealthStatusAsync(GetInstancesHealthStatusRequest getInstancesHealthStatusRequest);
/**
*
* Gets the current health status (Healthy, Unhealthy, or Unknown) of one or
* more instances that are associated with a specified service.
*
*
*
* There's a brief delay between when you register an instance and when the health status for the instance is
* available.
*
*
*
* @param getInstancesHealthStatusRequest
* @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 GetInstancesHealthStatus operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.GetInstancesHealthStatus
* @see AWS API Documentation
*/
java.util.concurrent.Future getInstancesHealthStatusAsync(GetInstancesHealthStatusRequest getInstancesHealthStatusRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Gets information about a namespace.
*
*
* @param getNamespaceRequest
* @return A Java Future containing the result of the GetNamespace operation returned by the service.
* @sample AWSServiceDiscoveryAsync.GetNamespace
* @see AWS
* API Documentation
*/
java.util.concurrent.Future getNamespaceAsync(GetNamespaceRequest getNamespaceRequest);
/**
*
* Gets information about a namespace.
*
*
* @param getNamespaceRequest
* @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 GetNamespace operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.GetNamespace
* @see AWS
* API Documentation
*/
java.util.concurrent.Future getNamespaceAsync(GetNamespaceRequest getNamespaceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Gets information about any operation that returns an operation ID in the response, such as a
* CreateHttpNamespace request.
*
*
*
* To get a list of operations that match specified criteria, see ListOperations.
*
*
*
* @param getOperationRequest
* @return A Java Future containing the result of the GetOperation operation returned by the service.
* @sample AWSServiceDiscoveryAsync.GetOperation
* @see AWS
* API Documentation
*/
java.util.concurrent.Future getOperationAsync(GetOperationRequest getOperationRequest);
/**
*
* Gets information about any operation that returns an operation ID in the response, such as a
* CreateHttpNamespace request.
*
*
*
* To get a list of operations that match specified criteria, see ListOperations.
*
*
*
* @param getOperationRequest
* @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 GetOperation operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.GetOperation
* @see AWS
* API Documentation
*/
java.util.concurrent.Future getOperationAsync(GetOperationRequest getOperationRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Gets the settings for a specified service.
*
*
* @param getServiceRequest
* @return A Java Future containing the result of the GetService operation returned by the service.
* @sample AWSServiceDiscoveryAsync.GetService
* @see AWS
* API Documentation
*/
java.util.concurrent.Future getServiceAsync(GetServiceRequest getServiceRequest);
/**
*
* Gets the settings for a specified service.
*
*
* @param getServiceRequest
* @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 GetService operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.GetService
* @see AWS
* API Documentation
*/
java.util.concurrent.Future getServiceAsync(GetServiceRequest getServiceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Lists summary information about the instances that you registered by using a specified service.
*
*
* @param listInstancesRequest
* @return A Java Future containing the result of the ListInstances operation returned by the service.
* @sample AWSServiceDiscoveryAsync.ListInstances
* @see AWS
* API Documentation
*/
java.util.concurrent.Future listInstancesAsync(ListInstancesRequest listInstancesRequest);
/**
*
* Lists summary information about the instances that you registered by using a specified service.
*
*
* @param listInstancesRequest
* @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 ListInstances operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.ListInstances
* @see AWS
* API Documentation
*/
java.util.concurrent.Future listInstancesAsync(ListInstancesRequest listInstancesRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Lists summary information about the namespaces that were created by the current Amazon Web Services account.
*
*
* @param listNamespacesRequest
* @return A Java Future containing the result of the ListNamespaces operation returned by the service.
* @sample AWSServiceDiscoveryAsync.ListNamespaces
* @see AWS API Documentation
*/
java.util.concurrent.Future listNamespacesAsync(ListNamespacesRequest listNamespacesRequest);
/**
*
* Lists summary information about the namespaces that were created by the current Amazon Web Services account.
*
*
* @param listNamespacesRequest
* @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 ListNamespaces operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.ListNamespaces
* @see AWS API Documentation
*/
java.util.concurrent.Future listNamespacesAsync(ListNamespacesRequest listNamespacesRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Lists operations that match the criteria that you specify.
*
*
* @param listOperationsRequest
* @return A Java Future containing the result of the ListOperations operation returned by the service.
* @sample AWSServiceDiscoveryAsync.ListOperations
* @see AWS API Documentation
*/
java.util.concurrent.Future listOperationsAsync(ListOperationsRequest listOperationsRequest);
/**
*
* Lists operations that match the criteria that you specify.
*
*
* @param listOperationsRequest
* @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 ListOperations operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.ListOperations
* @see AWS API Documentation
*/
java.util.concurrent.Future listOperationsAsync(ListOperationsRequest listOperationsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Lists summary information for all the services that are associated with one or more namespaces.
*
*
* @param listServicesRequest
* @return A Java Future containing the result of the ListServices operation returned by the service.
* @sample AWSServiceDiscoveryAsync.ListServices
* @see AWS
* API Documentation
*/
java.util.concurrent.Future listServicesAsync(ListServicesRequest listServicesRequest);
/**
*
* Lists summary information for all the services that are associated with one or more namespaces.
*
*
* @param listServicesRequest
* @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 ListServices operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.ListServices
* @see AWS
* API Documentation
*/
java.util.concurrent.Future listServicesAsync(ListServicesRequest listServicesRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Lists tags for the specified resource.
*
*
* @param listTagsForResourceRequest
* @return A Java Future containing the result of the ListTagsForResource operation returned by the service.
* @sample AWSServiceDiscoveryAsync.ListTagsForResource
* @see AWS API Documentation
*/
java.util.concurrent.Future listTagsForResourceAsync(ListTagsForResourceRequest listTagsForResourceRequest);
/**
*
* Lists tags for the specified resource.
*
*
* @param listTagsForResourceRequest
* @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 ListTagsForResource operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.ListTagsForResource
* @see AWS API Documentation
*/
java.util.concurrent.Future listTagsForResourceAsync(ListTagsForResourceRequest listTagsForResourceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* 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's specified by ServiceId, a record is
* created or updated in the hosted zone that's 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 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 quota on the number of instances that you can register using the same namespace and using the
* same service, see Cloud Map
* quotas in the Cloud Map Developer Guide.
*
*
* @param registerInstanceRequest
* @return A Java Future containing the result of the RegisterInstance operation returned by the service.
* @sample AWSServiceDiscoveryAsync.RegisterInstance
* @see AWS API Documentation
*/
java.util.concurrent.Future registerInstanceAsync(RegisterInstanceRequest registerInstanceRequest);
/**
*
* 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's specified by ServiceId, a record is
* created or updated in the hosted zone that's 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 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 quota on the number of instances that you can register using the same namespace and using the
* same service, see Cloud Map
* quotas in the Cloud Map Developer Guide.
*
*
* @param registerInstanceRequest
* @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 RegisterInstance operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.RegisterInstance
* @see AWS API Documentation
*/
java.util.concurrent.Future registerInstanceAsync(RegisterInstanceRequest registerInstanceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Adds one or more tags to the specified resource.
*
*
* @param tagResourceRequest
* @return A Java Future containing the result of the TagResource operation returned by the service.
* @sample AWSServiceDiscoveryAsync.TagResource
* @see AWS
* API Documentation
*/
java.util.concurrent.Future tagResourceAsync(TagResourceRequest tagResourceRequest);
/**
*
* Adds one or more tags to the specified resource.
*
*
* @param tagResourceRequest
* @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 TagResource operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.TagResource
* @see AWS
* API Documentation
*/
java.util.concurrent.Future tagResourceAsync(TagResourceRequest tagResourceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Removes one or more tags from the specified resource.
*
*
* @param untagResourceRequest
* @return A Java Future containing the result of the UntagResource operation returned by the service.
* @sample AWSServiceDiscoveryAsync.UntagResource
* @see AWS
* API Documentation
*/
java.util.concurrent.Future untagResourceAsync(UntagResourceRequest untagResourceRequest);
/**
*
* Removes one or more tags from the specified resource.
*
*
* @param untagResourceRequest
* @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 UntagResource operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.UntagResource
* @see AWS
* API Documentation
*/
java.util.concurrent.Future untagResourceAsync(UntagResourceRequest untagResourceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Updates an HTTP namespace.
*
*
* @param updateHttpNamespaceRequest
* @return A Java Future containing the result of the UpdateHttpNamespace operation returned by the service.
* @sample AWSServiceDiscoveryAsync.UpdateHttpNamespace
* @see AWS API Documentation
*/
java.util.concurrent.Future updateHttpNamespaceAsync(UpdateHttpNamespaceRequest updateHttpNamespaceRequest);
/**
*
* Updates an HTTP namespace.
*
*
* @param updateHttpNamespaceRequest
* @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 UpdateHttpNamespace operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.UpdateHttpNamespace
* @see AWS API Documentation
*/
java.util.concurrent.Future updateHttpNamespaceAsync(UpdateHttpNamespaceRequest updateHttpNamespaceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* 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.
*
*
* @param updateInstanceCustomHealthStatusRequest
* @return A Java Future containing the result of the UpdateInstanceCustomHealthStatus operation returned by the
* service.
* @sample AWSServiceDiscoveryAsync.UpdateInstanceCustomHealthStatus
* @see AWS API Documentation
*/
java.util.concurrent.Future updateInstanceCustomHealthStatusAsync(
UpdateInstanceCustomHealthStatusRequest updateInstanceCustomHealthStatusRequest);
/**
*
* 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.
*
*
* @param updateInstanceCustomHealthStatusRequest
* @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 UpdateInstanceCustomHealthStatus operation returned by the
* service.
* @sample AWSServiceDiscoveryAsyncHandler.UpdateInstanceCustomHealthStatus
* @see AWS API Documentation
*/
java.util.concurrent.Future updateInstanceCustomHealthStatusAsync(
UpdateInstanceCustomHealthStatusRequest updateInstanceCustomHealthStatusRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Updates a private DNS namespace.
*
*
* @param updatePrivateDnsNamespaceRequest
* @return A Java Future containing the result of the UpdatePrivateDnsNamespace operation returned by the service.
* @sample AWSServiceDiscoveryAsync.UpdatePrivateDnsNamespace
* @see AWS API Documentation
*/
java.util.concurrent.Future updatePrivateDnsNamespaceAsync(
UpdatePrivateDnsNamespaceRequest updatePrivateDnsNamespaceRequest);
/**
*
* Updates a private DNS namespace.
*
*
* @param updatePrivateDnsNamespaceRequest
* @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 UpdatePrivateDnsNamespace operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.UpdatePrivateDnsNamespace
* @see AWS API Documentation
*/
java.util.concurrent.Future updatePrivateDnsNamespaceAsync(
UpdatePrivateDnsNamespaceRequest updatePrivateDnsNamespaceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Updates a public DNS namespace.
*
*
* @param updatePublicDnsNamespaceRequest
* @return A Java Future containing the result of the UpdatePublicDnsNamespace operation returned by the service.
* @sample AWSServiceDiscoveryAsync.UpdatePublicDnsNamespace
* @see AWS API Documentation
*/
java.util.concurrent.Future updatePublicDnsNamespaceAsync(UpdatePublicDnsNamespaceRequest updatePublicDnsNamespaceRequest);
/**
*
* Updates a public DNS namespace.
*
*
* @param updatePublicDnsNamespaceRequest
* @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 UpdatePublicDnsNamespace operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.UpdatePublicDnsNamespace
* @see AWS API Documentation
*/
java.util.concurrent.Future updatePublicDnsNamespaceAsync(UpdatePublicDnsNamespaceRequest updatePublicDnsNamespaceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Submits a request to perform the following operations:
*
*
* -
*
* Update the TTL setting for existing DnsRecords configurations
*
*
* -
*
* Add, update, or delete HealthCheckConfig for a specified service
*
*
*
* You can't add, update, or delete a HealthCheckCustomConfig configuration.
*
*
*
*
* For public and private DNS namespaces, note the following:
*
*
* -
*
* If you omit any existing DnsRecords or HealthCheckConfig configurations from an
* UpdateService request, the configurations are deleted from the service.
*
*
* -
*
* If you omit an existing HealthCheckCustomConfig configuration from an UpdateService
* request, the configuration isn't deleted from the service.
*
*
*
*
* When you update settings for a service, Cloud Map also updates the corresponding settings in all the records and
* health checks that were created by using the specified service.
*
*
* @param updateServiceRequest
* @return A Java Future containing the result of the UpdateService operation returned by the service.
* @sample AWSServiceDiscoveryAsync.UpdateService
* @see AWS
* API Documentation
*/
java.util.concurrent.Future updateServiceAsync(UpdateServiceRequest updateServiceRequest);
/**
*
* Submits a request to perform the following operations:
*
*
* -
*
* Update the TTL setting for existing DnsRecords configurations
*
*
* -
*
* Add, update, or delete HealthCheckConfig for a specified service
*
*
*
* You can't add, update, or delete a HealthCheckCustomConfig configuration.
*
*
*
*
* For public and private DNS namespaces, note the following:
*
*
* -
*
* If you omit any existing DnsRecords or HealthCheckConfig configurations from an
* UpdateService request, the configurations are deleted from the service.
*
*
* -
*
* If you omit an existing HealthCheckCustomConfig configuration from an UpdateService
* request, the configuration isn't deleted from the service.
*
*
*
*
* When you update settings for a service, Cloud Map also updates the corresponding settings in all the records and
* health checks that were created by using the specified service.
*
*
* @param updateServiceRequest
* @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 UpdateService operation returned by the service.
* @sample AWSServiceDiscoveryAsyncHandler.UpdateService
* @see AWS
* API Documentation
*/
java.util.concurrent.Future updateServiceAsync(UpdateServiceRequest updateServiceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
}