Interface ServiceDiscoveryClient

All Superinterfaces:

AutoCloseable, AwsClient, SdkAutoCloseable, SdkClient

@Generated("software.amazon.awssdk:codegen")
@ThreadSafe
public interface ServiceDiscoveryClient
extends AwsClient

Service client for accessing ServiceDiscovery. This can be created using the static builder() method. Cloud Map

With Cloud Map, you can configure public DNS, private DNS, or HTTP namespaces that your microservice applications run in. When an instance becomes available, you can call the Cloud Map API to register the instance with Cloud Map. For public or private DNS namespaces, Cloud Map automatically creates DNS records and an optional health check. Clients that submit public or private DNS queries, or HTTP requests, for the service receive an answer that contains up to eight healthy records.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	SERVICE_METADATA_ID	Value for looking up the service's metadata from the ServiceMetadataProvider.
static final String	SERVICE_NAME

Method Summary

Modifier and Type	Method	Description
static ServiceDiscoveryClientBuilder	builder()	Create a builder that can be used to configure and create a ServiceDiscoveryClient.
static ServiceDiscoveryClient	create()	Create a ServiceDiscoveryClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.
default CreateHttpNamespaceResponse	createHttpNamespace(Consumer<CreateHttpNamespaceRequest.Builder> createHttpNamespaceRequest)	Creates an HTTP namespace.
default CreateHttpNamespaceResponse	createHttpNamespace(CreateHttpNamespaceRequest createHttpNamespaceRequest)	Creates an HTTP namespace.
default CreatePrivateDnsNamespaceResponse	createPrivateDnsNamespace(Consumer<CreatePrivateDnsNamespaceRequest.Builder> createPrivateDnsNamespaceRequest)	Creates a private namespace based on DNS, which is visible only inside a specified Amazon VPC.
default CreatePrivateDnsNamespaceResponse	createPrivateDnsNamespace(CreatePrivateDnsNamespaceRequest createPrivateDnsNamespaceRequest)	Creates a private namespace based on DNS, which is visible only inside a specified Amazon VPC.
default CreatePublicDnsNamespaceResponse	createPublicDnsNamespace(Consumer<CreatePublicDnsNamespaceRequest.Builder> createPublicDnsNamespaceRequest)	Creates a public namespace based on DNS, which is visible on the internet.
default CreatePublicDnsNamespaceResponse	createPublicDnsNamespace(CreatePublicDnsNamespaceRequest createPublicDnsNamespaceRequest)	Creates a public namespace based on DNS, which is visible on the internet.
default CreateServiceResponse	createService(Consumer<CreateServiceRequest.Builder> createServiceRequest)	Creates a service.
default CreateServiceResponse	createService(CreateServiceRequest createServiceRequest)	Creates a service.
default DeleteNamespaceResponse	deleteNamespace(Consumer<DeleteNamespaceRequest.Builder> deleteNamespaceRequest)	Deletes a namespace from the current account.
default DeleteNamespaceResponse	deleteNamespace(DeleteNamespaceRequest deleteNamespaceRequest)	Deletes a namespace from the current account.
default DeleteServiceResponse	deleteService(Consumer<DeleteServiceRequest.Builder> deleteServiceRequest)	Deletes a specified service.
default DeleteServiceResponse	deleteService(DeleteServiceRequest deleteServiceRequest)	Deletes a specified service.
default DeregisterInstanceResponse	deregisterInstance(Consumer<DeregisterInstanceRequest.Builder> deregisterInstanceRequest)	Deletes the Amazon Route 53 DNS records and health check, if any, that Cloud Map created for the specified instance.
default DeregisterInstanceResponse	deregisterInstance(DeregisterInstanceRequest deregisterInstanceRequest)	Deletes the Amazon Route 53 DNS records and health check, if any, that Cloud Map created for the specified instance.
default DiscoverInstancesResponse	discoverInstances(Consumer<DiscoverInstancesRequest.Builder> discoverInstancesRequest)	Discovers registered instances for a specified namespace and service.
default DiscoverInstancesResponse	discoverInstances(DiscoverInstancesRequest discoverInstancesRequest)	Discovers registered instances for a specified namespace and service.
default DiscoverInstancesRevisionResponse	discoverInstancesRevision(Consumer<DiscoverInstancesRevisionRequest.Builder> discoverInstancesRevisionRequest)	Discovers the increasing revision associated with an instance.
default DiscoverInstancesRevisionResponse	discoverInstancesRevision(DiscoverInstancesRevisionRequest discoverInstancesRevisionRequest)	Discovers the increasing revision associated with an instance.
default GetInstanceResponse	getInstance(Consumer<GetInstanceRequest.Builder> getInstanceRequest)	Gets information about a specified instance.
default GetInstanceResponse	getInstance(GetInstanceRequest getInstanceRequest)	Gets information about a specified instance.
default 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 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 GetInstancesHealthStatusIterable	getInstancesHealthStatusPaginator(Consumer<GetInstancesHealthStatusRequest.Builder> getInstancesHealthStatusRequest)	This is a variant of getInstancesHealthStatus(software.amazon.awssdk.services.servicediscovery.model.GetInstancesHealthStatusRequest) operation.
default GetInstancesHealthStatusIterable	getInstancesHealthStatusPaginator(GetInstancesHealthStatusRequest getInstancesHealthStatusRequest)	This is a variant of getInstancesHealthStatus(software.amazon.awssdk.services.servicediscovery.model.GetInstancesHealthStatusRequest) operation.
default GetNamespaceResponse	getNamespace(Consumer<GetNamespaceRequest.Builder> getNamespaceRequest)	Gets information about a namespace.
default GetNamespaceResponse	getNamespace(GetNamespaceRequest getNamespaceRequest)	Gets information about a namespace.
default GetOperationResponse	getOperation(Consumer<GetOperationRequest.Builder> getOperationRequest)	Gets information about any operation that returns an operation ID in the response, such as a CreateHttpNamespace request.
default GetOperationResponse	getOperation(GetOperationRequest getOperationRequest)	Gets information about any operation that returns an operation ID in the response, such as a CreateHttpNamespace request.
default GetServiceResponse	getService(Consumer<GetServiceRequest.Builder> getServiceRequest)	Gets the settings for a specified service.
default GetServiceResponse	getService(GetServiceRequest getServiceRequest)	Gets the settings for a specified service.
default ListInstancesResponse	listInstances(Consumer<ListInstancesRequest.Builder> listInstancesRequest)	Lists summary information about the instances that you registered by using a specified service.
default ListInstancesResponse	listInstances(ListInstancesRequest listInstancesRequest)	Lists summary information about the instances that you registered by using a specified service.
default ListInstancesIterable	listInstancesPaginator(Consumer<ListInstancesRequest.Builder> listInstancesRequest)	This is a variant of listInstances(software.amazon.awssdk.services.servicediscovery.model.ListInstancesRequest) operation.
default ListInstancesIterable	listInstancesPaginator(ListInstancesRequest listInstancesRequest)	This is a variant of listInstances(software.amazon.awssdk.services.servicediscovery.model.ListInstancesRequest) operation.
default ListNamespacesResponse	listNamespaces()	Lists summary information about the namespaces that were created by the current Amazon Web Services account.
default ListNamespacesResponse	listNamespaces(Consumer<ListNamespacesRequest.Builder> listNamespacesRequest)	Lists summary information about the namespaces that were created by the current Amazon Web Services account.
default ListNamespacesResponse	listNamespaces(ListNamespacesRequest listNamespacesRequest)	Lists summary information about the namespaces that were created by the current Amazon Web Services account.
default ListNamespacesIterable	listNamespacesPaginator()	This is a variant of listNamespaces(software.amazon.awssdk.services.servicediscovery.model.ListNamespacesRequest) operation.
default ListNamespacesIterable	listNamespacesPaginator(Consumer<ListNamespacesRequest.Builder> listNamespacesRequest)	This is a variant of listNamespaces(software.amazon.awssdk.services.servicediscovery.model.ListNamespacesRequest) operation.
default ListNamespacesIterable	listNamespacesPaginator(ListNamespacesRequest listNamespacesRequest)	This is a variant of listNamespaces(software.amazon.awssdk.services.servicediscovery.model.ListNamespacesRequest) operation.
default ListOperationsResponse	listOperations()	Lists operations that match the criteria that you specify.
default ListOperationsResponse	listOperations(Consumer<ListOperationsRequest.Builder> listOperationsRequest)	Lists operations that match the criteria that you specify.
default ListOperationsResponse	listOperations(ListOperationsRequest listOperationsRequest)	Lists operations that match the criteria that you specify.
default ListOperationsIterable	listOperationsPaginator()	This is a variant of listOperations(software.amazon.awssdk.services.servicediscovery.model.ListOperationsRequest) operation.
default ListOperationsIterable	listOperationsPaginator(Consumer<ListOperationsRequest.Builder> listOperationsRequest)	This is a variant of listOperations(software.amazon.awssdk.services.servicediscovery.model.ListOperationsRequest) operation.
default ListOperationsIterable	listOperationsPaginator(ListOperationsRequest listOperationsRequest)	This is a variant of listOperations(software.amazon.awssdk.services.servicediscovery.model.ListOperationsRequest) operation.
default ListServicesResponse	listServices()	Lists summary information for all the services that are associated with one or more namespaces.
default ListServicesResponse	listServices(Consumer<ListServicesRequest.Builder> listServicesRequest)	Lists summary information for all the services that are associated with one or more namespaces.
default ListServicesResponse	listServices(ListServicesRequest listServicesRequest)	Lists summary information for all the services that are associated with one or more namespaces.
default ListServicesIterable	listServicesPaginator()	This is a variant of listServices(software.amazon.awssdk.services.servicediscovery.model.ListServicesRequest) operation.
default ListServicesIterable	listServicesPaginator(Consumer<ListServicesRequest.Builder> listServicesRequest)	This is a variant of listServices(software.amazon.awssdk.services.servicediscovery.model.ListServicesRequest) operation.
default ListServicesIterable	listServicesPaginator(ListServicesRequest listServicesRequest)	This is a variant of listServices(software.amazon.awssdk.services.servicediscovery.model.ListServicesRequest) operation.
default ListTagsForResourceResponse	listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest)	Lists tags for the specified resource.
default ListTagsForResourceResponse	listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)	Lists tags for the specified resource.
default 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 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 ServiceDiscoveryServiceClientConfiguration	serviceClientConfiguration()	The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration
static ServiceMetadata	serviceMetadata()
default TagResourceResponse	tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest)	Adds one or more tags to the specified resource.
default TagResourceResponse	tagResource(TagResourceRequest tagResourceRequest)	Adds one or more tags to the specified resource.
default UntagResourceResponse	untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest)	Removes one or more tags from the specified resource.
default UntagResourceResponse	untagResource(UntagResourceRequest untagResourceRequest)	Removes one or more tags from the specified resource.
default UpdateHttpNamespaceResponse	updateHttpNamespace(Consumer<UpdateHttpNamespaceRequest.Builder> updateHttpNamespaceRequest)	Updates an HTTP namespace.
default UpdateHttpNamespaceResponse	updateHttpNamespace(UpdateHttpNamespaceRequest updateHttpNamespaceRequest)	Updates an HTTP namespace.
default UpdateInstanceCustomHealthStatusResponse	updateInstanceCustomHealthStatus(Consumer<UpdateInstanceCustomHealthStatusRequest.Builder> updateInstanceCustomHealthStatusRequest)	Submits a request to change the health status of a custom health check to healthy or unhealthy.
default UpdateInstanceCustomHealthStatusResponse	updateInstanceCustomHealthStatus(UpdateInstanceCustomHealthStatusRequest updateInstanceCustomHealthStatusRequest)	Submits a request to change the health status of a custom health check to healthy or unhealthy.
default UpdatePrivateDnsNamespaceResponse	updatePrivateDnsNamespace(Consumer<UpdatePrivateDnsNamespaceRequest.Builder> updatePrivateDnsNamespaceRequest)	Updates a private DNS namespace.
default UpdatePrivateDnsNamespaceResponse	updatePrivateDnsNamespace(UpdatePrivateDnsNamespaceRequest updatePrivateDnsNamespaceRequest)	Updates a private DNS namespace.
default UpdatePublicDnsNamespaceResponse	updatePublicDnsNamespace(Consumer<UpdatePublicDnsNamespaceRequest.Builder> updatePublicDnsNamespaceRequest)	Updates a public DNS namespace.
default UpdatePublicDnsNamespaceResponse	updatePublicDnsNamespace(UpdatePublicDnsNamespaceRequest updatePublicDnsNamespaceRequest)	Updates a public DNS namespace.
default UpdateServiceResponse	updateService(Consumer<UpdateServiceRequest.Builder> updateServiceRequest)	Submits a request to perform the following operations:
default UpdateServiceResponse	updateService(UpdateServiceRequest updateServiceRequest)	Submits a request to perform the following operations:

Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable

