Interface MarketplaceDiscoveryAsyncClient

All Superinterfaces:
AutoCloseable, AwsClient, SdkAutoCloseable, SdkClient
@Generated("software.amazon.awssdk:codegen") @SdkPublicApi @ThreadSafe public interface MarketplaceDiscoveryAsyncClient extends AwsClient
Service client for accessing Marketplace Discovery asynchronously. This can be created using the static builder() method.The asynchronous client performs non-blocking I/O when configured with any SdkAsyncHttpClient supported in the SDK. However, full non-blocking is not guaranteed as the async client may perform blocking calls in some cases such as credentials retrieval and endpoint discovery as part of the async API call.

The AWS Marketplace Discovery API provides programmatic access to the AWS Marketplace catalog, including searching and browsing listings, retrieving product details and fulfillment options, and accessing public and private offer pricing and terms.

  • Field Details

  • Method Details

    • getListing

      default CompletableFuture<GetListingResponse> getListing(GetListingRequest getListingRequest)

      Provides details about a listing, such as descriptions, badges, categories, pricing model summaries, reviews, and associated products and offers.

      Parameters:
      getListingRequest -
      Returns:
      A Java Future containing the result of the GetListing operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • ResourceNotFoundException The specified resource doesn't exist.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getListing

      default CompletableFuture<GetListingResponse> getListing(Consumer<GetListingRequest.Builder> getListingRequest)

      Provides details about a listing, such as descriptions, badges, categories, pricing model summaries, reviews, and associated products and offers.


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

      Parameters:
      getListingRequest - A Consumer that will call methods on GetListingRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetListing operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • ResourceNotFoundException The specified resource doesn't exist.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getOffer

      default CompletableFuture<GetOfferResponse> getOffer(GetOfferRequest getOfferRequest)

      Provides details about an offer, such as the pricing model, seller of record, availability dates, badges, and associated products.

      Parameters:
      getOfferRequest -
      Returns:
      A Java Future containing the result of the GetOffer operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • ResourceNotFoundException The specified resource doesn't exist.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getOffer

      default CompletableFuture<GetOfferResponse> getOffer(Consumer<GetOfferRequest.Builder> getOfferRequest)

      Provides details about an offer, such as the pricing model, seller of record, availability dates, badges, and associated products.


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

      Parameters:
      getOfferRequest - A Consumer that will call methods on GetOfferRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetOffer operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • ResourceNotFoundException The specified resource doesn't exist.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getOfferSet

      default CompletableFuture<GetOfferSetResponse> getOfferSet(GetOfferSetRequest getOfferSetRequest)

      Provides details about an offer set, which is a bundle of offers across multiple products. Includes the seller, availability dates, buyer notes, and associated product-offer pairs.

      Parameters:
      getOfferSetRequest -
      Returns:
      A Java Future containing the result of the GetOfferSet operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • ResourceNotFoundException The specified resource doesn't exist.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getOfferSet

      default CompletableFuture<GetOfferSetResponse> getOfferSet(Consumer<GetOfferSetRequest.Builder> getOfferSetRequest)

      Provides details about an offer set, which is a bundle of offers across multiple products. Includes the seller, availability dates, buyer notes, and associated product-offer pairs.


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

      Parameters:
      getOfferSetRequest - A Consumer that will call methods on GetOfferSetRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetOfferSet operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • ResourceNotFoundException The specified resource doesn't exist.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getOfferTerms

      default CompletableFuture<GetOfferTermsResponse> getOfferTerms(GetOfferTermsRequest getOfferTermsRequest)

      Returns the terms attached to an offer, such as pricing terms (usage-based, contract, BYOL, free trial), legal terms, payment schedules, validity terms, support terms, and renewal terms.

      Parameters:
      getOfferTermsRequest -
      Returns:
      A Java Future containing the result of the GetOfferTerms operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • ResourceNotFoundException The specified resource doesn't exist.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getOfferTerms

      default CompletableFuture<GetOfferTermsResponse> getOfferTerms(Consumer<GetOfferTermsRequest.Builder> getOfferTermsRequest)

      Returns the terms attached to an offer, such as pricing terms (usage-based, contract, BYOL, free trial), legal terms, payment schedules, validity terms, support terms, and renewal terms.


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

      Parameters:
      getOfferTermsRequest - A Consumer that will call methods on GetOfferTermsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetOfferTerms operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • ResourceNotFoundException The specified resource doesn't exist.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getOfferTermsPaginator

      default GetOfferTermsPublisher getOfferTermsPaginator(GetOfferTermsRequest getOfferTermsRequest)

      This is a variant of getOfferTerms(software.amazon.awssdk.services.marketplacediscovery.model.GetOfferTermsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.GetOfferTermsPublisher publisher = client.getOfferTermsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.GetOfferTermsPublisher publisher = client.getOfferTermsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.marketplacediscovery.model.GetOfferTermsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.marketplacediscovery.model.GetOfferTermsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 getOfferTerms(software.amazon.awssdk.services.marketplacediscovery.model.GetOfferTermsRequest) operation.

      Parameters:
      getOfferTermsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • ResourceNotFoundException The specified resource doesn't exist.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getOfferTermsPaginator

      default GetOfferTermsPublisher getOfferTermsPaginator(Consumer<GetOfferTermsRequest.Builder> getOfferTermsRequest)

      This is a variant of getOfferTerms(software.amazon.awssdk.services.marketplacediscovery.model.GetOfferTermsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.GetOfferTermsPublisher publisher = client.getOfferTermsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.GetOfferTermsPublisher publisher = client.getOfferTermsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.marketplacediscovery.model.GetOfferTermsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.marketplacediscovery.model.GetOfferTermsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 getOfferTerms(software.amazon.awssdk.services.marketplacediscovery.model.GetOfferTermsRequest) operation.


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

      Parameters:
      getOfferTermsRequest - A Consumer that will call methods on GetOfferTermsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • ResourceNotFoundException The specified resource doesn't exist.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getProduct

      default CompletableFuture<GetProductResponse> getProduct(GetProductRequest getProductRequest)

      Provides details about a product, such as descriptions, highlights, categories, fulfillment option summaries, promotional media, and seller engagement options.

      Parameters:
      getProductRequest -
      Returns:
      A Java Future containing the result of the GetProduct operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • ResourceNotFoundException The specified resource doesn't exist.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getProduct

      default CompletableFuture<GetProductResponse> getProduct(Consumer<GetProductRequest.Builder> getProductRequest)

      Provides details about a product, such as descriptions, highlights, categories, fulfillment option summaries, promotional media, and seller engagement options.


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

      Parameters:
      getProductRequest - A Consumer that will call methods on GetProductRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetProduct operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • ResourceNotFoundException The specified resource doesn't exist.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listFulfillmentOptions

      default CompletableFuture<ListFulfillmentOptionsResponse> listFulfillmentOptions(ListFulfillmentOptionsRequest listFulfillmentOptionsRequest)

      Returns the fulfillment options available for a product, including deployment details such as version information, operating systems, usage instructions, and release notes.

      Parameters:
      listFulfillmentOptionsRequest -
      Returns:
      A Java Future containing the result of the ListFulfillmentOptions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • ResourceNotFoundException The specified resource doesn't exist.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listFulfillmentOptions

      default CompletableFuture<ListFulfillmentOptionsResponse> listFulfillmentOptions(Consumer<ListFulfillmentOptionsRequest.Builder> listFulfillmentOptionsRequest)

      Returns the fulfillment options available for a product, including deployment details such as version information, operating systems, usage instructions, and release notes.


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

      Parameters:
      listFulfillmentOptionsRequest - A Consumer that will call methods on ListFulfillmentOptionsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListFulfillmentOptions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • ResourceNotFoundException The specified resource doesn't exist.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listFulfillmentOptionsPaginator

      default ListFulfillmentOptionsPublisher listFulfillmentOptionsPaginator(ListFulfillmentOptionsRequest listFulfillmentOptionsRequest)

      This is a variant of listFulfillmentOptions(software.amazon.awssdk.services.marketplacediscovery.model.ListFulfillmentOptionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.ListFulfillmentOptionsPublisher publisher = client.listFulfillmentOptionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.ListFulfillmentOptionsPublisher publisher = client.listFulfillmentOptionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.marketplacediscovery.model.ListFulfillmentOptionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.marketplacediscovery.model.ListFulfillmentOptionsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listFulfillmentOptions(software.amazon.awssdk.services.marketplacediscovery.model.ListFulfillmentOptionsRequest) operation.

      Parameters:
      listFulfillmentOptionsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • ResourceNotFoundException The specified resource doesn't exist.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listFulfillmentOptionsPaginator

      default ListFulfillmentOptionsPublisher listFulfillmentOptionsPaginator(Consumer<ListFulfillmentOptionsRequest.Builder> listFulfillmentOptionsRequest)

      This is a variant of listFulfillmentOptions(software.amazon.awssdk.services.marketplacediscovery.model.ListFulfillmentOptionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.ListFulfillmentOptionsPublisher publisher = client.listFulfillmentOptionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.ListFulfillmentOptionsPublisher publisher = client.listFulfillmentOptionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.marketplacediscovery.model.ListFulfillmentOptionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.marketplacediscovery.model.ListFulfillmentOptionsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listFulfillmentOptions(software.amazon.awssdk.services.marketplacediscovery.model.ListFulfillmentOptionsRequest) operation.


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

      Parameters:
      listFulfillmentOptionsRequest - A Consumer that will call methods on ListFulfillmentOptionsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • ResourceNotFoundException The specified resource doesn't exist.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPurchaseOptions

      default CompletableFuture<ListPurchaseOptionsResponse> listPurchaseOptions(ListPurchaseOptionsRequest listPurchaseOptionsRequest)

      Returns the purchase options (offers and offer sets) available to the buyer. You can filter results by product, seller, purchase option type, visibility scope, and availability status.

      You must include at least one of the following filters in the request: a PRODUCT_ID filter to specify the product for which to retrieve purchase options, or a VISIBILITY_SCOPE filter to retrieve purchase options by visibility.

      Parameters:
      listPurchaseOptionsRequest -
      Returns:
      A Java Future containing the result of the ListPurchaseOptions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPurchaseOptions

      default CompletableFuture<ListPurchaseOptionsResponse> listPurchaseOptions(Consumer<ListPurchaseOptionsRequest.Builder> listPurchaseOptionsRequest)

      Returns the purchase options (offers and offer sets) available to the buyer. You can filter results by product, seller, purchase option type, visibility scope, and availability status.

      You must include at least one of the following filters in the request: a PRODUCT_ID filter to specify the product for which to retrieve purchase options, or a VISIBILITY_SCOPE filter to retrieve purchase options by visibility.


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

      Parameters:
      listPurchaseOptionsRequest - A Consumer that will call methods on ListPurchaseOptionsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListPurchaseOptions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPurchaseOptionsPaginator

      default ListPurchaseOptionsPublisher listPurchaseOptionsPaginator(ListPurchaseOptionsRequest listPurchaseOptionsRequest)

      This is a variant of listPurchaseOptions(software.amazon.awssdk.services.marketplacediscovery.model.ListPurchaseOptionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.ListPurchaseOptionsPublisher publisher = client.listPurchaseOptionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.ListPurchaseOptionsPublisher publisher = client.listPurchaseOptionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.marketplacediscovery.model.ListPurchaseOptionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.marketplacediscovery.model.ListPurchaseOptionsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listPurchaseOptions(software.amazon.awssdk.services.marketplacediscovery.model.ListPurchaseOptionsRequest) operation.

      Parameters:
      listPurchaseOptionsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPurchaseOptionsPaginator

      default ListPurchaseOptionsPublisher listPurchaseOptionsPaginator(Consumer<ListPurchaseOptionsRequest.Builder> listPurchaseOptionsRequest)

      This is a variant of listPurchaseOptions(software.amazon.awssdk.services.marketplacediscovery.model.ListPurchaseOptionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.ListPurchaseOptionsPublisher publisher = client.listPurchaseOptionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.ListPurchaseOptionsPublisher publisher = client.listPurchaseOptionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.marketplacediscovery.model.ListPurchaseOptionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.marketplacediscovery.model.ListPurchaseOptionsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 listPurchaseOptions(software.amazon.awssdk.services.marketplacediscovery.model.ListPurchaseOptionsRequest) operation.


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

      Parameters:
      listPurchaseOptionsRequest - A Consumer that will call methods on ListPurchaseOptionsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • searchFacets

      default CompletableFuture<SearchFacetsResponse> searchFacets(SearchFacetsRequest searchFacetsRequest)

      Returns available facet values for filtering listings, such as categories, pricing models, fulfillment option types, publishers, and customer ratings. Each facet value includes a count of matching listings.

      Parameters:
      searchFacetsRequest -
      Returns:
      A Java Future containing the result of the SearchFacets operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • searchFacets

      default CompletableFuture<SearchFacetsResponse> searchFacets(Consumer<SearchFacetsRequest.Builder> searchFacetsRequest)

      Returns available facet values for filtering listings, such as categories, pricing models, fulfillment option types, publishers, and customer ratings. Each facet value includes a count of matching listings.


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

      Parameters:
      searchFacetsRequest - A Consumer that will call methods on SearchFacetsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the SearchFacets operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • searchFacetsPaginator

      default SearchFacetsPublisher searchFacetsPaginator(SearchFacetsRequest searchFacetsRequest)

      This is a variant of searchFacets(software.amazon.awssdk.services.marketplacediscovery.model.SearchFacetsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.SearchFacetsPublisher publisher = client.searchFacetsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.SearchFacetsPublisher publisher = client.searchFacetsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.marketplacediscovery.model.SearchFacetsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.marketplacediscovery.model.SearchFacetsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of null 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 searchFacets(software.amazon.awssdk.services.marketplacediscovery.model.SearchFacetsRequest) operation.

      Parameters:
      searchFacetsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • searchFacetsPaginator

      default SearchFacetsPublisher searchFacetsPaginator(Consumer<SearchFacetsRequest.Builder> searchFacetsRequest)

      This is a variant of searchFacets(software.amazon.awssdk.services.marketplacediscovery.model.SearchFacetsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.SearchFacetsPublisher publisher = client.searchFacetsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.SearchFacetsPublisher publisher = client.searchFacetsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.marketplacediscovery.model.SearchFacetsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.marketplacediscovery.model.SearchFacetsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of null 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 searchFacets(software.amazon.awssdk.services.marketplacediscovery.model.SearchFacetsRequest) operation.


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

      Parameters:
      searchFacetsRequest - A Consumer that will call methods on SearchFacetsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • searchListings

      default CompletableFuture<SearchListingsResponse> searchListings(SearchListingsRequest searchListingsRequest)

      Returns a list of product listings based on search criteria and filters. You can search by keyword, filter by category, pricing model, fulfillment type, and other attributes, and sort results by relevance or customer rating.

      Parameters:
      searchListingsRequest -
      Returns:
      A Java Future containing the result of the SearchListings operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • searchListings

      default CompletableFuture<SearchListingsResponse> searchListings(Consumer<SearchListingsRequest.Builder> searchListingsRequest)

      Returns a list of product listings based on search criteria and filters. You can search by keyword, filter by category, pricing model, fulfillment type, and other attributes, and sort results by relevance or customer rating.


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

      Parameters:
      searchListingsRequest - A Consumer that will call methods on SearchListingsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the SearchListings operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • searchListingsPaginator

      default SearchListingsPublisher searchListingsPaginator(SearchListingsRequest searchListingsRequest)

      This is a variant of searchListings(software.amazon.awssdk.services.marketplacediscovery.model.SearchListingsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.SearchListingsPublisher publisher = client.searchListingsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.SearchListingsPublisher publisher = client.searchListingsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.marketplacediscovery.model.SearchListingsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.marketplacediscovery.model.SearchListingsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 searchListings(software.amazon.awssdk.services.marketplacediscovery.model.SearchListingsRequest) operation.

      Parameters:
      searchListingsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • searchListingsPaginator

      default SearchListingsPublisher searchListingsPaginator(Consumer<SearchListingsRequest.Builder> searchListingsRequest)

      This is a variant of searchListings(software.amazon.awssdk.services.marketplacediscovery.model.SearchListingsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.SearchListingsPublisher publisher = client.searchListingsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.marketplacediscovery.paginators.SearchListingsPublisher publisher = client.searchListingsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.marketplacediscovery.model.SearchListingsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.marketplacediscovery.model.SearchListingsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      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 searchListings(software.amazon.awssdk.services.marketplacediscovery.model.SearchListingsRequest) operation.


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

      Parameters:
      searchListingsRequest - A Consumer that will call methods on SearchListingsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied due to request throttling.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by the service.
      • InternalServerException Unexpected error during processing of the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • MarketplaceDiscoveryException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • serviceClientConfiguration

      default MarketplaceDiscoveryServiceClientConfiguration 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

    • create

      static MarketplaceDiscoveryAsyncClient create()
      Create a MarketplaceDiscoveryAsyncClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.

    • builder

      static MarketplaceDiscoveryAsyncClientBuilder builder()
      Create a builder that can be used to configure and create a MarketplaceDiscoveryAsyncClient.