@Generated(value="software.amazon.awssdk:codegen") public interface ServiceDiscoveryAsyncClient extends SdkClient
builder()
method.
AWS Cloud Map lets you configure public DNS, private DNS, or HTTP namespaces that your microservice applications run in. When an instance of the service becomes available, you can call the AWS Cloud Map API to register the instance with AWS Cloud Map. For public or private DNS namespaces, AWS Cloud Map automatically creates DNS records and an optional health check. Clients that submit public or private DNS queries, or HTTP requests, for the service receive an answer that contains up to eight healthy records.
| Modifier and Type | Field and Description |
|---|---|
static String |
SERVICE_NAME |
| Modifier and Type | Method and Description |
|---|---|
static ServiceDiscoveryAsyncClientBuilder |
builder()
Create a builder that can be used to configure and create a
ServiceDiscoveryAsyncClient. |
static ServiceDiscoveryAsyncClient |
create()
Create a
ServiceDiscoveryAsyncClient with the region loaded from the
DefaultAwsRegionProviderChain and credentials loaded from the
DefaultCredentialsProvider. |
default CompletableFuture<CreateHttpNamespaceResponse> |
createHttpNamespace(Consumer<CreateHttpNamespaceRequest.Builder> createHttpNamespaceRequest)
Creates an HTTP namespace.
|
default CompletableFuture<CreateHttpNamespaceResponse> |
createHttpNamespace(CreateHttpNamespaceRequest createHttpNamespaceRequest)
Creates an HTTP namespace.
|
default CompletableFuture<CreatePrivateDnsNamespaceResponse> |
createPrivateDnsNamespace(Consumer<CreatePrivateDnsNamespaceRequest.Builder> createPrivateDnsNamespaceRequest)
Creates a private namespace based on DNS, which will be visible only inside a specified Amazon VPC.
|
default CompletableFuture<CreatePrivateDnsNamespaceResponse> |
createPrivateDnsNamespace(CreatePrivateDnsNamespaceRequest createPrivateDnsNamespaceRequest)
Creates a private namespace based on DNS, which will be visible only inside a specified Amazon VPC.
|
default CompletableFuture<CreatePublicDnsNamespaceResponse> |
createPublicDnsNamespace(Consumer<CreatePublicDnsNamespaceRequest.Builder> createPublicDnsNamespaceRequest)
Creates a public namespace based on DNS, which will be visible on the internet.
|
default CompletableFuture<CreatePublicDnsNamespaceResponse> |
createPublicDnsNamespace(CreatePublicDnsNamespaceRequest createPublicDnsNamespaceRequest)
Creates a public namespace based on DNS, which will be visible on the internet.
|
default CompletableFuture<CreateServiceResponse> |
createService(Consumer<CreateServiceRequest.Builder> createServiceRequest)
Creates a service, which defines the configuration for the following entities:
|
default CompletableFuture<CreateServiceResponse> |
createService(CreateServiceRequest createServiceRequest)
Creates a service, which defines the configuration for the following entities:
|
default CompletableFuture<DeleteNamespaceResponse> |
deleteNamespace(Consumer<DeleteNamespaceRequest.Builder> deleteNamespaceRequest)
Deletes a namespace from the current account.
|
default CompletableFuture<DeleteNamespaceResponse> |
deleteNamespace(DeleteNamespaceRequest deleteNamespaceRequest)
Deletes a namespace from the current account.
|
default CompletableFuture<DeleteServiceResponse> |
deleteService(Consumer<DeleteServiceRequest.Builder> deleteServiceRequest)
Deletes a specified service.
|
default CompletableFuture<DeleteServiceResponse> |
deleteService(DeleteServiceRequest deleteServiceRequest)
Deletes a specified service.
|
default CompletableFuture<DeregisterInstanceResponse> |
deregisterInstance(Consumer<DeregisterInstanceRequest.Builder> deregisterInstanceRequest)
Deletes the Amazon Route 53 DNS records and health check, if any, that AWS Cloud Map created for the specified
instance.
|
default CompletableFuture<DeregisterInstanceResponse> |
deregisterInstance(DeregisterInstanceRequest deregisterInstanceRequest)
Deletes the Amazon Route 53 DNS records and health check, if any, that AWS Cloud Map created for the specified
instance.
|
default CompletableFuture<DiscoverInstancesResponse> |
discoverInstances(Consumer<DiscoverInstancesRequest.Builder> discoverInstancesRequest)
Discovers registered instances for a specified namespace and service.
|
default CompletableFuture<DiscoverInstancesResponse> |
discoverInstances(DiscoverInstancesRequest discoverInstancesRequest)
Discovers registered instances for a specified namespace and service.
|
default CompletableFuture<GetInstanceResponse> |
getInstance(Consumer<GetInstanceRequest.Builder> getInstanceRequest)
Gets information about a specified instance.
|
default CompletableFuture<GetInstanceResponse> |
getInstance(GetInstanceRequest getInstanceRequest)
Gets information about a specified instance.
|
default CompletableFuture<GetInstancesHealthStatusResponse> |
getInstancesHealthStatus(Consumer<GetInstancesHealthStatusRequest.Builder> getInstancesHealthStatusRequest)
Gets the current health status (
Healthy, Unhealthy, or Unknown) of one or
more instances that are associated with a specified service. |
default CompletableFuture<GetInstancesHealthStatusResponse> |
getInstancesHealthStatus(GetInstancesHealthStatusRequest getInstancesHealthStatusRequest)
Gets the current health status (
Healthy, Unhealthy, or Unknown) of one or
more instances that are associated with a specified service. |
default GetInstancesHealthStatusPublisher |
getInstancesHealthStatusPaginator(Consumer<GetInstancesHealthStatusRequest.Builder> getInstancesHealthStatusRequest)
Gets the current health status (
Healthy, Unhealthy, or Unknown) of one or
more instances that are associated with a specified service. |
default GetInstancesHealthStatusPublisher |
getInstancesHealthStatusPaginator(GetInstancesHealthStatusRequest getInstancesHealthStatusRequest)
Gets the current health status (
Healthy, Unhealthy, or Unknown) of one or
more instances that are associated with a specified service. |
default CompletableFuture<GetNamespaceResponse> |
getNamespace(Consumer<GetNamespaceRequest.Builder> getNamespaceRequest)
Gets information about a namespace.
|
default CompletableFuture<GetNamespaceResponse> |
getNamespace(GetNamespaceRequest getNamespaceRequest)
Gets information about a namespace.
|
default CompletableFuture<GetOperationResponse> |
getOperation(Consumer<GetOperationRequest.Builder> getOperationRequest)
Gets information about any operation that returns an operation ID in the response, such as a
CreateService request. |
default CompletableFuture<GetOperationResponse> |
getOperation(GetOperationRequest getOperationRequest)
Gets information about any operation that returns an operation ID in the response, such as a
CreateService request. |
default CompletableFuture<GetServiceResponse> |
getService(Consumer<GetServiceRequest.Builder> getServiceRequest)
Gets the settings for a specified service.
|
default CompletableFuture<GetServiceResponse> |
getService(GetServiceRequest getServiceRequest)
Gets the settings for a specified service.
|
default CompletableFuture<ListInstancesResponse> |
listInstances(Consumer<ListInstancesRequest.Builder> listInstancesRequest)
Lists summary information about the instances that you registered by using a specified service.
|
default CompletableFuture<ListInstancesResponse> |
listInstances(ListInstancesRequest listInstancesRequest)
Lists summary information about the instances that you registered by using a specified service.
|
default ListInstancesPublisher |
listInstancesPaginator(Consumer<ListInstancesRequest.Builder> listInstancesRequest)
Lists summary information about the instances that you registered by using a specified service.
|
default ListInstancesPublisher |
listInstancesPaginator(ListInstancesRequest listInstancesRequest)
Lists summary information about the instances that you registered by using a specified service.
|
default CompletableFuture<ListNamespacesResponse> |
listNamespaces()
Lists summary information about the namespaces that were created by the current AWS account.
|
default CompletableFuture<ListNamespacesResponse> |
listNamespaces(Consumer<ListNamespacesRequest.Builder> listNamespacesRequest)
Lists summary information about the namespaces that were created by the current AWS account.
|
default CompletableFuture<ListNamespacesResponse> |
listNamespaces(ListNamespacesRequest listNamespacesRequest)
Lists summary information about the namespaces that were created by the current AWS account.
|
default ListNamespacesPublisher |
listNamespacesPaginator()
Lists summary information about the namespaces that were created by the current AWS account.
|
default ListNamespacesPublisher |
listNamespacesPaginator(Consumer<ListNamespacesRequest.Builder> listNamespacesRequest)
Lists summary information about the namespaces that were created by the current AWS account.
|
default ListNamespacesPublisher |
listNamespacesPaginator(ListNamespacesRequest listNamespacesRequest)
Lists summary information about the namespaces that were created by the current AWS account.
|
default CompletableFuture<ListOperationsResponse> |
listOperations()
Lists operations that match the criteria that you specify.
|
default CompletableFuture<ListOperationsResponse> |
listOperations(Consumer<ListOperationsRequest.Builder> listOperationsRequest)
Lists operations that match the criteria that you specify.
|
default CompletableFuture<ListOperationsResponse> |
listOperations(ListOperationsRequest listOperationsRequest)
Lists operations that match the criteria that you specify.
|
default ListOperationsPublisher |
listOperationsPaginator()
Lists operations that match the criteria that you specify.
|
default ListOperationsPublisher |
listOperationsPaginator(Consumer<ListOperationsRequest.Builder> listOperationsRequest)
Lists operations that match the criteria that you specify.
|
default ListOperationsPublisher |
listOperationsPaginator(ListOperationsRequest listOperationsRequest)
Lists operations that match the criteria that you specify.
|
default CompletableFuture<ListServicesResponse> |
listServices()
Lists summary information for all the services that are associated with one or more specified namespaces.
|
default CompletableFuture<ListServicesResponse> |
listServices(Consumer<ListServicesRequest.Builder> listServicesRequest)
Lists summary information for all the services that are associated with one or more specified namespaces.
|
default CompletableFuture<ListServicesResponse> |
listServices(ListServicesRequest listServicesRequest)
Lists summary information for all the services that are associated with one or more specified namespaces.
|
default ListServicesPublisher |
listServicesPaginator()
Lists summary information for all the services that are associated with one or more specified namespaces.
|
default ListServicesPublisher |
listServicesPaginator(Consumer<ListServicesRequest.Builder> listServicesRequest)
Lists summary information for all the services that are associated with one or more specified namespaces.
|
default ListServicesPublisher |
listServicesPaginator(ListServicesRequest listServicesRequest)
Lists summary information for all the services that are associated with one or more specified namespaces.
|
default CompletableFuture<RegisterInstanceResponse> |
registerInstance(Consumer<RegisterInstanceRequest.Builder> registerInstanceRequest)
Creates or updates one or more records and, optionally, creates a health check based on the settings in a
specified service.
|
default CompletableFuture<RegisterInstanceResponse> |
registerInstance(RegisterInstanceRequest registerInstanceRequest)
Creates or updates one or more records and, optionally, creates a health check based on the settings in a
specified service.
|
default CompletableFuture<UpdateInstanceCustomHealthStatusResponse> |
updateInstanceCustomHealthStatus(Consumer<UpdateInstanceCustomHealthStatusRequest.Builder> updateInstanceCustomHealthStatusRequest)
Submits a request to change the health status of a custom health check to healthy or unhealthy.
|
default CompletableFuture<UpdateInstanceCustomHealthStatusResponse> |
updateInstanceCustomHealthStatus(UpdateInstanceCustomHealthStatusRequest updateInstanceCustomHealthStatusRequest)
Submits a request to change the health status of a custom health check to healthy or unhealthy.
|
default CompletableFuture<UpdateServiceResponse> |
updateService(Consumer<UpdateServiceRequest.Builder> updateServiceRequest)
Submits a request to perform the following operations:
|
default CompletableFuture<UpdateServiceResponse> |
updateService(UpdateServiceRequest updateServiceRequest)
Submits a request to perform the following operations:
|
serviceNameclosestatic final String SERVICE_NAME
static ServiceDiscoveryAsyncClient create()
ServiceDiscoveryAsyncClient with the region loaded from the
DefaultAwsRegionProviderChain and credentials loaded from the
DefaultCredentialsProvider.static ServiceDiscoveryAsyncClientBuilder builder()
ServiceDiscoveryAsyncClient.default CompletableFuture<CreateHttpNamespaceResponse> createHttpNamespace(CreateHttpNamespaceRequest createHttpNamespaceRequest)
Creates an HTTP namespace. Service instances that you register using an HTTP namespace can be discovered using a
DiscoverInstances request but can't be discovered using DNS.
For the current limit on the number of namespaces that you can create using the same AWS account, see AWS Cloud Map Limits in the AWS Cloud Map Developer Guide.
createHttpNamespaceRequest - default CompletableFuture<CreateHttpNamespaceResponse> createHttpNamespace(Consumer<CreateHttpNamespaceRequest.Builder> createHttpNamespaceRequest)
Creates an HTTP namespace. Service instances that you register using an HTTP namespace can be discovered using a
DiscoverInstances request but can't be discovered using DNS.
For the current limit on the number of namespaces that you can create using the same AWS account, see AWS Cloud Map Limits in the AWS Cloud Map Developer Guide.
This is a convenience which creates an instance of the CreateHttpNamespaceRequest.Builder avoiding the
need to create one manually via CreateHttpNamespaceRequest.builder()
createHttpNamespaceRequest - A Consumer that will call methods on CreateHttpNamespaceRequest.Builder to create a
request.default CompletableFuture<CreatePrivateDnsNamespaceResponse> createPrivateDnsNamespace(CreatePrivateDnsNamespaceRequest createPrivateDnsNamespaceRequest)
Creates a private namespace based on DNS, which will be visible only inside a specified Amazon VPC. The namespace
defines your service naming scheme. For example, if you name your namespace example.com and name
your service backend, the resulting DNS name for the service will be
backend.example.com. For the current limit on the number of namespaces that you can create using the
same AWS account, see AWS Cloud
Map Limits in the AWS Cloud Map Developer Guide.
createPrivateDnsNamespaceRequest - default CompletableFuture<CreatePrivateDnsNamespaceResponse> createPrivateDnsNamespace(Consumer<CreatePrivateDnsNamespaceRequest.Builder> createPrivateDnsNamespaceRequest)
Creates a private namespace based on DNS, which will be visible only inside a specified Amazon VPC. The namespace
defines your service naming scheme. For example, if you name your namespace example.com and name
your service backend, the resulting DNS name for the service will be
backend.example.com. For the current limit on the number of namespaces that you can create using the
same AWS account, see AWS Cloud
Map Limits in the AWS Cloud Map Developer Guide.
This is a convenience which creates an instance of the CreatePrivateDnsNamespaceRequest.Builder avoiding
the need to create one manually via CreatePrivateDnsNamespaceRequest.builder()
createPrivateDnsNamespaceRequest - A Consumer that will call methods on CreatePrivateDnsNamespaceRequest.Builder to create a
request.default CompletableFuture<CreatePublicDnsNamespaceResponse> createPublicDnsNamespace(CreatePublicDnsNamespaceRequest createPublicDnsNamespaceRequest)
Creates a public namespace based on DNS, which will be visible on the internet. The namespace defines your
service naming scheme. For example, if you name your namespace example.com and name your service
backend, the resulting DNS name for the service will be backend.example.com. For the
current limit on the number of namespaces that you can create using the same AWS account, see AWS Cloud Map Limits in the
AWS Cloud Map Developer Guide.
createPublicDnsNamespaceRequest - default CompletableFuture<CreatePublicDnsNamespaceResponse> createPublicDnsNamespace(Consumer<CreatePublicDnsNamespaceRequest.Builder> createPublicDnsNamespaceRequest)
Creates a public namespace based on DNS, which will be visible on the internet. The namespace defines your
service naming scheme. For example, if you name your namespace example.com and name your service
backend, the resulting DNS name for the service will be backend.example.com. For the
current limit on the number of namespaces that you can create using the same AWS account, see AWS Cloud Map Limits in the
AWS Cloud Map Developer Guide.
This is a convenience which creates an instance of the CreatePublicDnsNamespaceRequest.Builder avoiding
the need to create one manually via CreatePublicDnsNamespaceRequest.builder()
createPublicDnsNamespaceRequest - A Consumer that will call methods on CreatePublicDnsNamespaceRequest.Builder to create a
request.default CompletableFuture<CreateServiceResponse> createService(CreateServiceRequest createServiceRequest)
Creates a service, which defines the configuration for the following entities:
For public and private DNS namespaces, one of the following combinations of DNS records in Amazon Route 53:
A
AAAA
A and AAAA
SRV
CNAME
Optionally, a health check
After you create the service, you can submit a RegisterInstance request, and AWS Cloud Map uses the values in the configuration to create the specified entities.
For the current limit on the number of instances that you can register using the same namespace and using the same service, see AWS Cloud Map Limits in the AWS Cloud Map Developer Guide.
createServiceRequest - default CompletableFuture<CreateServiceResponse> createService(Consumer<CreateServiceRequest.Builder> createServiceRequest)
Creates a service, which defines the configuration for the following entities:
For public and private DNS namespaces, one of the following combinations of DNS records in Amazon Route 53:
A
AAAA
A and AAAA
SRV
CNAME
Optionally, a health check
After you create the service, you can submit a RegisterInstance request, and AWS Cloud Map uses the values in the configuration to create the specified entities.
For the current limit on the number of instances that you can register using the same namespace and using the same service, see AWS Cloud Map Limits in the AWS Cloud Map Developer Guide.
This is a convenience which creates an instance of the CreateServiceRequest.Builder avoiding the need to
create one manually via CreateServiceRequest.builder()
createServiceRequest - A Consumer that will call methods on CreateServiceRequest.Builder to create a request.default CompletableFuture<DeleteNamespaceResponse> deleteNamespace(DeleteNamespaceRequest deleteNamespaceRequest)
Deletes a namespace from the current account. If the namespace still contains one or more services, the request fails.
deleteNamespaceRequest - default CompletableFuture<DeleteNamespaceResponse> deleteNamespace(Consumer<DeleteNamespaceRequest.Builder> deleteNamespaceRequest)
Deletes a namespace from the current account. If the namespace still contains one or more services, the request fails.
This is a convenience which creates an instance of the DeleteNamespaceRequest.Builder avoiding the need
to create one manually via DeleteNamespaceRequest.builder()
deleteNamespaceRequest - A Consumer that will call methods on DeleteNamespaceRequest.Builder to create a request.default CompletableFuture<DeleteServiceResponse> deleteService(DeleteServiceRequest deleteServiceRequest)
Deletes a specified service. If the service still contains one or more registered instances, the request fails.
deleteServiceRequest - default CompletableFuture<DeleteServiceResponse> deleteService(Consumer<DeleteServiceRequest.Builder> deleteServiceRequest)
Deletes a specified service. If the service still contains one or more registered instances, the request fails.
This is a convenience which creates an instance of the DeleteServiceRequest.Builder avoiding the need to
create one manually via DeleteServiceRequest.builder()
deleteServiceRequest - A Consumer that will call methods on DeleteServiceRequest.Builder to create a request.default CompletableFuture<DeregisterInstanceResponse> deregisterInstance(DeregisterInstanceRequest deregisterInstanceRequest)
Deletes the Amazon Route 53 DNS records and health check, if any, that AWS Cloud Map created for the specified instance.
deregisterInstanceRequest - default CompletableFuture<DeregisterInstanceResponse> deregisterInstance(Consumer<DeregisterInstanceRequest.Builder> deregisterInstanceRequest)
Deletes the Amazon Route 53 DNS records and health check, if any, that AWS Cloud Map created for the specified instance.
This is a convenience which creates an instance of the DeregisterInstanceRequest.Builder avoiding the
need to create one manually via DeregisterInstanceRequest.builder()
deregisterInstanceRequest - A Consumer that will call methods on DeregisterInstanceRequest.Builder to create a
request.default CompletableFuture<DiscoverInstancesResponse> discoverInstances(DiscoverInstancesRequest discoverInstancesRequest)
Discovers registered instances for a specified namespace and service.
discoverInstancesRequest - default CompletableFuture<DiscoverInstancesResponse> discoverInstances(Consumer<DiscoverInstancesRequest.Builder> discoverInstancesRequest)
Discovers registered instances for a specified namespace and service.
This is a convenience which creates an instance of the DiscoverInstancesRequest.Builder avoiding the need
to create one manually via DiscoverInstancesRequest.builder()
discoverInstancesRequest - A Consumer that will call methods on DiscoverInstancesRequest.Builder to create a request.default CompletableFuture<GetInstanceResponse> getInstance(GetInstanceRequest getInstanceRequest)
Gets information about a specified instance.
getInstanceRequest - default CompletableFuture<GetInstanceResponse> getInstance(Consumer<GetInstanceRequest.Builder> getInstanceRequest)
Gets information about a specified instance.
This is a convenience which creates an instance of the GetInstanceRequest.Builder avoiding the need to
create one manually via GetInstanceRequest.builder()
getInstanceRequest - A Consumer that will call methods on GetInstanceRequest.Builder to create a request.default CompletableFuture<GetInstancesHealthStatusResponse> getInstancesHealthStatus(GetInstancesHealthStatusRequest getInstancesHealthStatusRequest)
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.
getInstancesHealthStatusRequest - default CompletableFuture<GetInstancesHealthStatusResponse> getInstancesHealthStatus(Consumer<GetInstancesHealthStatusRequest.Builder> getInstancesHealthStatusRequest)
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.
This is a convenience which creates an instance of the GetInstancesHealthStatusRequest.Builder avoiding
the need to create one manually via GetInstancesHealthStatusRequest.builder()
getInstancesHealthStatusRequest - A Consumer that will call methods on GetInstancesHealthStatusRequest.Builder to create a
request.default GetInstancesHealthStatusPublisher getInstancesHealthStatusPaginator(GetInstancesHealthStatusRequest getInstancesHealthStatusRequest)
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.
This is a variant of
getInstancesHealthStatus(software.amazon.awssdk.services.servicediscovery.model.GetInstancesHealthStatusRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages.
SDK will internally handle making service calls for you.
When the operation is called, an instance of this class is returned. At this point, no service calls are made yet
and so there is no guarantee that the request is valid. If there are errors in your request, you will see the
failures only after you start streaming the data. The subscribe method should be called as a request to start
streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe
method will result in a new Subscription i.e., a new contract to stream data from the
starting request.
The following are few ways to use the response class:
1) Using the subscribe helper method
software.amazon.awssdk.services.servicediscovery.paginators.GetInstancesHealthStatusPublisher publisher = client.getInstancesHealthStatusPaginator(request);
CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
future.get();
2) Using a custom subscriber
software.amazon.awssdk.services.servicediscovery.paginators.GetInstancesHealthStatusPublisher publisher = client.getInstancesHealthStatusPaginator(request);
publisher.subscribe(new Subscriber<software.amazon.awssdk.services.servicediscovery.model.GetInstancesHealthStatusResponse>() {
public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
public void onNext(software.amazon.awssdk.services.servicediscovery.model.GetInstancesHealthStatusResponse response) { //... };
});
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
Note: If you prefer to have control on service calls, use the
getInstancesHealthStatus(software.amazon.awssdk.services.servicediscovery.model.GetInstancesHealthStatusRequest)
operation.
getInstancesHealthStatusRequest - default GetInstancesHealthStatusPublisher getInstancesHealthStatusPaginator(Consumer<GetInstancesHealthStatusRequest.Builder> getInstancesHealthStatusRequest)
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.
This is a variant of
getInstancesHealthStatus(software.amazon.awssdk.services.servicediscovery.model.GetInstancesHealthStatusRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages.
SDK will internally handle making service calls for you.
When the operation is called, an instance of this class is returned. At this point, no service calls are made yet
and so there is no guarantee that the request is valid. If there are errors in your request, you will see the
failures only after you start streaming the data. The subscribe method should be called as a request to start
streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe
method will result in a new Subscription i.e., a new contract to stream data from the
starting request.
The following are few ways to use the response class:
1) Using the subscribe helper method
software.amazon.awssdk.services.servicediscovery.paginators.GetInstancesHealthStatusPublisher publisher = client.getInstancesHealthStatusPaginator(request);
CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
future.get();
2) Using a custom subscriber
software.amazon.awssdk.services.servicediscovery.paginators.GetInstancesHealthStatusPublisher publisher = client.getInstancesHealthStatusPaginator(request);
publisher.subscribe(new Subscriber<software.amazon.awssdk.services.servicediscovery.model.GetInstancesHealthStatusResponse>() {
public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
public void onNext(software.amazon.awssdk.services.servicediscovery.model.GetInstancesHealthStatusResponse response) { //... };
});
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
Note: If you prefer to have control on service calls, use the
getInstancesHealthStatus(software.amazon.awssdk.services.servicediscovery.model.GetInstancesHealthStatusRequest)
operation.
This is a convenience which creates an instance of the GetInstancesHealthStatusRequest.Builder avoiding
the need to create one manually via GetInstancesHealthStatusRequest.builder()
getInstancesHealthStatusRequest - A Consumer that will call methods on GetInstancesHealthStatusRequest.Builder to create a
request.default CompletableFuture<GetNamespaceResponse> getNamespace(GetNamespaceRequest getNamespaceRequest)
Gets information about a namespace.
getNamespaceRequest - default CompletableFuture<GetNamespaceResponse> getNamespace(Consumer<GetNamespaceRequest.Builder> getNamespaceRequest)
Gets information about a namespace.
This is a convenience which creates an instance of the GetNamespaceRequest.Builder avoiding the need to
create one manually via GetNamespaceRequest.builder()
getNamespaceRequest - A Consumer that will call methods on GetNamespaceRequest.Builder to create a request.default CompletableFuture<GetOperationResponse> getOperation(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.
getOperationRequest - default CompletableFuture<GetOperationResponse> getOperation(Consumer<GetOperationRequest.Builder> 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.
This is a convenience which creates an instance of the GetOperationRequest.Builder avoiding the need to
create one manually via GetOperationRequest.builder()
getOperationRequest - A Consumer that will call methods on GetOperationRequest.Builder to create a request.default CompletableFuture<GetServiceResponse> getService(GetServiceRequest getServiceRequest)
Gets the settings for a specified service.
getServiceRequest - default CompletableFuture<GetServiceResponse> getService(Consumer<GetServiceRequest.Builder> getServiceRequest)
Gets the settings for a specified service.
This is a convenience which creates an instance of the GetServiceRequest.Builder avoiding the need to
create one manually via GetServiceRequest.builder()
getServiceRequest - A Consumer that will call methods on GetServiceRequest.Builder to create a request.default CompletableFuture<ListInstancesResponse> listInstances(ListInstancesRequest listInstancesRequest)
Lists summary information about the instances that you registered by using a specified service.
listInstancesRequest - default CompletableFuture<ListInstancesResponse> listInstances(Consumer<ListInstancesRequest.Builder> listInstancesRequest)
Lists summary information about the instances that you registered by using a specified service.
This is a convenience which creates an instance of the ListInstancesRequest.Builder avoiding the need to
create one manually via ListInstancesRequest.builder()
listInstancesRequest - A Consumer that will call methods on ListInstancesRequest.Builder to create a request.default ListInstancesPublisher listInstancesPaginator(ListInstancesRequest listInstancesRequest)
Lists summary information about the instances that you registered by using a specified service.
This is a variant of
listInstances(software.amazon.awssdk.services.servicediscovery.model.ListInstancesRequest) operation.
The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will
internally handle making service calls for you.
When the operation is called, an instance of this class is returned. At this point, no service calls are made yet
and so there is no guarantee that the request is valid. If there are errors in your request, you will see the
failures only after you start streaming the data. The subscribe method should be called as a request to start
streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe
method will result in a new Subscription i.e., a new contract to stream data from the
starting request.
The following are few ways to use the response class:
1) Using the subscribe helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListInstancesPublisher publisher = client.listInstancesPaginator(request);
CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
future.get();
2) Using a custom subscriber
software.amazon.awssdk.services.servicediscovery.paginators.ListInstancesPublisher publisher = client.listInstancesPaginator(request);
publisher.subscribe(new Subscriber<software.amazon.awssdk.services.servicediscovery.model.ListInstancesResponse>() {
public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
public void onNext(software.amazon.awssdk.services.servicediscovery.model.ListInstancesResponse response) { //... };
});
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
Note: If you prefer to have control on service calls, use the
listInstances(software.amazon.awssdk.services.servicediscovery.model.ListInstancesRequest)
operation.
listInstancesRequest - default ListInstancesPublisher listInstancesPaginator(Consumer<ListInstancesRequest.Builder> listInstancesRequest)
Lists summary information about the instances that you registered by using a specified service.
This is a variant of
listInstances(software.amazon.awssdk.services.servicediscovery.model.ListInstancesRequest) operation.
The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will
internally handle making service calls for you.
When the operation is called, an instance of this class is returned. At this point, no service calls are made yet
and so there is no guarantee that the request is valid. If there are errors in your request, you will see the
failures only after you start streaming the data. The subscribe method should be called as a request to start
streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe
method will result in a new Subscription i.e., a new contract to stream data from the
starting request.
The following are few ways to use the response class:
1) Using the subscribe helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListInstancesPublisher publisher = client.listInstancesPaginator(request);
CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
future.get();
2) Using a custom subscriber
software.amazon.awssdk.services.servicediscovery.paginators.ListInstancesPublisher publisher = client.listInstancesPaginator(request);
publisher.subscribe(new Subscriber<software.amazon.awssdk.services.servicediscovery.model.ListInstancesResponse>() {
public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
public void onNext(software.amazon.awssdk.services.servicediscovery.model.ListInstancesResponse response) { //... };
});
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
Note: If you prefer to have control on service calls, use the
listInstances(software.amazon.awssdk.services.servicediscovery.model.ListInstancesRequest)
operation.
This is a convenience which creates an instance of the ListInstancesRequest.Builder avoiding the need to
create one manually via ListInstancesRequest.builder()
listInstancesRequest - A Consumer that will call methods on ListInstancesRequest.Builder to create a request.default CompletableFuture<ListNamespacesResponse> listNamespaces(ListNamespacesRequest listNamespacesRequest)
Lists summary information about the namespaces that were created by the current AWS account.
listNamespacesRequest - default CompletableFuture<ListNamespacesResponse> listNamespaces(Consumer<ListNamespacesRequest.Builder> listNamespacesRequest)
Lists summary information about the namespaces that were created by the current AWS account.
This is a convenience which creates an instance of the ListNamespacesRequest.Builder avoiding the need to
create one manually via ListNamespacesRequest.builder()
listNamespacesRequest - A Consumer that will call methods on ListNamespacesRequest.Builder to create a request.default CompletableFuture<ListNamespacesResponse> listNamespaces()
Lists summary information about the namespaces that were created by the current AWS account.
default ListNamespacesPublisher listNamespacesPaginator()
Lists summary information about the namespaces that were created by the current AWS account.
This is a variant of
listNamespaces(software.amazon.awssdk.services.servicediscovery.model.ListNamespacesRequest) operation.
The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will
internally handle making service calls for you.
When the operation is called, an instance of this class is returned. At this point, no service calls are made yet
and so there is no guarantee that the request is valid. If there are errors in your request, you will see the
failures only after you start streaming the data. The subscribe method should be called as a request to start
streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe
method will result in a new Subscription i.e., a new contract to stream data from the
starting request.
The following are few ways to use the response class:
1) Using the subscribe helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListNamespacesPublisher publisher = client.listNamespacesPaginator(request);
CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
future.get();
2) Using a custom subscriber
software.amazon.awssdk.services.servicediscovery.paginators.ListNamespacesPublisher publisher = client.listNamespacesPaginator(request);
publisher.subscribe(new Subscriber<software.amazon.awssdk.services.servicediscovery.model.ListNamespacesResponse>() {
public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
public void onNext(software.amazon.awssdk.services.servicediscovery.model.ListNamespacesResponse response) { //... };
});
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
Note: If you prefer to have control on service calls, use the
listNamespaces(software.amazon.awssdk.services.servicediscovery.model.ListNamespacesRequest)
operation.
default ListNamespacesPublisher listNamespacesPaginator(ListNamespacesRequest listNamespacesRequest)
Lists summary information about the namespaces that were created by the current AWS account.
This is a variant of
listNamespaces(software.amazon.awssdk.services.servicediscovery.model.ListNamespacesRequest) operation.
The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will
internally handle making service calls for you.
When the operation is called, an instance of this class is returned. At this point, no service calls are made yet
and so there is no guarantee that the request is valid. If there are errors in your request, you will see the
failures only after you start streaming the data. The subscribe method should be called as a request to start
streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe
method will result in a new Subscription i.e., a new contract to stream data from the
starting request.
The following are few ways to use the response class:
1) Using the subscribe helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListNamespacesPublisher publisher = client.listNamespacesPaginator(request);
CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
future.get();
2) Using a custom subscriber
software.amazon.awssdk.services.servicediscovery.paginators.ListNamespacesPublisher publisher = client.listNamespacesPaginator(request);
publisher.subscribe(new Subscriber<software.amazon.awssdk.services.servicediscovery.model.ListNamespacesResponse>() {
public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
public void onNext(software.amazon.awssdk.services.servicediscovery.model.ListNamespacesResponse response) { //... };
});
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
Note: If you prefer to have control on service calls, use the
listNamespaces(software.amazon.awssdk.services.servicediscovery.model.ListNamespacesRequest)
operation.
listNamespacesRequest - default ListNamespacesPublisher listNamespacesPaginator(Consumer<ListNamespacesRequest.Builder> listNamespacesRequest)
Lists summary information about the namespaces that were created by the current AWS account.
This is a variant of
listNamespaces(software.amazon.awssdk.services.servicediscovery.model.ListNamespacesRequest) operation.
The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will
internally handle making service calls for you.
When the operation is called, an instance of this class is returned. At this point, no service calls are made yet
and so there is no guarantee that the request is valid. If there are errors in your request, you will see the
failures only after you start streaming the data. The subscribe method should be called as a request to start
streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe
method will result in a new Subscription i.e., a new contract to stream data from the
starting request.
The following are few ways to use the response class:
1) Using the subscribe helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListNamespacesPublisher publisher = client.listNamespacesPaginator(request);
CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
future.get();
2) Using a custom subscriber
software.amazon.awssdk.services.servicediscovery.paginators.ListNamespacesPublisher publisher = client.listNamespacesPaginator(request);
publisher.subscribe(new Subscriber<software.amazon.awssdk.services.servicediscovery.model.ListNamespacesResponse>() {
public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
public void onNext(software.amazon.awssdk.services.servicediscovery.model.ListNamespacesResponse response) { //... };
});
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
Note: If you prefer to have control on service calls, use the
listNamespaces(software.amazon.awssdk.services.servicediscovery.model.ListNamespacesRequest)
operation.
This is a convenience which creates an instance of the ListNamespacesRequest.Builder avoiding the need to
create one manually via ListNamespacesRequest.builder()
listNamespacesRequest - A Consumer that will call methods on ListNamespacesRequest.Builder to create a request.default CompletableFuture<ListOperationsResponse> listOperations(ListOperationsRequest listOperationsRequest)
Lists operations that match the criteria that you specify.
listOperationsRequest - default CompletableFuture<ListOperationsResponse> listOperations(Consumer<ListOperationsRequest.Builder> listOperationsRequest)
Lists operations that match the criteria that you specify.
This is a convenience which creates an instance of the ListOperationsRequest.Builder avoiding the need to
create one manually via ListOperationsRequest.builder()
listOperationsRequest - A Consumer that will call methods on ListOperationsRequest.Builder to create a request.default CompletableFuture<ListOperationsResponse> listOperations()
Lists operations that match the criteria that you specify.
default ListOperationsPublisher listOperationsPaginator()
Lists operations that match the criteria that you specify.
This is a variant of
listOperations(software.amazon.awssdk.services.servicediscovery.model.ListOperationsRequest) operation.
The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will
internally handle making service calls for you.
When the operation is called, an instance of this class is returned. At this point, no service calls are made yet
and so there is no guarantee that the request is valid. If there are errors in your request, you will see the
failures only after you start streaming the data. The subscribe method should be called as a request to start
streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe
method will result in a new Subscription i.e., a new contract to stream data from the
starting request.
The following are few ways to use the response class:
1) Using the subscribe helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListOperationsPublisher publisher = client.listOperationsPaginator(request);
CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
future.get();
2) Using a custom subscriber
software.amazon.awssdk.services.servicediscovery.paginators.ListOperationsPublisher publisher = client.listOperationsPaginator(request);
publisher.subscribe(new Subscriber<software.amazon.awssdk.services.servicediscovery.model.ListOperationsResponse>() {
public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
public void onNext(software.amazon.awssdk.services.servicediscovery.model.ListOperationsResponse response) { //... };
});
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
Note: If you prefer to have control on service calls, use the
listOperations(software.amazon.awssdk.services.servicediscovery.model.ListOperationsRequest)
operation.
default ListOperationsPublisher listOperationsPaginator(ListOperationsRequest listOperationsRequest)
Lists operations that match the criteria that you specify.
This is a variant of
listOperations(software.amazon.awssdk.services.servicediscovery.model.ListOperationsRequest) operation.
The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will
internally handle making service calls for you.
When the operation is called, an instance of this class is returned. At this point, no service calls are made yet
and so there is no guarantee that the request is valid. If there are errors in your request, you will see the
failures only after you start streaming the data. The subscribe method should be called as a request to start
streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe
method will result in a new Subscription i.e., a new contract to stream data from the
starting request.
The following are few ways to use the response class:
1) Using the subscribe helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListOperationsPublisher publisher = client.listOperationsPaginator(request);
CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
future.get();
2) Using a custom subscriber
software.amazon.awssdk.services.servicediscovery.paginators.ListOperationsPublisher publisher = client.listOperationsPaginator(request);
publisher.subscribe(new Subscriber<software.amazon.awssdk.services.servicediscovery.model.ListOperationsResponse>() {
public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
public void onNext(software.amazon.awssdk.services.servicediscovery.model.ListOperationsResponse response) { //... };
});
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
Note: If you prefer to have control on service calls, use the
listOperations(software.amazon.awssdk.services.servicediscovery.model.ListOperationsRequest)
operation.
listOperationsRequest - default ListOperationsPublisher listOperationsPaginator(Consumer<ListOperationsRequest.Builder> listOperationsRequest)
Lists operations that match the criteria that you specify.
This is a variant of
listOperations(software.amazon.awssdk.services.servicediscovery.model.ListOperationsRequest) operation.
The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will
internally handle making service calls for you.
When the operation is called, an instance of this class is returned. At this point, no service calls are made yet
and so there is no guarantee that the request is valid. If there are errors in your request, you will see the
failures only after you start streaming the data. The subscribe method should be called as a request to start
streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe
method will result in a new Subscription i.e., a new contract to stream data from the
starting request.
The following are few ways to use the response class:
1) Using the subscribe helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListOperationsPublisher publisher = client.listOperationsPaginator(request);
CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
future.get();
2) Using a custom subscriber
software.amazon.awssdk.services.servicediscovery.paginators.ListOperationsPublisher publisher = client.listOperationsPaginator(request);
publisher.subscribe(new Subscriber<software.amazon.awssdk.services.servicediscovery.model.ListOperationsResponse>() {
public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
public void onNext(software.amazon.awssdk.services.servicediscovery.model.ListOperationsResponse response) { //... };
});
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
Note: If you prefer to have control on service calls, use the
listOperations(software.amazon.awssdk.services.servicediscovery.model.ListOperationsRequest)
operation.
This is a convenience which creates an instance of the ListOperationsRequest.Builder avoiding the need to
create one manually via ListOperationsRequest.builder()
listOperationsRequest - A Consumer that will call methods on ListOperationsRequest.Builder to create a request.default CompletableFuture<ListServicesResponse> listServices(ListServicesRequest listServicesRequest)
Lists summary information for all the services that are associated with one or more specified namespaces.
listServicesRequest - default CompletableFuture<ListServicesResponse> listServices(Consumer<ListServicesRequest.Builder> listServicesRequest)
Lists summary information for all the services that are associated with one or more specified namespaces.
This is a convenience which creates an instance of the ListServicesRequest.Builder avoiding the need to
create one manually via ListServicesRequest.builder()
listServicesRequest - A Consumer that will call methods on ListServicesRequest.Builder to create a request.default CompletableFuture<ListServicesResponse> listServices()
Lists summary information for all the services that are associated with one or more specified namespaces.
default ListServicesPublisher listServicesPaginator()
Lists summary information for all the services that are associated with one or more specified namespaces.
This is a variant of
listServices(software.amazon.awssdk.services.servicediscovery.model.ListServicesRequest) operation. The
return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will
internally handle making service calls for you.
When the operation is called, an instance of this class is returned. At this point, no service calls are made yet
and so there is no guarantee that the request is valid. If there are errors in your request, you will see the
failures only after you start streaming the data. The subscribe method should be called as a request to start
streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe
method will result in a new Subscription i.e., a new contract to stream data from the
starting request.
The following are few ways to use the response class:
1) Using the subscribe helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListServicesPublisher publisher = client.listServicesPaginator(request);
CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
future.get();
2) Using a custom subscriber
software.amazon.awssdk.services.servicediscovery.paginators.ListServicesPublisher publisher = client.listServicesPaginator(request);
publisher.subscribe(new Subscriber<software.amazon.awssdk.services.servicediscovery.model.ListServicesResponse>() {
public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
public void onNext(software.amazon.awssdk.services.servicediscovery.model.ListServicesResponse response) { //... };
});
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
Note: If you prefer to have control on service calls, use the
listServices(software.amazon.awssdk.services.servicediscovery.model.ListServicesRequest) operation.
default ListServicesPublisher listServicesPaginator(ListServicesRequest listServicesRequest)
Lists summary information for all the services that are associated with one or more specified namespaces.
This is a variant of
listServices(software.amazon.awssdk.services.servicediscovery.model.ListServicesRequest) operation. The
return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will
internally handle making service calls for you.
When the operation is called, an instance of this class is returned. At this point, no service calls are made yet
and so there is no guarantee that the request is valid. If there are errors in your request, you will see the
failures only after you start streaming the data. The subscribe method should be called as a request to start
streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe
method will result in a new Subscription i.e., a new contract to stream data from the
starting request.
The following are few ways to use the response class:
1) Using the subscribe helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListServicesPublisher publisher = client.listServicesPaginator(request);
CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
future.get();
2) Using a custom subscriber
software.amazon.awssdk.services.servicediscovery.paginators.ListServicesPublisher publisher = client.listServicesPaginator(request);
publisher.subscribe(new Subscriber<software.amazon.awssdk.services.servicediscovery.model.ListServicesResponse>() {
public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
public void onNext(software.amazon.awssdk.services.servicediscovery.model.ListServicesResponse response) { //... };
});
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
Note: If you prefer to have control on service calls, use the
listServices(software.amazon.awssdk.services.servicediscovery.model.ListServicesRequest) operation.
listServicesRequest - default ListServicesPublisher listServicesPaginator(Consumer<ListServicesRequest.Builder> listServicesRequest)
Lists summary information for all the services that are associated with one or more specified namespaces.
This is a variant of
listServices(software.amazon.awssdk.services.servicediscovery.model.ListServicesRequest) operation. The
return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will
internally handle making service calls for you.
When the operation is called, an instance of this class is returned. At this point, no service calls are made yet
and so there is no guarantee that the request is valid. If there are errors in your request, you will see the
failures only after you start streaming the data. The subscribe method should be called as a request to start
streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe
method will result in a new Subscription i.e., a new contract to stream data from the
starting request.
The following are few ways to use the response class:
1) Using the subscribe helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListServicesPublisher publisher = client.listServicesPaginator(request);
CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
future.get();
2) Using a custom subscriber
software.amazon.awssdk.services.servicediscovery.paginators.ListServicesPublisher publisher = client.listServicesPaginator(request);
publisher.subscribe(new Subscriber<software.amazon.awssdk.services.servicediscovery.model.ListServicesResponse>() {
public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
public void onNext(software.amazon.awssdk.services.servicediscovery.model.ListServicesResponse response) { //... };
});
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
Note: If you prefer to have control on service calls, use the
listServices(software.amazon.awssdk.services.servicediscovery.model.ListServicesRequest) operation.
This is a convenience which creates an instance of the ListServicesRequest.Builder avoiding the need to
create one manually via ListServicesRequest.builder()
listServicesRequest - A Consumer that will call methods on ListServicesRequest.Builder to create a request.default CompletableFuture<RegisterInstanceResponse> registerInstance(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 is specified by ServiceId, a record is
created or updated in the hosted zone that is associated with the corresponding namespace.
If the service includes HealthCheckConfig, a health check is created based on the settings in the
health check configuration.
The health check, if any, is associated with each of the new or updated records.
One RegisterInstance request must complete before you can submit another request and specify the
same service ID and instance ID.
For more information, see CreateService.
When AWS Cloud Map receives a DNS query for the specified DNS name, it returns the applicable value:
If the health check is healthy: returns all the records
If the health check is unhealthy: returns the applicable value for the last healthy instance
If you didn't specify a health check configuration: returns all the records
For the current limit on the number of instances that you can register using the same namespace and using the same service, see AWS Cloud Map Limits in the AWS Cloud Map Developer Guide.
registerInstanceRequest - default CompletableFuture<RegisterInstanceResponse> registerInstance(Consumer<RegisterInstanceRequest.Builder> 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 is specified by ServiceId, a record is
created or updated in the hosted zone that is associated with the corresponding namespace.
If the service includes HealthCheckConfig, a health check is created based on the settings in the
health check configuration.
The health check, if any, is associated with each of the new or updated records.
One RegisterInstance request must complete before you can submit another request and specify the
same service ID and instance ID.
For more information, see CreateService.
When AWS Cloud Map receives a DNS query for the specified DNS name, it returns the applicable value:
If the health check is healthy: returns all the records
If the health check is unhealthy: returns the applicable value for the last healthy instance
If you didn't specify a health check configuration: returns all the records
For the current limit on the number of instances that you can register using the same namespace and using the same service, see AWS Cloud Map Limits in the AWS Cloud Map Developer Guide.
This is a convenience which creates an instance of the RegisterInstanceRequest.Builder avoiding the need
to create one manually via RegisterInstanceRequest.builder()
registerInstanceRequest - A Consumer that will call methods on RegisterInstanceRequest.Builder to create a request.default CompletableFuture<UpdateInstanceCustomHealthStatusResponse> updateInstanceCustomHealthStatus(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.
updateInstanceCustomHealthStatusRequest - ServiceId and InstanceId is not a custom health check.default CompletableFuture<UpdateInstanceCustomHealthStatusResponse> updateInstanceCustomHealthStatus(Consumer<UpdateInstanceCustomHealthStatusRequest.Builder> 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.
This is a convenience which creates an instance of the UpdateInstanceCustomHealthStatusRequest.Builder
avoiding the need to create one manually via UpdateInstanceCustomHealthStatusRequest.builder()
updateInstanceCustomHealthStatusRequest - A Consumer that will call methods on UpdateInstanceCustomHealthStatusRequest.Builder to
create a request.ServiceId and InstanceId is not a custom health check.default CompletableFuture<UpdateServiceResponse> updateService(UpdateServiceRequest updateServiceRequest)
Submits a request to perform the following operations:
Add or delete DnsRecords configurations
Update the TTL setting for existing DnsRecords configurations
Add, update, or delete HealthCheckConfig for a specified service
For public and private DNS namespaces, you must specify all DnsRecords configurations (and,
optionally, HealthCheckConfig) that you want to appear in the updated service. Any current
configurations that don't appear in an UpdateService request are deleted.
When you update the TTL setting for a service, AWS Cloud Map also updates the corresponding settings in all the records and health checks that were created by using the specified service.
updateServiceRequest - default CompletableFuture<UpdateServiceResponse> updateService(Consumer<UpdateServiceRequest.Builder> updateServiceRequest)
Submits a request to perform the following operations:
Add or delete DnsRecords configurations
Update the TTL setting for existing DnsRecords configurations
Add, update, or delete HealthCheckConfig for a specified service
For public and private DNS namespaces, you must specify all DnsRecords configurations (and,
optionally, HealthCheckConfig) that you want to appear in the updated service. Any current
configurations that don't appear in an UpdateService request are deleted.
When you update the TTL setting for a service, AWS Cloud Map also updates the corresponding settings in all the records and health checks that were created by using the specified service.
This is a convenience which creates an instance of the UpdateServiceRequest.Builder avoiding the need to
create one manually via UpdateServiceRequest.builder()
updateServiceRequest - A Consumer that will call methods on UpdateServiceRequest.Builder to create a request.Copyright © 2017 Amazon Web Services, Inc. All Rights Reserved.