close

Methods inherited from interface software.amazon.awssdk.core.SdkClient

serviceName

Field Details

SERVICE_NAME

static final String SERVICE_NAME

See Also:

• Constant Field Values

SERVICE_METADATA_ID

static final String SERVICE_METADATA_ID

Value for looking up the service's metadata from the ServiceMetadataProvider.

See Also:

• Constant Field Values

Method Details

createHttpNamespace

default CreateHttpNamespaceResponse createHttpNamespace(CreateHttpNamespaceRequest createHttpNamespaceRequest)
                                                 throws InvalidInputException,
NamespaceAlreadyExistsException,
ResourceLimitExceededException,
DuplicateRequestException,
TooManyTagsException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Creates an HTTP namespace. Service instances registered using an HTTP namespace can be discovered using a DiscoverInstances request but can't be discovered using DNS.

For the current quota on the number of namespaces that you can create using the same Amazon Web Services account, see Cloud Map quotas in the Cloud Map Developer Guide.

Parameters:

createHttpNamespaceRequest -

Returns:

Result of the CreateHttpNamespace operation returned by the service.

See Also:

• AWS API Documentation

createHttpNamespace

default CreateHttpNamespaceResponse createHttpNamespace(Consumer<CreateHttpNamespaceRequest.Builder> createHttpNamespaceRequest)
                                                 throws InvalidInputException,
NamespaceAlreadyExistsException,
ResourceLimitExceededException,
DuplicateRequestException,
TooManyTagsException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Creates an HTTP namespace. Service instances registered using an HTTP namespace can be discovered using a DiscoverInstances request but can't be discovered using DNS.

For the current quota on the number of namespaces that you can create using the same Amazon Web Services account, see Cloud Map quotas in the Cloud Map Developer Guide.

This is a convenience which creates an instance of the CreateHttpNamespaceRequest.Builder avoiding the need to create one manually via CreateHttpNamespaceRequest.builder()

