/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.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. 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. 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); /** *

* 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 * CreateService 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 * CreateService 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 specified 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 specified 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); }