@Generated(value="software.amazon.awssdk:codegen") public interface ServiceDiscoveryAsyncClient extends SdkClient, SdkAutoCloseable
builder()
method.
Amazon Route 53 autonaming lets you configure public or private namespaces that your microservice applications run in. When instances of the service become available, you can call the autonaming API to register the instance, and Amazon Route 53 automatically creates up to five DNS records and an optional health check. Clients that submit DNS queries for the service receive an answer that contains up to eight healthy records.
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<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 a template for the following entities:
|
default CompletableFuture<CreateServiceResponse> |
createService(CreateServiceRequest createServiceRequest)
Creates a service, which defines a template 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 resource record sets and the health check, if any, that Amazon Route 53 created for the specified
instance.
|
default CompletableFuture<DeregisterInstanceResponse> |
deregisterInstance(DeregisterInstanceRequest deregisterInstanceRequest)
Deletes the resource record sets and the health check, if any, that Amazon Route 53 created for the specified
instance.
|
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)
Gets summary information about the instances that you created by using a specified service.
|
default CompletableFuture<ListInstancesResponse> |
listInstances(ListInstancesRequest listInstancesRequest)
Gets summary information about the instances that you created by using a specified service.
|
default ListInstancesPublisher |
listInstancesPaginator(Consumer<ListInstancesRequest.Builder> listInstancesRequest)
Gets summary information about the instances that you created by using a specified service.
|
default ListInstancesPublisher |
listInstancesPaginator(ListInstancesRequest listInstancesRequest)
Gets summary information about the instances that you created by using a specified service.
|
default CompletableFuture<ListNamespacesResponse> |
listNamespaces()
Gets information about the namespaces that were created by the current AWS account.
|
default CompletableFuture<ListNamespacesResponse> |
listNamespaces(Consumer<ListNamespacesRequest.Builder> listNamespacesRequest)
Gets information about the namespaces that were created by the current AWS account.
|
default CompletableFuture<ListNamespacesResponse> |
listNamespaces(ListNamespacesRequest listNamespacesRequest)
Gets information about the namespaces that were created by the current AWS account.
|
default ListNamespacesPublisher |
listNamespacesPaginator()
Gets information about the namespaces that were created by the current AWS account.
|
default ListNamespacesPublisher |
listNamespacesPaginator(ListNamespacesRequest listNamespacesRequest)
Gets 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(ListOperationsRequest listOperationsRequest)
Lists operations that match the criteria that you specify.
|
default CompletableFuture<ListServicesResponse> |
listServices()
Gets settings for all the services that are associated with one or more specified namespaces.
|
default CompletableFuture<ListServicesResponse> |
listServices(Consumer<ListServicesRequest.Builder> listServicesRequest)
Gets settings for all the services that are associated with one or more specified namespaces.
|
default CompletableFuture<ListServicesResponse> |
listServices(ListServicesRequest listServicesRequest)
Gets settings for all the services that are associated with one or more specified namespaces.
|
default ListServicesPublisher |
listServicesPaginator()
Gets settings for all the services that are associated with one or more specified namespaces.
|
default ListServicesPublisher |
listServicesPaginator(ListServicesRequest listServicesRequest)
Gets settings for all the services that are associated with one or more specified namespaces.
|
default CompletableFuture<RegisterInstanceResponse> |
registerInstance(Consumer<RegisterInstanceRequest.Builder> registerInstanceRequest)
Creates one or more resource record sets and optionally a health check based on the settings in a specified
service.
|
default CompletableFuture<RegisterInstanceResponse> |
registerInstance(RegisterInstanceRequest registerInstanceRequest)
Creates one or more resource record sets and optionally a health check based on the settings in a specified
service.
|
default CompletableFuture<UpdateServiceResponse> |
updateService(Consumer<UpdateServiceRequest.Builder> updateServiceRequest)
Updates the TTL setting for a specified service.
|
default CompletableFuture<UpdateServiceResponse> |
updateService(UpdateServiceRequest updateServiceRequest)
Updates the TTL setting for a specified service.
|
serviceName
close
static 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<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
. You can associate more than one service with the same namespace.
createPrivateDnsNamespaceRequest
- Name
might not be a valid DNS name.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
. You can associate more than one service with the same namespace.
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.Name
might not be a valid DNS name.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
. You can
associate more than one service with the same namespace.
createPublicDnsNamespaceRequest
- Name
might not be a valid DNS name.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
. You can
associate more than one service with the same namespace.
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.Name
might not be a valid DNS name.default CompletableFuture<CreateServiceResponse> createService(CreateServiceRequest createServiceRequest)
Creates a service, which defines a template for the following entities:
One to five resource record sets
Optionally, a health check
After you create the service, you can submit a RegisterInstance request, and Amazon Route 53 uses the values in the template to create the specified entities.
createServiceRequest
- Name
might not be a valid DNS name.default CompletableFuture<CreateServiceResponse> createService(Consumer<CreateServiceRequest.Builder> createServiceRequest)
Creates a service, which defines a template for the following entities:
One to five resource record sets
Optionally, a health check
After you create the service, you can submit a RegisterInstance request, and Amazon Route 53 uses the values in the template to create the specified entities.
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.Name
might not be a valid DNS name.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
- Name
might not be a valid DNS name.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.Name
might not be a valid DNS name.default CompletableFuture<DeleteServiceResponse> deleteService(DeleteServiceRequest deleteServiceRequest)
Deletes a specified service. If the service still contains one or more registered instances, the request fails.
deleteServiceRequest
- Name
might not be a valid DNS name.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.Name
might not be a valid DNS name.default CompletableFuture<DeregisterInstanceResponse> deregisterInstance(DeregisterInstanceRequest deregisterInstanceRequest)
Deletes the resource record sets and the health check, if any, that Amazon Route 53 created for the specified instance.
deregisterInstanceRequest
- Name
might not be a valid DNS name.default CompletableFuture<DeregisterInstanceResponse> deregisterInstance(Consumer<DeregisterInstanceRequest.Builder> deregisterInstanceRequest)
Deletes the resource record sets and the health check, if any, that Amazon Route 53 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.Name
might not be a valid DNS name.default CompletableFuture<GetInstanceResponse> getInstance(GetInstanceRequest getInstanceRequest)
Gets information about a specified instance.
getInstanceRequest
- Name
might not be a valid DNS name.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.Name
might not be a valid DNS name.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.
getInstancesHealthStatusRequest
- Name
might not be a valid DNS name.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.
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.Name
might not be a valid DNS name.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.
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 forEach helper method
software.amazon.awssdk.services.servicediscovery.paginators.GetInstancesHealthStatusPublisher publisher = client.getInstancesHealthStatusPaginator(request);
CompletableFuture<Void> future = publisher.forEach(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
- Name
might not be a valid DNS name.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.
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 forEach helper method
software.amazon.awssdk.services.servicediscovery.paginators.GetInstancesHealthStatusPublisher publisher = client.getInstancesHealthStatusPaginator(request);
CompletableFuture<Void> future = publisher.forEach(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.Name
might not be a valid DNS name.default CompletableFuture<GetNamespaceResponse> getNamespace(GetNamespaceRequest getNamespaceRequest)
Gets information about a namespace.
getNamespaceRequest
- Name
might not be a valid DNS name.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.Name
might not be a valid DNS name.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
- Name
might not be a valid DNS name.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.Name
might not be a valid DNS name.default CompletableFuture<ListInstancesResponse> listInstances(ListInstancesRequest listInstancesRequest)
Gets summary information about the instances that you created by using a specified service.
listInstancesRequest
- Name
might not be a valid DNS name.default CompletableFuture<ListInstancesResponse> listInstances(Consumer<ListInstancesRequest.Builder> listInstancesRequest)
Gets summary information about the instances that you created 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.Name
might not be a valid DNS name.default ListInstancesPublisher listInstancesPaginator(ListInstancesRequest listInstancesRequest)
Gets summary information about the instances that you created 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 forEach helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListInstancesPublisher publisher = client.listInstancesPaginator(request);
CompletableFuture<Void> future = publisher.forEach(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
- Name
might not be a valid DNS name.default ListInstancesPublisher listInstancesPaginator(Consumer<ListInstancesRequest.Builder> listInstancesRequest)
Gets summary information about the instances that you created 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 forEach helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListInstancesPublisher publisher = client.listInstancesPaginator(request);
CompletableFuture<Void> future = publisher.forEach(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.Name
might not be a valid DNS name.default CompletableFuture<ListNamespacesResponse> listNamespaces(ListNamespacesRequest listNamespacesRequest)
Gets information about the namespaces that were created by the current AWS account.
listNamespacesRequest
- Name
might not be a valid DNS name.default CompletableFuture<ListNamespacesResponse> listNamespaces(Consumer<ListNamespacesRequest.Builder> listNamespacesRequest)
Gets 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.Name
might not be a valid DNS name.default CompletableFuture<ListNamespacesResponse> listNamespaces()
Gets information about the namespaces that were created by the current AWS account.
Name
might not be a valid DNS name.default ListNamespacesPublisher listNamespacesPaginator(ListNamespacesRequest listNamespacesRequest)
Gets 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 forEach helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListNamespacesPublisher publisher = client.listNamespacesPaginator(request);
CompletableFuture<Void> future = publisher.forEach(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
- Name
might not be a valid DNS name.default ListNamespacesPublisher listNamespacesPaginator()
Gets 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 forEach helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListNamespacesPublisher publisher = client.listNamespacesPaginator(request);
CompletableFuture<Void> future = publisher.forEach(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.
Name
might not be a valid DNS name.default CompletableFuture<ListOperationsResponse> listOperations(ListOperationsRequest listOperationsRequest)
Lists operations that match the criteria that you specify.
listOperationsRequest
- Name
might not be a valid DNS name.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.Name
might not be a valid DNS name.default CompletableFuture<ListOperationsResponse> listOperations()
Lists operations that match the criteria that you specify.
Name
might not be a valid DNS name.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 forEach helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListOperationsPublisher publisher = client.listOperationsPaginator(request);
CompletableFuture<Void> future = publisher.forEach(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
- Name
might not be a valid DNS name.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 forEach helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListOperationsPublisher publisher = client.listOperationsPaginator(request);
CompletableFuture<Void> future = publisher.forEach(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.
Name
might not be a valid DNS name.default CompletableFuture<ListServicesResponse> listServices(ListServicesRequest listServicesRequest)
Gets settings for all the services that are associated with one or more specified namespaces.
listServicesRequest
- default CompletableFuture<ListServicesResponse> listServices(Consumer<ListServicesRequest.Builder> listServicesRequest)
Gets settings 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()
Gets settings for all the services that are associated with one or more specified namespaces.
default ListServicesPublisher listServicesPaginator(ListServicesRequest listServicesRequest)
Gets settings 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 forEach helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListServicesPublisher publisher = client.listServicesPaginator(request);
CompletableFuture<Void> future = publisher.forEach(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()
Gets settings 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 forEach helper method
software.amazon.awssdk.services.servicediscovery.paginators.ListServicesPublisher publisher = client.listServicesPaginator(request);
CompletableFuture<Void> future = publisher.forEach(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 CompletableFuture<RegisterInstanceResponse> registerInstance(RegisterInstanceRequest registerInstanceRequest)
Creates one or more resource record sets and optionally a health check based on the settings in a specified
service. When you submit a RegisterInstance
request, Amazon Route 53 does the following:
Creates a resource record set for each resource record set template in the service
Creates a health check based on the settings in the health check template in the service, if any
Associates the health check, if any, with each of the resource record sets
One RegisterInstance
request must complete before you can submit another request and specify the
same service and instance ID.
For more information, see CreateService.
When Amazon Route 53 receives a DNS query for the specified DNS name, it returns the applicable value:
If the health check is healthy: returns all the resource record sets
If the health check is unhealthy: returns the IP address of the last healthy instance
If you didn't specify a health check template: returns all the resource record sets
registerInstanceRequest
- Name
might not be a valid DNS name.default CompletableFuture<RegisterInstanceResponse> registerInstance(Consumer<RegisterInstanceRequest.Builder> registerInstanceRequest)
Creates one or more resource record sets and optionally a health check based on the settings in a specified
service. When you submit a RegisterInstance
request, Amazon Route 53 does the following:
Creates a resource record set for each resource record set template in the service
Creates a health check based on the settings in the health check template in the service, if any
Associates the health check, if any, with each of the resource record sets
One RegisterInstance
request must complete before you can submit another request and specify the
same service and instance ID.
For more information, see CreateService.
When Amazon Route 53 receives a DNS query for the specified DNS name, it returns the applicable value:
If the health check is healthy: returns all the resource record sets
If the health check is unhealthy: returns the IP address of the last healthy instance
If you didn't specify a health check template: returns all the resource record sets
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.Name
might not be a valid DNS name.default CompletableFuture<UpdateServiceResponse> updateService(UpdateServiceRequest updateServiceRequest)
Updates the TTL setting for a specified service. You must specify all the resource record set templates (and,
optionally, a health check template) that you want to appear in the updated service. Any current resource record
set templates (or health check template) that don't appear in an UpdateService
request are deleted.
When you update the TTL setting for a service, Amazon Route 53 also updates the corresponding settings in all the resource record sets and health checks that were created by using the specified service.
updateServiceRequest
- Name
might not be a valid DNS name.default CompletableFuture<UpdateServiceResponse> updateService(Consumer<UpdateServiceRequest.Builder> updateServiceRequest)
Updates the TTL setting for a specified service. You must specify all the resource record set templates (and,
optionally, a health check template) that you want to appear in the updated service. Any current resource record
set templates (or health check template) that don't appear in an UpdateService
request are deleted.
When you update the TTL setting for a service, Amazon Route 53 also updates the corresponding settings in all the resource record sets 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.Name
might not be a valid DNS name.Copyright © 2017 Amazon Web Services, Inc. All Rights Reserved.