Parameters:

createHttpNamespaceRequest - A Consumer that will call methods on CreateHttpNamespaceRequest.Builder to create a request.

Returns:

Result of the CreateHttpNamespace operation returned by the service.

See Also:

• AWS API Documentation

createPrivateDnsNamespace

default CreatePrivateDnsNamespaceResponse createPrivateDnsNamespace(CreatePrivateDnsNamespaceRequest createPrivateDnsNamespaceRequest)
                                                             throws InvalidInputException,
NamespaceAlreadyExistsException,
ResourceLimitExceededException,
DuplicateRequestException,
TooManyTagsException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Creates a private namespace based on DNS, which is visible only inside a specified Amazon VPC. The namespace defines your service naming scheme. For example, if you name your namespace example.com and name your service backend, the resulting DNS name for the service is backend.example.com. Service instances that are registered using a private DNS namespace can be discovered using either a DiscoverInstances request or using DNS. For the current quota on the number of namespaces that you can create using the same Amazon Web Services account, see Cloud Map quotas in the Cloud Map Developer Guide.

Parameters:

createPrivateDnsNamespaceRequest -

Returns:

Result of the CreatePrivateDnsNamespace operation returned by the service.

See Also:

• AWS API Documentation

createPrivateDnsNamespace

default CreatePrivateDnsNamespaceResponse createPrivateDnsNamespace(Consumer<CreatePrivateDnsNamespaceRequest.Builder> createPrivateDnsNamespaceRequest)
                                                             throws InvalidInputException,
NamespaceAlreadyExistsException,
ResourceLimitExceededException,
DuplicateRequestException,
TooManyTagsException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Creates a private namespace based on DNS, which is visible only inside a specified Amazon VPC. The namespace defines your service naming scheme. For example, if you name your namespace example.com and name your service backend, the resulting DNS name for the service is backend.example.com. Service instances that are registered using a private DNS namespace can be discovered using either a DiscoverInstances request or using DNS. For the current quota on the number of namespaces that you can create using the same Amazon Web Services account, see Cloud Map quotas in the Cloud Map Developer Guide.

This is a convenience which creates an instance of the CreatePrivateDnsNamespaceRequest.Builder avoiding the need to create one manually via CreatePrivateDnsNamespaceRequest.builder()

Parameters:

createPrivateDnsNamespaceRequest - A Consumer that will call methods on CreatePrivateDnsNamespaceRequest.Builder to create a request.

Returns:

Result of the CreatePrivateDnsNamespace operation returned by the service.

See Also:

• AWS API Documentation

createPublicDnsNamespace

default CreatePublicDnsNamespaceResponse createPublicDnsNamespace(CreatePublicDnsNamespaceRequest createPublicDnsNamespaceRequest)
                                                           throws InvalidInputException,
NamespaceAlreadyExistsException,
ResourceLimitExceededException,
DuplicateRequestException,
TooManyTagsException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Creates a public namespace based on DNS, which is visible on the internet. The namespace defines your service naming scheme. For example, if you name your namespace example.com and name your service backend, the resulting DNS name for the service is backend.example.com. You can discover instances that were registered with a public DNS namespace by using either a DiscoverInstances request or using DNS. For the current quota on the number of namespaces that you can create using the same Amazon Web Services account, see Cloud Map quotas in the Cloud Map Developer Guide.

The CreatePublicDnsNamespace API operation is not supported in the Amazon Web Services GovCloud (US) Regions.

Parameters:

createPublicDnsNamespaceRequest -

Returns:

Result of the CreatePublicDnsNamespace operation returned by the service.

See Also:

• AWS API Documentation

createPublicDnsNamespace

default CreatePublicDnsNamespaceResponse createPublicDnsNamespace(Consumer<CreatePublicDnsNamespaceRequest.Builder> createPublicDnsNamespaceRequest)
                                                           throws InvalidInputException,
NamespaceAlreadyExistsException,
ResourceLimitExceededException,
DuplicateRequestException,
TooManyTagsException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Creates a public namespace based on DNS, which is visible on the internet. The namespace defines your service naming scheme. For example, if you name your namespace example.com and name your service backend, the resulting DNS name for the service is backend.example.com. You can discover instances that were registered with a public DNS namespace by using either a DiscoverInstances request or using DNS. For the current quota on the number of namespaces that you can create using the same Amazon Web Services account, see Cloud Map quotas in the Cloud Map Developer Guide.

The CreatePublicDnsNamespace API operation is not supported in the Amazon Web Services GovCloud (US) Regions.

This is a convenience which creates an instance of the CreatePublicDnsNamespaceRequest.Builder avoiding the need to create one manually via CreatePublicDnsNamespaceRequest.builder()

Parameters:

createPublicDnsNamespaceRequest - A Consumer that will call methods on CreatePublicDnsNamespaceRequest.Builder to create a request.

Returns:

Result of the CreatePublicDnsNamespace operation returned by the service.

See Also:

• AWS API Documentation

createService

default CreateServiceResponse createService(CreateServiceRequest createServiceRequest)
                                     throws InvalidInputException,
ResourceLimitExceededException,
NamespaceNotFoundException,
ServiceAlreadyExistsException,
TooManyTagsException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Creates a service. This action defines the configuration for the following entities:

• For public and private DNS namespaces, one of the following combinations of DNS records in Amazon Route 53:

  • A

  • AAAA

  • A and AAAA

  • SRV

  • CNAME

• Optionally, a health check

After you create the service, you can submit a RegisterInstance request, and Cloud Map uses the values in the configuration to create the specified entities.

For the current quota on the number of instances that you can register using the same namespace and using the same service, see Cloud Map quotas in the Cloud Map Developer Guide.

Parameters:

createServiceRequest -

Returns:

Result of the CreateService operation returned by the service.

See Also:

• AWS API Documentation

createService

default CreateServiceResponse createService(Consumer<CreateServiceRequest.Builder> createServiceRequest)
                                     throws InvalidInputException,
ResourceLimitExceededException,
NamespaceNotFoundException,
ServiceAlreadyExistsException,
TooManyTagsException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Creates a service. This action defines the configuration for the following entities:

• For public and private DNS namespaces, one of the following combinations of DNS records in Amazon Route 53:

  • A

  • AAAA

  • A and AAAA

  • SRV

  • CNAME

• Optionally, a health check

After you create the service, you can submit a RegisterInstance request, and Cloud Map uses the values in the configuration to create the specified entities.

For the current quota on the number of instances that you can register using the same namespace and using the same service, see Cloud Map quotas in the Cloud Map Developer Guide.

This is a convenience which creates an instance of the CreateServiceRequest.Builder avoiding the need to create one manually via CreateServiceRequest.builder()

Parameters:

createServiceRequest - A Consumer that will call methods on CreateServiceRequest.Builder to create a request.

Returns:

Result of the CreateService operation returned by the service.

See Also:

• AWS API Documentation

deleteNamespace

default DeleteNamespaceResponse deleteNamespace(DeleteNamespaceRequest deleteNamespaceRequest)
                                         throws InvalidInputException,
NamespaceNotFoundException,
ResourceInUseException,
DuplicateRequestException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Deletes a namespace from the current account. If the namespace still contains one or more services, the request fails.

Parameters:

deleteNamespaceRequest -

Returns:

Result of the DeleteNamespace operation returned by the service.

See Also:

• AWS API Documentation

deleteNamespace

default DeleteNamespaceResponse deleteNamespace(Consumer<DeleteNamespaceRequest.Builder> deleteNamespaceRequest)
                                         throws InvalidInputException,
NamespaceNotFoundException,
ResourceInUseException,
DuplicateRequestException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

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()

Parameters:

deleteNamespaceRequest - A Consumer that will call methods on DeleteNamespaceRequest.Builder to create a request.

Returns:

Result of the DeleteNamespace operation returned by the service.

See Also:

• AWS API Documentation

deleteService

default DeleteServiceResponse deleteService(DeleteServiceRequest deleteServiceRequest)
                                     throws InvalidInputException,
ServiceNotFoundException,
ResourceInUseException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Deletes a specified service. If the service still contains one or more registered instances, the request fails.

Parameters:

deleteServiceRequest -

Returns:

Result of the DeleteService operation returned by the service.

See Also:

• AWS API Documentation

deleteService

default DeleteServiceResponse deleteService(Consumer<DeleteServiceRequest.Builder> deleteServiceRequest)
                                     throws InvalidInputException,
ServiceNotFoundException,
ResourceInUseException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

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()

Parameters:

deleteServiceRequest - A Consumer that will call methods on DeleteServiceRequest.Builder to create a request.

Returns:

Result of the DeleteService operation returned by the service.

See Also:

• AWS API Documentation

deregisterInstance

default DeregisterInstanceResponse deregisterInstance(DeregisterInstanceRequest deregisterInstanceRequest)
                                               throws DuplicateRequestException,
InvalidInputException,
InstanceNotFoundException,
ResourceInUseException,
ServiceNotFoundException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Deletes the Amazon Route 53 DNS records and health check, if any, that Cloud Map created for the specified instance.

Parameters:

deregisterInstanceRequest -

Returns:

Result of the DeregisterInstance operation returned by the service.

See Also:

• AWS API Documentation

deregisterInstance

default DeregisterInstanceResponse deregisterInstance(Consumer<DeregisterInstanceRequest.Builder> deregisterInstanceRequest)
                                               throws DuplicateRequestException,
InvalidInputException,
InstanceNotFoundException,
ResourceInUseException,
ServiceNotFoundException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Deletes the Amazon Route 53 DNS records and health check, if any, that 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()

Parameters:

deregisterInstanceRequest - A Consumer that will call methods on DeregisterInstanceRequest.Builder to create a request.

Returns:

Result of the DeregisterInstance operation returned by the service.

See Also:

• AWS API Documentation

discoverInstances

default DiscoverInstancesResponse discoverInstances(DiscoverInstancesRequest discoverInstancesRequest)
                                             throws ServiceNotFoundException,
NamespaceNotFoundException,
InvalidInputException,
RequestLimitExceededException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Discovers registered instances for a specified namespace and service. You can use DiscoverInstances to discover instances for any type of namespace. DiscoverInstances returns a randomized list of instances allowing customers to distribute traffic evenly across instances. For public and private DNS namespaces, you can also use DNS queries to discover instances.

Parameters:

discoverInstancesRequest -

Returns:

Result of the DiscoverInstances operation returned by the service.

See Also:

• AWS API Documentation

discoverInstances

default DiscoverInstancesResponse discoverInstances(Consumer<DiscoverInstancesRequest.Builder> discoverInstancesRequest)
                                             throws ServiceNotFoundException,
NamespaceNotFoundException,
InvalidInputException,
RequestLimitExceededException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Discovers registered instances for a specified namespace and service. You can use DiscoverInstances to discover instances for any type of namespace. DiscoverInstances returns a randomized list of instances allowing customers to distribute traffic evenly across instances. For public and private DNS namespaces, you can also use DNS queries to discover instances.

This is a convenience which creates an instance of the DiscoverInstancesRequest.Builder avoiding the need to create one manually via DiscoverInstancesRequest.builder()

Parameters:

discoverInstancesRequest - A Consumer that will call methods on DiscoverInstancesRequest.Builder to create a request.

Returns:

Result of the DiscoverInstances operation returned by the service.

See Also:

• AWS API Documentation

discoverInstancesRevision

default DiscoverInstancesRevisionResponse discoverInstancesRevision(DiscoverInstancesRevisionRequest discoverInstancesRevisionRequest)
                                                             throws ServiceNotFoundException,
NamespaceNotFoundException,
InvalidInputException,
RequestLimitExceededException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Discovers the increasing revision associated with an instance.

Parameters:

discoverInstancesRevisionRequest -

Returns:

Result of the DiscoverInstancesRevision operation returned by the service.

See Also:

• AWS API Documentation

discoverInstancesRevision

default DiscoverInstancesRevisionResponse discoverInstancesRevision(Consumer<DiscoverInstancesRevisionRequest.Builder> discoverInstancesRevisionRequest)
                                                             throws ServiceNotFoundException,
NamespaceNotFoundException,
InvalidInputException,
RequestLimitExceededException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Discovers the increasing revision associated with an instance.

This is a convenience which creates an instance of the DiscoverInstancesRevisionRequest.Builder avoiding the need to create one manually via DiscoverInstancesRevisionRequest.builder()

Parameters:

discoverInstancesRevisionRequest - A Consumer that will call methods on DiscoverInstancesRevisionRequest.Builder to create a request.

Returns:

Result of the DiscoverInstancesRevision operation returned by the service.

See Also:

• AWS API Documentation

getInstance

default GetInstanceResponse getInstance(GetInstanceRequest getInstanceRequest)
                                 throws InstanceNotFoundException,
InvalidInputException,
ServiceNotFoundException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Gets information about a specified instance.

Parameters:

getInstanceRequest -

Returns:

Result of the GetInstance operation returned by the service.

See Also:

• AWS API Documentation

getInstance

default GetInstanceResponse getInstance(Consumer<GetInstanceRequest.Builder> getInstanceRequest)
                                 throws InstanceNotFoundException,
InvalidInputException,
ServiceNotFoundException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

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()

Parameters:

getInstanceRequest - A Consumer that will call methods on GetInstanceRequest.Builder to create a request.

Returns:

Result of the GetInstance operation returned by the service.

See Also:

• AWS API Documentation

getInstancesHealthStatus

default GetInstancesHealthStatusResponse getInstancesHealthStatus(GetInstancesHealthStatusRequest getInstancesHealthStatusRequest)
                                                           throws InstanceNotFoundException,
InvalidInputException,
ServiceNotFoundException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Gets the current health status (Healthy, Unhealthy, or Unknown) of one or more instances that are associated with a specified service.

There's a brief delay between when you register an instance and when the health status for the instance is available.

Parameters:

getInstancesHealthStatusRequest -

Returns:

Result of the GetInstancesHealthStatus operation returned by the service.

See Also:

• AWS API Documentation

getInstancesHealthStatus

default GetInstancesHealthStatusResponse getInstancesHealthStatus(Consumer<GetInstancesHealthStatusRequest.Builder> getInstancesHealthStatusRequest)
                                                           throws InstanceNotFoundException,
InvalidInputException,
ServiceNotFoundException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Gets the current health status (Healthy, Unhealthy, or Unknown) of one or more instances that are associated with a specified service.

There's a brief delay between when you register an instance and when the health status for the instance is available.

This is a convenience which creates an instance of the GetInstancesHealthStatusRequest.Builder avoiding the need to create one manually via GetInstancesHealthStatusRequest.builder()

Parameters:

getInstancesHealthStatusRequest - A Consumer that will call methods on GetInstancesHealthStatusRequest.Builder to create a request.

Returns:

Result of the GetInstancesHealthStatus operation returned by the service.

See Also:

• AWS API Documentation

getInstancesHealthStatusPaginator

default GetInstancesHealthStatusIterable getInstancesHealthStatusPaginator(GetInstancesHealthStatusRequest getInstancesHealthStatusRequest)
                                                                    throws InstanceNotFoundException,
InvalidInputException,
ServiceNotFoundException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

This is a variant of getInstancesHealthStatus(software.amazon.awssdk.services.servicediscovery.model.GetInstancesHealthStatusRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.servicediscovery.paginators.GetInstancesHealthStatusIterable responses = client.getInstancesHealthStatusPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.servicediscovery.paginators.GetInstancesHealthStatusIterable responses = client
             .getInstancesHealthStatusPaginator(request);
     for (software.amazon.awssdk.services.servicediscovery.model.GetInstancesHealthStatusResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.servicediscovery.paginators.GetInstancesHealthStatusIterable responses = client.getInstancesHealthStatusPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

Note: If you prefer to have control on service calls, use the getInstancesHealthStatus(software.amazon.awssdk.services.servicediscovery.model.GetInstancesHealthStatusRequest) operation.

Parameters:

getInstancesHealthStatusRequest -

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

getInstancesHealthStatusPaginator

default GetInstancesHealthStatusIterable getInstancesHealthStatusPaginator(Consumer<GetInstancesHealthStatusRequest.Builder> getInstancesHealthStatusRequest)
                                                                    throws InstanceNotFoundException,
InvalidInputException,
ServiceNotFoundException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

This is a variant of getInstancesHealthStatus(software.amazon.awssdk.services.servicediscovery.model.GetInstancesHealthStatusRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.servicediscovery.paginators.GetInstancesHealthStatusIterable responses = client.getInstancesHealthStatusPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.servicediscovery.paginators.GetInstancesHealthStatusIterable responses = client
             .getInstancesHealthStatusPaginator(request);
     for (software.amazon.awssdk.services.servicediscovery.model.GetInstancesHealthStatusResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.servicediscovery.paginators.GetInstancesHealthStatusIterable responses = client.getInstancesHealthStatusPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

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()

Parameters:

getInstancesHealthStatusRequest - A Consumer that will call methods on GetInstancesHealthStatusRequest.Builder to create a request.

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

getNamespace

default GetNamespaceResponse getNamespace(GetNamespaceRequest getNamespaceRequest)
                                   throws InvalidInputException,
NamespaceNotFoundException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Gets information about a namespace.

Parameters:

getNamespaceRequest -

Returns:

Result of the GetNamespace operation returned by the service.

See Also:

• AWS API Documentation

getNamespace

default GetNamespaceResponse getNamespace(Consumer<GetNamespaceRequest.Builder> getNamespaceRequest)
                                   throws InvalidInputException,
NamespaceNotFoundException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

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()

Parameters:

getNamespaceRequest - A Consumer that will call methods on GetNamespaceRequest.Builder to create a request.

Returns:

Result of the GetNamespace operation returned by the service.

See Also:

• AWS API Documentation

getOperation

default GetOperationResponse getOperation(GetOperationRequest getOperationRequest)
                                   throws InvalidInputException,
OperationNotFoundException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Gets information about any operation that returns an operation ID in the response, such as a CreateHttpNamespace request.

To get a list of operations that match specified criteria, see ListOperations.

Parameters:

getOperationRequest -

Returns:

Result of the GetOperation operation returned by the service.

See Also:

• AWS API Documentation

getOperation

default GetOperationResponse getOperation(Consumer<GetOperationRequest.Builder> getOperationRequest)
                                   throws InvalidInputException,
OperationNotFoundException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Gets information about any operation that returns an operation ID in the response, such as a CreateHttpNamespace request.

To get a list of operations that match specified criteria, see ListOperations.

This is a convenience which creates an instance of the GetOperationRequest.Builder avoiding the need to create one manually via GetOperationRequest.builder()

Parameters:

getOperationRequest - A Consumer that will call methods on GetOperationRequest.Builder to create a request.

Returns:

Result of the GetOperation operation returned by the service.

See Also:

• AWS API Documentation

getService

default GetServiceResponse getService(GetServiceRequest getServiceRequest)
                               throws InvalidInputException,
ServiceNotFoundException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Gets the settings for a specified service.

Parameters:

getServiceRequest -

Returns:

Result of the GetService operation returned by the service.

See Also:

• AWS API Documentation

getService

default GetServiceResponse getService(Consumer<GetServiceRequest.Builder> getServiceRequest)
                               throws InvalidInputException,
ServiceNotFoundException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

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()

Parameters:

getServiceRequest - A Consumer that will call methods on GetServiceRequest.Builder to create a request.

Returns:

Result of the GetService operation returned by the service.

See Also:

• AWS API Documentation

listInstances

default ListInstancesResponse listInstances(ListInstancesRequest listInstancesRequest)
                                     throws ServiceNotFoundException,
InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Lists summary information about the instances that you registered by using a specified service.

Parameters:

listInstancesRequest -

Returns:

Result of the ListInstances operation returned by the service.

See Also:

• AWS API Documentation

listInstances

default ListInstancesResponse listInstances(Consumer<ListInstancesRequest.Builder> listInstancesRequest)
                                     throws ServiceNotFoundException,
InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

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()

Parameters:

listInstancesRequest - A Consumer that will call methods on ListInstancesRequest.Builder to create a request.

Returns:

Result of the ListInstances operation returned by the service.

See Also:

• AWS API Documentation

listInstancesPaginator

default ListInstancesIterable listInstancesPaginator(ListInstancesRequest listInstancesRequest)
                                              throws ServiceNotFoundException,
InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

This is a variant of listInstances(software.amazon.awssdk.services.servicediscovery.model.ListInstancesRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListInstancesIterable responses = client.listInstancesPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.servicediscovery.paginators.ListInstancesIterable responses = client
             .listInstancesPaginator(request);
     for (software.amazon.awssdk.services.servicediscovery.model.ListInstancesResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListInstancesIterable responses = client.listInstancesPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

Note: If you prefer to have control on service calls, use the listInstances(software.amazon.awssdk.services.servicediscovery.model.ListInstancesRequest) operation.

Parameters:

listInstancesRequest -

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

listInstancesPaginator

default ListInstancesIterable listInstancesPaginator(Consumer<ListInstancesRequest.Builder> listInstancesRequest)
                                              throws ServiceNotFoundException,
InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

This is a variant of listInstances(software.amazon.awssdk.services.servicediscovery.model.ListInstancesRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListInstancesIterable responses = client.listInstancesPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.servicediscovery.paginators.ListInstancesIterable responses = client
             .listInstancesPaginator(request);
     for (software.amazon.awssdk.services.servicediscovery.model.ListInstancesResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListInstancesIterable responses = client.listInstancesPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

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()

Parameters:

listInstancesRequest - A Consumer that will call methods on ListInstancesRequest.Builder to create a request.

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

listNamespaces

default ListNamespacesResponse listNamespaces(ListNamespacesRequest listNamespacesRequest)
                                       throws InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Lists summary information about the namespaces that were created by the current Amazon Web Services account.

Parameters:

listNamespacesRequest -

Returns:

Result of the ListNamespaces operation returned by the service.

See Also:

• AWS API Documentation

listNamespaces

default ListNamespacesResponse listNamespaces(Consumer<ListNamespacesRequest.Builder> listNamespacesRequest)
                                       throws InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Lists summary information about the namespaces that were created by the current Amazon Web Services account.

This is a convenience which creates an instance of the ListNamespacesRequest.Builder avoiding the need to create one manually via ListNamespacesRequest.builder()

Parameters:

listNamespacesRequest - A Consumer that will call methods on ListNamespacesRequest.Builder to create a request.

Returns:

Result of the ListNamespaces operation returned by the service.

See Also:

• AWS API Documentation

listNamespaces

default ListNamespacesResponse listNamespaces()
                                       throws InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Lists summary information about the namespaces that were created by the current Amazon Web Services account.

Returns:

Result of the ListNamespaces operation returned by the service.

See Also:

• listNamespaces(ListNamespacesRequest)
• AWS API Documentation

listNamespacesPaginator

default ListNamespacesIterable listNamespacesPaginator()
                                                throws InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

This is a variant of listNamespaces(software.amazon.awssdk.services.servicediscovery.model.ListNamespacesRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListNamespacesIterable responses = client.listNamespacesPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.servicediscovery.paginators.ListNamespacesIterable responses = client
             .listNamespacesPaginator(request);
     for (software.amazon.awssdk.services.servicediscovery.model.ListNamespacesResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListNamespacesIterable responses = client.listNamespacesPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

Note: If you prefer to have control on service calls, use the listNamespaces(software.amazon.awssdk.services.servicediscovery.model.ListNamespacesRequest) operation.

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• listNamespacesPaginator(ListNamespacesRequest)
• AWS API Documentation

listNamespacesPaginator

default ListNamespacesIterable listNamespacesPaginator(ListNamespacesRequest listNamespacesRequest)
                                                throws InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

This is a variant of listNamespaces(software.amazon.awssdk.services.servicediscovery.model.ListNamespacesRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListNamespacesIterable responses = client.listNamespacesPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.servicediscovery.paginators.ListNamespacesIterable responses = client
             .listNamespacesPaginator(request);
     for (software.amazon.awssdk.services.servicediscovery.model.ListNamespacesResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListNamespacesIterable responses = client.listNamespacesPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

Note: If you prefer to have control on service calls, use the listNamespaces(software.amazon.awssdk.services.servicediscovery.model.ListNamespacesRequest) operation.

Parameters:

listNamespacesRequest -

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

listNamespacesPaginator

default ListNamespacesIterable listNamespacesPaginator(Consumer<ListNamespacesRequest.Builder> listNamespacesRequest)
                                                throws InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

This is a variant of listNamespaces(software.amazon.awssdk.services.servicediscovery.model.ListNamespacesRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListNamespacesIterable responses = client.listNamespacesPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.servicediscovery.paginators.ListNamespacesIterable responses = client
             .listNamespacesPaginator(request);
     for (software.amazon.awssdk.services.servicediscovery.model.ListNamespacesResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListNamespacesIterable responses = client.listNamespacesPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

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()

Parameters:

listNamespacesRequest - A Consumer that will call methods on ListNamespacesRequest.Builder to create a request.

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

listOperations

default ListOperationsResponse listOperations(ListOperationsRequest listOperationsRequest)
                                       throws InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Lists operations that match the criteria that you specify.

Parameters:

listOperationsRequest -

Returns:

Result of the ListOperations operation returned by the service.

See Also:

• AWS API Documentation

listOperations

default ListOperationsResponse listOperations(Consumer<ListOperationsRequest.Builder> listOperationsRequest)
                                       throws InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

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()

Parameters:

listOperationsRequest - A Consumer that will call methods on ListOperationsRequest.Builder to create a request.

Returns:

Result of the ListOperations operation returned by the service.

See Also:

• AWS API Documentation

listOperations

default ListOperationsResponse listOperations()
                                       throws InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Lists operations that match the criteria that you specify.

Returns:

Result of the ListOperations operation returned by the service.

See Also:

• listOperations(ListOperationsRequest)
• AWS API Documentation

listOperationsPaginator

default ListOperationsIterable listOperationsPaginator()
                                                throws InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

This is a variant of listOperations(software.amazon.awssdk.services.servicediscovery.model.ListOperationsRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListOperationsIterable responses = client.listOperationsPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.servicediscovery.paginators.ListOperationsIterable responses = client
             .listOperationsPaginator(request);
     for (software.amazon.awssdk.services.servicediscovery.model.ListOperationsResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListOperationsIterable responses = client.listOperationsPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

Note: If you prefer to have control on service calls, use the listOperations(software.amazon.awssdk.services.servicediscovery.model.ListOperationsRequest) operation.

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• listOperationsPaginator(ListOperationsRequest)
• AWS API Documentation

listOperationsPaginator

default ListOperationsIterable listOperationsPaginator(ListOperationsRequest listOperationsRequest)
                                                throws InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

This is a variant of listOperations(software.amazon.awssdk.services.servicediscovery.model.ListOperationsRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListOperationsIterable responses = client.listOperationsPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.servicediscovery.paginators.ListOperationsIterable responses = client
             .listOperationsPaginator(request);
     for (software.amazon.awssdk.services.servicediscovery.model.ListOperationsResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListOperationsIterable responses = client.listOperationsPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

Note: If you prefer to have control on service calls, use the listOperations(software.amazon.awssdk.services.servicediscovery.model.ListOperationsRequest) operation.

Parameters:

listOperationsRequest -

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

listOperationsPaginator

default ListOperationsIterable listOperationsPaginator(Consumer<ListOperationsRequest.Builder> listOperationsRequest)
                                                throws InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

This is a variant of listOperations(software.amazon.awssdk.services.servicediscovery.model.ListOperationsRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListOperationsIterable responses = client.listOperationsPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.servicediscovery.paginators.ListOperationsIterable responses = client
             .listOperationsPaginator(request);
     for (software.amazon.awssdk.services.servicediscovery.model.ListOperationsResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListOperationsIterable responses = client.listOperationsPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

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()

Parameters:

listOperationsRequest - A Consumer that will call methods on ListOperationsRequest.Builder to create a request.

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

listServices

default ListServicesResponse listServices(ListServicesRequest listServicesRequest)
                                   throws InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Lists summary information for all the services that are associated with one or more namespaces.

Parameters:

listServicesRequest -

Returns:

Result of the ListServices operation returned by the service.

See Also:

• AWS API Documentation

listServices

default ListServicesResponse listServices(Consumer<ListServicesRequest.Builder> listServicesRequest)
                                   throws InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Lists summary information for all the services that are associated with one or more namespaces.

This is a convenience which creates an instance of the ListServicesRequest.Builder avoiding the need to create one manually via ListServicesRequest.builder()

Parameters:

listServicesRequest - A Consumer that will call methods on ListServicesRequest.Builder to create a request.

Returns:

Result of the ListServices operation returned by the service.

See Also:

• AWS API Documentation

listServices

default ListServicesResponse listServices()
                                   throws InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Lists summary information for all the services that are associated with one or more namespaces.

Returns:

Result of the ListServices operation returned by the service.

See Also:

• listServices(ListServicesRequest)
• AWS API Documentation

listServicesPaginator

default ListServicesIterable listServicesPaginator()
                                            throws InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

This is a variant of listServices(software.amazon.awssdk.services.servicediscovery.model.ListServicesRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListServicesIterable responses = client.listServicesPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.servicediscovery.paginators.ListServicesIterable responses = client
             .listServicesPaginator(request);
     for (software.amazon.awssdk.services.servicediscovery.model.ListServicesResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListServicesIterable responses = client.listServicesPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

Note: If you prefer to have control on service calls, use the listServices(software.amazon.awssdk.services.servicediscovery.model.ListServicesRequest) operation.

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• listServicesPaginator(ListServicesRequest)
• AWS API Documentation

listServicesPaginator

default ListServicesIterable listServicesPaginator(ListServicesRequest listServicesRequest)
                                            throws InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

This is a variant of listServices(software.amazon.awssdk.services.servicediscovery.model.ListServicesRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListServicesIterable responses = client.listServicesPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.servicediscovery.paginators.ListServicesIterable responses = client
             .listServicesPaginator(request);
     for (software.amazon.awssdk.services.servicediscovery.model.ListServicesResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListServicesIterable responses = client.listServicesPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

Note: If you prefer to have control on service calls, use the listServices(software.amazon.awssdk.services.servicediscovery.model.ListServicesRequest) operation.

Parameters:

listServicesRequest -

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

listServicesPaginator

default ListServicesIterable listServicesPaginator(Consumer<ListServicesRequest.Builder> listServicesRequest)
                                            throws InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

This is a variant of listServices(software.amazon.awssdk.services.servicediscovery.model.ListServicesRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListServicesIterable responses = client.listServicesPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.servicediscovery.paginators.ListServicesIterable responses = client
             .listServicesPaginator(request);
     for (software.amazon.awssdk.services.servicediscovery.model.ListServicesResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.servicediscovery.paginators.ListServicesIterable responses = client.listServicesPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

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()

Parameters:

listServicesRequest - A Consumer that will call methods on ListServicesRequest.Builder to create a request.

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

listTagsForResource

default ListTagsForResourceResponse listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
                                                 throws ResourceNotFoundException,
InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Lists tags for the specified resource.

Parameters:

listTagsForResourceRequest -

Returns:

Result of the ListTagsForResource operation returned by the service.

See Also:

• AWS API Documentation

listTagsForResource

default ListTagsForResourceResponse listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest)
                                                 throws ResourceNotFoundException,
InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Lists tags for the specified resource.

This is a convenience which creates an instance of the ListTagsForResourceRequest.Builder avoiding the need to create one manually via ListTagsForResourceRequest.builder()

Parameters:

listTagsForResourceRequest - A Consumer that will call methods on ListTagsForResourceRequest.Builder to create a request.

Returns:

Result of the ListTagsForResource operation returned by the service.

See Also:

• AWS API Documentation

registerInstance

default RegisterInstanceResponse registerInstance(RegisterInstanceRequest registerInstanceRequest)
                                           throws DuplicateRequestException,
InvalidInputException,
ResourceInUseException,
ResourceLimitExceededException,
ServiceNotFoundException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Creates or updates one or more records and, optionally, creates a health check based on the settings in a specified service. When you submit a RegisterInstance request, the following occurs:

• For each DNS record that you define in the service that's specified by ServiceId, a record is created or updated in the hosted zone that's associated with the corresponding namespace.

• If the service includes HealthCheckConfig, a health check is created based on the settings in the health check configuration.

• The health check, if any, is associated with each of the new or updated records.

One RegisterInstance request must complete before you can submit another request and specify the same service ID and instance ID.

For more information, see CreateService.

When Cloud Map receives a DNS query for the specified DNS name, it returns the applicable value:

• If the health check is healthy: returns all the records

• If the health check is unhealthy: returns the applicable value for the last healthy instance

• If you didn't specify a health check configuration: returns all the records

For the current quota on the number of instances that you can register using the same namespace and using the same service, see Cloud Map quotas in the Cloud Map Developer Guide.

Parameters:

registerInstanceRequest -

Returns:

Result of the RegisterInstance operation returned by the service.

See Also:

• AWS API Documentation

registerInstance

default RegisterInstanceResponse registerInstance(Consumer<RegisterInstanceRequest.Builder> registerInstanceRequest)
                                           throws DuplicateRequestException,
InvalidInputException,
ResourceInUseException,
ResourceLimitExceededException,
ServiceNotFoundException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Creates or updates one or more records and, optionally, creates a health check based on the settings in a specified service. When you submit a RegisterInstance request, the following occurs:

• For each DNS record that you define in the service that's specified by ServiceId, a record is created or updated in the hosted zone that's associated with the corresponding namespace.

• If the service includes HealthCheckConfig, a health check is created based on the settings in the health check configuration.

• The health check, if any, is associated with each of the new or updated records.

One RegisterInstance request must complete before you can submit another request and specify the same service ID and instance ID.

For more information, see CreateService.

When Cloud Map receives a DNS query for the specified DNS name, it returns the applicable value:

• If the health check is healthy: returns all the records

• If the health check is unhealthy: returns the applicable value for the last healthy instance

• If you didn't specify a health check configuration: returns all the records

For the current quota on the number of instances that you can register using the same namespace and using the same service, see Cloud Map quotas in the Cloud Map Developer Guide.

This is a convenience which creates an instance of the RegisterInstanceRequest.Builder avoiding the need to create one manually via RegisterInstanceRequest.builder()

Parameters:

registerInstanceRequest - A Consumer that will call methods on RegisterInstanceRequest.Builder to create a request.

Returns:

Result of the RegisterInstance operation returned by the service.

See Also:

• AWS API Documentation

tagResource

default TagResourceResponse tagResource(TagResourceRequest tagResourceRequest)
                                 throws ResourceNotFoundException,
TooManyTagsException,
InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Adds one or more tags to the specified resource.

Parameters:

tagResourceRequest -

Returns:

Result of the TagResource operation returned by the service.

See Also:

• AWS API Documentation

tagResource

default TagResourceResponse tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest)
                                 throws ResourceNotFoundException,
TooManyTagsException,
InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Adds one or more tags to the specified resource.

This is a convenience which creates an instance of the TagResourceRequest.Builder avoiding the need to create one manually via TagResourceRequest.builder()

Parameters:

tagResourceRequest - A Consumer that will call methods on TagResourceRequest.Builder to create a request.

Returns:

Result of the TagResource operation returned by the service.

See Also:

• AWS API Documentation

untagResource

default UntagResourceResponse untagResource(UntagResourceRequest untagResourceRequest)
                                     throws ResourceNotFoundException,
InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Removes one or more tags from the specified resource.

Parameters:

untagResourceRequest -

Returns:

Result of the UntagResource operation returned by the service.

See Also:

• AWS API Documentation

untagResource

default UntagResourceResponse untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest)
                                     throws ResourceNotFoundException,
InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Removes one or more tags from the specified resource.

This is a convenience which creates an instance of the UntagResourceRequest.Builder avoiding the need to create one manually via UntagResourceRequest.builder()

Parameters:

untagResourceRequest - A Consumer that will call methods on UntagResourceRequest.Builder to create a request.

Returns:

Result of the UntagResource operation returned by the service.

See Also:

• AWS API Documentation

updateHttpNamespace

default UpdateHttpNamespaceResponse updateHttpNamespace(UpdateHttpNamespaceRequest updateHttpNamespaceRequest)
                                                 throws InvalidInputException,
NamespaceNotFoundException,
ResourceInUseException,
DuplicateRequestException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Updates an HTTP namespace.

Parameters:

updateHttpNamespaceRequest -

Returns:

Result of the UpdateHttpNamespace operation returned by the service.

See Also:

• AWS API Documentation

updateHttpNamespace

default UpdateHttpNamespaceResponse updateHttpNamespace(Consumer<UpdateHttpNamespaceRequest.Builder> updateHttpNamespaceRequest)
                                                 throws InvalidInputException,
NamespaceNotFoundException,
ResourceInUseException,
DuplicateRequestException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Updates an HTTP namespace.

This is a convenience which creates an instance of the UpdateHttpNamespaceRequest.Builder avoiding the need to create one manually via UpdateHttpNamespaceRequest.builder()

Parameters:

updateHttpNamespaceRequest - A Consumer that will call methods on UpdateHttpNamespaceRequest.Builder to create a request.

Returns:

Result of the UpdateHttpNamespace operation returned by the service.

See Also:

• AWS API Documentation

updateInstanceCustomHealthStatus

default UpdateInstanceCustomHealthStatusResponse updateInstanceCustomHealthStatus(UpdateInstanceCustomHealthStatusRequest updateInstanceCustomHealthStatusRequest)
                                                                           throws InstanceNotFoundException,
ServiceNotFoundException,
CustomHealthNotFoundException,
InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

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.

Parameters:

updateInstanceCustomHealthStatusRequest -

Returns:

Result of the UpdateInstanceCustomHealthStatus operation returned by the service.

See Also:

• AWS API Documentation

updateInstanceCustomHealthStatus

default UpdateInstanceCustomHealthStatusResponse updateInstanceCustomHealthStatus(Consumer<UpdateInstanceCustomHealthStatusRequest.Builder> updateInstanceCustomHealthStatusRequest)
                                                                           throws InstanceNotFoundException,
ServiceNotFoundException,
CustomHealthNotFoundException,
InvalidInputException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

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()

Parameters:

updateInstanceCustomHealthStatusRequest - A Consumer that will call methods on UpdateInstanceCustomHealthStatusRequest.Builder to create a request.

Returns:

Result of the UpdateInstanceCustomHealthStatus operation returned by the service.

See Also:

• AWS API Documentation

updatePrivateDnsNamespace

default UpdatePrivateDnsNamespaceResponse updatePrivateDnsNamespace(UpdatePrivateDnsNamespaceRequest updatePrivateDnsNamespaceRequest)
                                                             throws InvalidInputException,
NamespaceNotFoundException,
ResourceInUseException,
DuplicateRequestException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Updates a private DNS namespace.

Parameters:

updatePrivateDnsNamespaceRequest -

Returns:

Result of the UpdatePrivateDnsNamespace operation returned by the service.

See Also:

• AWS API Documentation

updatePrivateDnsNamespace

default UpdatePrivateDnsNamespaceResponse updatePrivateDnsNamespace(Consumer<UpdatePrivateDnsNamespaceRequest.Builder> updatePrivateDnsNamespaceRequest)
                                                             throws InvalidInputException,
NamespaceNotFoundException,
ResourceInUseException,
DuplicateRequestException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Updates a private DNS namespace.

This is a convenience which creates an instance of the UpdatePrivateDnsNamespaceRequest.Builder avoiding the need to create one manually via UpdatePrivateDnsNamespaceRequest.builder()

Parameters:

updatePrivateDnsNamespaceRequest - A Consumer that will call methods on UpdatePrivateDnsNamespaceRequest.Builder to create a request.

Returns:

Result of the UpdatePrivateDnsNamespace operation returned by the service.

See Also:

• AWS API Documentation

updatePublicDnsNamespace

default UpdatePublicDnsNamespaceResponse updatePublicDnsNamespace(UpdatePublicDnsNamespaceRequest updatePublicDnsNamespaceRequest)
                                                           throws InvalidInputException,
NamespaceNotFoundException,
ResourceInUseException,
DuplicateRequestException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Updates a public DNS namespace.

Parameters:

updatePublicDnsNamespaceRequest -

Returns:

Result of the UpdatePublicDnsNamespace operation returned by the service.

See Also:

• AWS API Documentation

updatePublicDnsNamespace

default UpdatePublicDnsNamespaceResponse updatePublicDnsNamespace(Consumer<UpdatePublicDnsNamespaceRequest.Builder> updatePublicDnsNamespaceRequest)
                                                           throws InvalidInputException,
NamespaceNotFoundException,
ResourceInUseException,
DuplicateRequestException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Updates a public DNS namespace.

This is a convenience which creates an instance of the UpdatePublicDnsNamespaceRequest.Builder avoiding the need to create one manually via UpdatePublicDnsNamespaceRequest.builder()

Parameters:

updatePublicDnsNamespaceRequest - A Consumer that will call methods on UpdatePublicDnsNamespaceRequest.Builder to create a request.

Returns:

Result of the UpdatePublicDnsNamespace operation returned by the service.

See Also:

• AWS API Documentation

updateService

default UpdateServiceResponse updateService(UpdateServiceRequest updateServiceRequest)
                                     throws DuplicateRequestException,
InvalidInputException,
ServiceNotFoundException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Submits a request to perform the following operations:

• Update the TTL setting for existing DnsRecords configurations

• Add, update, or delete HealthCheckConfig for a specified service

  You can't add, update, or delete a HealthCheckCustomConfig configuration.

For public and private DNS namespaces, note the following:

• If you omit any existing DnsRecords or HealthCheckConfig configurations from an UpdateService request, the configurations are deleted from the service.

• If you omit an existing HealthCheckCustomConfig configuration from an UpdateService request, the configuration isn't deleted from the service.

When you update settings for a service, Cloud Map also updates the corresponding settings in all the records and health checks that were created by using the specified service.

Parameters:

updateServiceRequest -

Returns:

Result of the UpdateService operation returned by the service.

See Also:

• AWS API Documentation

updateService

default UpdateServiceResponse updateService(Consumer<UpdateServiceRequest.Builder> updateServiceRequest)
                                     throws DuplicateRequestException,
InvalidInputException,
ServiceNotFoundException,
AwsServiceException,
SdkClientException,
ServiceDiscoveryException

Submits a request to perform the following operations:

• Update the TTL setting for existing DnsRecords configurations

• Add, update, or delete HealthCheckConfig for a specified service

  You can't add, update, or delete a HealthCheckCustomConfig configuration.

For public and private DNS namespaces, note the following:

• If you omit any existing DnsRecords or HealthCheckConfig configurations from an UpdateService request, the configurations are deleted from the service.

• If you omit an existing HealthCheckCustomConfig configuration from an UpdateService request, the configuration isn't deleted from the service.

When you update settings for a service, Cloud Map also updates the corresponding settings in all the records and health checks that were created by using the specified service.

This is a convenience which creates an instance of the UpdateServiceRequest.Builder avoiding the need to create one manually via UpdateServiceRequest.builder()

Parameters:

updateServiceRequest - A Consumer that will call methods on UpdateServiceRequest.Builder to create a request.

Returns:

Result of the UpdateService operation returned by the service.

See Also:

• AWS API Documentation

create

static ServiceDiscoveryClient create()

Create a ServiceDiscoveryClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.

builder

static ServiceDiscoveryClientBuilder builder()

Create a builder that can be used to configure and create a ServiceDiscoveryClient.

serviceMetadata

static ServiceMetadata serviceMetadata()

serviceClientConfiguration

default ServiceDiscoveryServiceClientConfiguration serviceClientConfiguration()

Description copied from interface: SdkClient

The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration

Specified by:

serviceClientConfiguration in interface AwsClient

Specified by:

serviceClientConfiguration in interface SdkClient

Returns:

SdkServiceClientConfiguration