Interface BillingAsyncClient

All Superinterfaces:
AutoCloseable, AwsClient, SdkAutoCloseable, SdkClient
@Generated("software.amazon.awssdk:codegen") @SdkPublicApi @ThreadSafe public interface BillingAsyncClient extends AwsClient
Service client for accessing AWS Billing 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.

You can use the Billing API to programatically list the billing views available to you for a given time period. A billing view represents a set of billing data.

The Billing API provides the following endpoint:

https://billing.us-east-1.api.aws

  • Field Details

  • Method Details

    • associateSourceViews

      default CompletableFuture<AssociateSourceViewsResponse> associateSourceViews(AssociateSourceViewsRequest associateSourceViewsRequest)

      Associates one or more source billing views with an existing billing view. This allows creating aggregate billing views that combine data from multiple sources.

      Parameters:
      associateSourceViewsRequest -
      Returns:
      A Java Future containing the result of the AssociateSourceViews 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.
      • BillingViewHealthStatusException Exception thrown when a billing view's health status prevents an operation from being performed. This may occur if the billing view is in a state other than HEALTHY.
      • ServiceQuotaExceededException You've reached the limit of resources you can create, or exceeded the size of an individual resource.
      • ThrottlingException The request was denied due to request throttling.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ConflictException The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • associateSourceViews

      default CompletableFuture<AssociateSourceViewsResponse> associateSourceViews(Consumer<AssociateSourceViewsRequest.Builder> associateSourceViewsRequest)

      Associates one or more source billing views with an existing billing view. This allows creating aggregate billing views that combine data from multiple sources.


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

      Parameters:
      associateSourceViewsRequest - A Consumer that will call methods on AssociateSourceViewsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the AssociateSourceViews 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.
      • BillingViewHealthStatusException Exception thrown when a billing view's health status prevents an operation from being performed. This may occur if the billing view is in a state other than HEALTHY.
      • ServiceQuotaExceededException You've reached the limit of resources you can create, or exceeded the size of an individual resource.
      • ThrottlingException The request was denied due to request throttling.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ConflictException The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createBillingView

      default CompletableFuture<CreateBillingViewResponse> createBillingView(CreateBillingViewRequest createBillingViewRequest)

      Creates a billing view with the specified billing view attributes.

      Parameters:
      createBillingViewRequest -
      Returns:
      A Java Future containing the result of the CreateBillingView 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.
      • BillingViewHealthStatusException Exception thrown when a billing view's health status prevents an operation from being performed. This may occur if the billing view is in a state other than HEALTHY.
      • ServiceQuotaExceededException You've reached the limit of resources you can create, or exceeded the size of an individual resource.
      • ThrottlingException The request was denied due to request throttling.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ConflictException The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createBillingView

      default CompletableFuture<CreateBillingViewResponse> createBillingView(Consumer<CreateBillingViewRequest.Builder> createBillingViewRequest)

      Creates a billing view with the specified billing view attributes.


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

      Parameters:
      createBillingViewRequest - A Consumer that will call methods on CreateBillingViewRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreateBillingView 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.
      • BillingViewHealthStatusException Exception thrown when a billing view's health status prevents an operation from being performed. This may occur if the billing view is in a state other than HEALTHY.
      • ServiceQuotaExceededException You've reached the limit of resources you can create, or exceeded the size of an individual resource.
      • ThrottlingException The request was denied due to request throttling.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ConflictException The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteBillingView

      default CompletableFuture<DeleteBillingViewResponse> deleteBillingView(DeleteBillingViewRequest deleteBillingViewRequest)

      Deletes the specified billing view.

      Parameters:
      deleteBillingViewRequest -
      Returns:
      A Java Future containing the result of the DeleteBillingView 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.
      • ConflictException The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteBillingView

      default CompletableFuture<DeleteBillingViewResponse> deleteBillingView(Consumer<DeleteBillingViewRequest.Builder> deleteBillingViewRequest)

      Deletes the specified billing view.


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

      Parameters:
      deleteBillingViewRequest - A Consumer that will call methods on DeleteBillingViewRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteBillingView 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.
      • ConflictException The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • disassociateSourceViews

      default CompletableFuture<DisassociateSourceViewsResponse> disassociateSourceViews(DisassociateSourceViewsRequest disassociateSourceViewsRequest)

      Removes the association between one or more source billing views and an existing billing view. This allows modifying the composition of aggregate billing views.

      Parameters:
      disassociateSourceViewsRequest -
      Returns:
      A Java Future containing the result of the DisassociateSourceViews 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.
      • BillingViewHealthStatusException Exception thrown when a billing view's health status prevents an operation from being performed. This may occur if the billing view is in a state other than HEALTHY.
      • ThrottlingException The request was denied due to request throttling.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ConflictException The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • disassociateSourceViews

      default CompletableFuture<DisassociateSourceViewsResponse> disassociateSourceViews(Consumer<DisassociateSourceViewsRequest.Builder> disassociateSourceViewsRequest)

      Removes the association between one or more source billing views and an existing billing view. This allows modifying the composition of aggregate billing views.


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

      Parameters:
      disassociateSourceViewsRequest - A Consumer that will call methods on DisassociateSourceViewsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DisassociateSourceViews 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.
      • BillingViewHealthStatusException Exception thrown when a billing view's health status prevents an operation from being performed. This may occur if the billing view is in a state other than HEALTHY.
      • ThrottlingException The request was denied due to request throttling.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ConflictException The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getBillingPreferences

      default CompletableFuture<GetBillingPreferencesResponse> getBillingPreferences(GetBillingPreferencesRequest getBillingPreferencesRequest)

      Retrieves billing preferences for the specified feature. Each feature controls a distinct billing capability: which accounts can share Reserved Instances or credits, whether billing alerts are enabled, the historical record of sharing changes, and per-credit options.

      Parameters:
      getBillingPreferencesRequest -
      Returns:
      A Java Future containing the result of the GetBillingPreferences 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 an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getBillingPreferences

      default CompletableFuture<GetBillingPreferencesResponse> getBillingPreferences(Consumer<GetBillingPreferencesRequest.Builder> getBillingPreferencesRequest)

      Retrieves billing preferences for the specified feature. Each feature controls a distinct billing capability: which accounts can share Reserved Instances or credits, whether billing alerts are enabled, the historical record of sharing changes, and per-credit options.


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

      Parameters:
      getBillingPreferencesRequest - A Consumer that will call methods on GetBillingPreferencesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetBillingPreferences 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 an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getBillingView

      default CompletableFuture<GetBillingViewResponse> getBillingView(GetBillingViewRequest getBillingViewRequest)

      Returns the metadata associated to the specified billing view ARN.

      Parameters:
      getBillingViewRequest -
      Returns:
      A Java Future containing the result of the GetBillingView 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.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getBillingView

      default CompletableFuture<GetBillingViewResponse> getBillingView(Consumer<GetBillingViewRequest.Builder> getBillingViewRequest)

      Returns the metadata associated to the specified billing view ARN.


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

      Parameters:
      getBillingViewRequest - A Consumer that will call methods on GetBillingViewRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetBillingView 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.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getCreditAllocationHistory

      default CompletableFuture<GetCreditAllocationHistoryResponse> getCreditAllocationHistory(GetCreditAllocationHistoryRequest getCreditAllocationHistoryRequest)

      Returns the per-billing-month allocation history for credits applied to an Amazon Web Services account's bills. Traverses the consolidated billing family to capture cross-account credit applications. Supports pagination and optional filtering to a single credit.

      Parameters:
      getCreditAllocationHistoryRequest -
      Returns:
      A Java Future containing the result of the GetCreditAllocationHistory 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 an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getCreditAllocationHistory

      default CompletableFuture<GetCreditAllocationHistoryResponse> getCreditAllocationHistory(Consumer<GetCreditAllocationHistoryRequest.Builder> getCreditAllocationHistoryRequest)

      Returns the per-billing-month allocation history for credits applied to an Amazon Web Services account's bills. Traverses the consolidated billing family to capture cross-account credit applications. Supports pagination and optional filtering to a single credit.


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

      Parameters:
      getCreditAllocationHistoryRequest - A Consumer that will call methods on GetCreditAllocationHistoryRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetCreditAllocationHistory 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 an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getCreditAllocationHistoryPaginator

      default GetCreditAllocationHistoryPublisher getCreditAllocationHistoryPaginator(GetCreditAllocationHistoryRequest getCreditAllocationHistoryRequest)

      This is a variant of getCreditAllocationHistory(software.amazon.awssdk.services.billing.model.GetCreditAllocationHistoryRequest) 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.billing.paginators.GetCreditAllocationHistoryPublisher publisher = client.getCreditAllocationHistoryPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.billing.paginators.GetCreditAllocationHistoryPublisher publisher = client.getCreditAllocationHistoryPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.billing.model.GetCreditAllocationHistoryResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.billing.model.GetCreditAllocationHistoryResponse 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 getCreditAllocationHistory(software.amazon.awssdk.services.billing.model.GetCreditAllocationHistoryRequest) operation.

      Parameters:
      getCreditAllocationHistoryRequest -
      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 an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getCreditAllocationHistoryPaginator

      default GetCreditAllocationHistoryPublisher getCreditAllocationHistoryPaginator(Consumer<GetCreditAllocationHistoryRequest.Builder> getCreditAllocationHistoryRequest)

      This is a variant of getCreditAllocationHistory(software.amazon.awssdk.services.billing.model.GetCreditAllocationHistoryRequest) 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.billing.paginators.GetCreditAllocationHistoryPublisher publisher = client.getCreditAllocationHistoryPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.billing.paginators.GetCreditAllocationHistoryPublisher publisher = client.getCreditAllocationHistoryPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.billing.model.GetCreditAllocationHistoryResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.billing.model.GetCreditAllocationHistoryResponse 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 getCreditAllocationHistory(software.amazon.awssdk.services.billing.model.GetCreditAllocationHistoryRequest) operation.


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

      Parameters:
      getCreditAllocationHistoryRequest - A Consumer that will call methods on GetCreditAllocationHistoryRequest.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 an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getCredits

      default CompletableFuture<GetCreditsResponse> getCredits(GetCreditsRequest getCreditsRequest)

      Returns the list of Amazon Web Services account credits for the specified account. Each credit includes its identifier, type, monetary amounts, applicable products, expiration, sharing configuration, and current enabled status.

      When the caller is the management account of a consolidated billing family and payerAccountFlag is true, the response aggregates credits across the entire family. Otherwise, the response includes only credits owned by the account specified in accountId.

      Parameters:
      getCreditsRequest -
      Returns:
      A Java Future containing the result of the GetCredits 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 an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getCredits

      default CompletableFuture<GetCreditsResponse> getCredits(Consumer<GetCreditsRequest.Builder> getCreditsRequest)

      Returns the list of Amazon Web Services account credits for the specified account. Each credit includes its identifier, type, monetary amounts, applicable products, expiration, sharing configuration, and current enabled status.

      When the caller is the management account of a consolidated billing family and payerAccountFlag is true, the response aggregates credits across the entire family. Otherwise, the response includes only credits owned by the account specified in accountId.


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

      Parameters:
      getCreditsRequest - A Consumer that will call methods on GetCreditsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetCredits 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 an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourcePolicy

      default CompletableFuture<GetResourcePolicyResponse> getResourcePolicy(GetResourcePolicyRequest getResourcePolicyRequest)

      Returns the resource-based policy document attached to the resource in JSON format.

      Parameters:
      getResourcePolicyRequest -
      Returns:
      A Java Future containing the result of the GetResourcePolicy 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.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • getResourcePolicy

      default CompletableFuture<GetResourcePolicyResponse> getResourcePolicy(Consumer<GetResourcePolicyRequest.Builder> getResourcePolicyRequest)

      Returns the resource-based policy document attached to the resource in JSON format.


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

      Parameters:
      getResourcePolicyRequest - A Consumer that will call methods on GetResourcePolicyRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the GetResourcePolicy 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.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listBillingViews

      default CompletableFuture<ListBillingViewsResponse> listBillingViews(ListBillingViewsRequest listBillingViewsRequest)

      Lists the billing views available for a given time period.

      Every Amazon Web Services account has a unique PRIMARY billing view that represents the billing data available by default. Accounts that use Billing Conductor also have BILLING_GROUP billing views representing pro forma costs associated with each created billing group.

      Parameters:
      listBillingViewsRequest -
      Returns:
      A Java Future containing the result of the ListBillingViews 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 an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listBillingViews

      default CompletableFuture<ListBillingViewsResponse> listBillingViews(Consumer<ListBillingViewsRequest.Builder> listBillingViewsRequest)

      Lists the billing views available for a given time period.

      Every Amazon Web Services account has a unique PRIMARY billing view that represents the billing data available by default. Accounts that use Billing Conductor also have BILLING_GROUP billing views representing pro forma costs associated with each created billing group.


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

      Parameters:
      listBillingViewsRequest - A Consumer that will call methods on ListBillingViewsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListBillingViews 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 an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listBillingViewsPaginator

      default ListBillingViewsPublisher listBillingViewsPaginator(ListBillingViewsRequest listBillingViewsRequest)

      This is a variant of listBillingViews(software.amazon.awssdk.services.billing.model.ListBillingViewsRequest) 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.billing.paginators.ListBillingViewsPublisher publisher = client.listBillingViewsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.billing.paginators.ListBillingViewsPublisher publisher = client.listBillingViewsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.billing.model.ListBillingViewsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.billing.model.ListBillingViewsResponse 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 listBillingViews(software.amazon.awssdk.services.billing.model.ListBillingViewsRequest) operation.

      Parameters:
      listBillingViewsRequest -
      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 an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listBillingViewsPaginator

      default ListBillingViewsPublisher listBillingViewsPaginator(Consumer<ListBillingViewsRequest.Builder> listBillingViewsRequest)

      This is a variant of listBillingViews(software.amazon.awssdk.services.billing.model.ListBillingViewsRequest) 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.billing.paginators.ListBillingViewsPublisher publisher = client.listBillingViewsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.billing.paginators.ListBillingViewsPublisher publisher = client.listBillingViewsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.billing.model.ListBillingViewsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.billing.model.ListBillingViewsResponse 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 listBillingViews(software.amazon.awssdk.services.billing.model.ListBillingViewsRequest) operation.


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

      Parameters:
      listBillingViewsRequest - A Consumer that will call methods on ListBillingViewsRequest.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 an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listSourceViewsForBillingView

      default CompletableFuture<ListSourceViewsForBillingViewResponse> listSourceViewsForBillingView(ListSourceViewsForBillingViewRequest listSourceViewsForBillingViewRequest)

      Lists the source views (managed Amazon Web Services billing views) associated with the billing view.

      Parameters:
      listSourceViewsForBillingViewRequest -
      Returns:
      A Java Future containing the result of the ListSourceViewsForBillingView 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.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listSourceViewsForBillingView

      default CompletableFuture<ListSourceViewsForBillingViewResponse> listSourceViewsForBillingView(Consumer<ListSourceViewsForBillingViewRequest.Builder> listSourceViewsForBillingViewRequest)

      Lists the source views (managed Amazon Web Services billing views) associated with the billing view.


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

      Parameters:
      listSourceViewsForBillingViewRequest - A Consumer that will call methods on ListSourceViewsForBillingViewRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListSourceViewsForBillingView 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.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listSourceViewsForBillingViewPaginator

      default ListSourceViewsForBillingViewPublisher listSourceViewsForBillingViewPaginator(ListSourceViewsForBillingViewRequest listSourceViewsForBillingViewRequest)

      This is a variant of listSourceViewsForBillingView(software.amazon.awssdk.services.billing.model.ListSourceViewsForBillingViewRequest) 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.billing.paginators.ListSourceViewsForBillingViewPublisher publisher = client.listSourceViewsForBillingViewPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.billing.paginators.ListSourceViewsForBillingViewPublisher publisher = client.listSourceViewsForBillingViewPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.billing.model.ListSourceViewsForBillingViewResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.billing.model.ListSourceViewsForBillingViewResponse 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 listSourceViewsForBillingView(software.amazon.awssdk.services.billing.model.ListSourceViewsForBillingViewRequest) operation.

      Parameters:
      listSourceViewsForBillingViewRequest -
      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.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listSourceViewsForBillingViewPaginator

      default ListSourceViewsForBillingViewPublisher listSourceViewsForBillingViewPaginator(Consumer<ListSourceViewsForBillingViewRequest.Builder> listSourceViewsForBillingViewRequest)

      This is a variant of listSourceViewsForBillingView(software.amazon.awssdk.services.billing.model.ListSourceViewsForBillingViewRequest) 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.billing.paginators.ListSourceViewsForBillingViewPublisher publisher = client.listSourceViewsForBillingViewPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.billing.paginators.ListSourceViewsForBillingViewPublisher publisher = client.listSourceViewsForBillingViewPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.billing.model.ListSourceViewsForBillingViewResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.billing.model.ListSourceViewsForBillingViewResponse 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 listSourceViewsForBillingView(software.amazon.awssdk.services.billing.model.ListSourceViewsForBillingViewRequest) operation.


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

      Parameters:
      listSourceViewsForBillingViewRequest - A Consumer that will call methods on ListSourceViewsForBillingViewRequest.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.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTagsForResource

      default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)

      Lists tags associated with the billing view resource.

      Parameters:
      listTagsForResourceRequest -
      Returns:
      A Java Future containing the result of the ListTagsForResource 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.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTagsForResource

      default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest)

      Lists tags associated with the billing view 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:
      A Java Future containing the result of the ListTagsForResource 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.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • redeemCredits

      default CompletableFuture<RedeemCreditsResponse> redeemCredits(RedeemCreditsRequest redeemCreditsRequest)

      Redeems an Amazon Web Services promotional credit code on behalf of the calling account. On success, a new credit is added to the account's credit ledger with the amount, validity period, and applicable products defined by the promotion. The credit is then automatically applied to subsequent bills according to the standard credit application order.

      Parameters:
      redeemCreditsRequest -
      Returns:
      A Java Future containing the result of the RedeemCredits 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 an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • redeemCredits

      default CompletableFuture<RedeemCreditsResponse> redeemCredits(Consumer<RedeemCreditsRequest.Builder> redeemCreditsRequest)

      Redeems an Amazon Web Services promotional credit code on behalf of the calling account. On success, a new credit is added to the account's credit ledger with the amount, validity period, and applicable products defined by the promotion. The credit is then automatically applied to subsequent bills according to the standard credit application order.


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

      Parameters:
      redeemCreditsRequest - A Consumer that will call methods on RedeemCreditsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the RedeemCredits 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 an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • tagResource

      default CompletableFuture<TagResourceResponse> tagResource(TagResourceRequest tagResourceRequest)

      An API operation for adding one or more tags (key-value pairs) to a resource.

      Parameters:
      tagResourceRequest -
      Returns:
      A Java Future containing the result of the TagResource 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.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • tagResource

      default CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest)

      An API operation for adding one or more tags (key-value pairs) to a 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:
      A Java Future containing the result of the TagResource 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.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • untagResource

      default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest)

      Removes one or more tags from a resource. Specify only tag keys in your request. Don't specify the value.

      Parameters:
      untagResourceRequest -
      Returns:
      A Java Future containing the result of the UntagResource 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.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • untagResource

      default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest)

      Removes one or more tags from a resource. Specify only tag keys in your request. Don't specify the value.


      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:
      A Java Future containing the result of the UntagResource 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.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateBillingPreferences

      default CompletableFuture<UpdateBillingPreferencesResponse> updateBillingPreferences(UpdateBillingPreferencesRequest updateBillingPreferencesRequest)

      Updates billing preferences for the specified feature. Each feature targets a distinct billing capability and has its own set of supported keys. The action sets the value for each provided key; keys not present in the request are unchanged.

      Sharing keys (RI_SHARING, CREDIT_SHARING, CREDIT_LEVEL_SHARING, and sharing keys under CREDIT_PREFERENCE_OPTIONS) may only be set by the management account of a consolidated billing family. The credit/{creditId}/status key may be set by member accounts for credits they own, or by the management account for any credit in the family.

      Parameters:
      updateBillingPreferencesRequest -
      Returns:
      A Java Future containing the result of the UpdateBillingPreferences 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 an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateBillingPreferences

      default CompletableFuture<UpdateBillingPreferencesResponse> updateBillingPreferences(Consumer<UpdateBillingPreferencesRequest.Builder> updateBillingPreferencesRequest)

      Updates billing preferences for the specified feature. Each feature targets a distinct billing capability and has its own set of supported keys. The action sets the value for each provided key; keys not present in the request are unchanged.

      Sharing keys (RI_SHARING, CREDIT_SHARING, CREDIT_LEVEL_SHARING, and sharing keys under CREDIT_PREFERENCE_OPTIONS) may only be set by the management account of a consolidated billing family. The credit/{creditId}/status key may be set by member accounts for credits they own, or by the management account for any credit in the family.


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

      Parameters:
      updateBillingPreferencesRequest - A Consumer that will call methods on UpdateBillingPreferencesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdateBillingPreferences 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 an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateBillingView

      default CompletableFuture<UpdateBillingViewResponse> updateBillingView(UpdateBillingViewRequest updateBillingViewRequest)

      An API to update the attributes of the billing view.

      Parameters:
      updateBillingViewRequest -
      Returns:
      A Java Future containing the result of the UpdateBillingView 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.
      • BillingViewHealthStatusException Exception thrown when a billing view's health status prevents an operation from being performed. This may occur if the billing view is in a state other than HEALTHY.
      • ServiceQuotaExceededException You've reached the limit of resources you can create, or exceeded the size of an individual resource.
      • ThrottlingException The request was denied due to request throttling.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ConflictException The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateBillingView

      default CompletableFuture<UpdateBillingViewResponse> updateBillingView(Consumer<UpdateBillingViewRequest.Builder> updateBillingViewRequest)

      An API to update the attributes of the billing view.


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

      Parameters:
      updateBillingViewRequest - A Consumer that will call methods on UpdateBillingViewRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdateBillingView 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.
      • BillingViewHealthStatusException Exception thrown when a billing view's health status prevents an operation from being performed. This may occur if the billing view is in a state other than HEALTHY.
      • ServiceQuotaExceededException You've reached the limit of resources you can create, or exceeded the size of an individual resource.
      • ThrottlingException The request was denied due to request throttling.
      • ResourceNotFoundException The specified ARN in the request doesn't exist.
      • AccessDeniedException You don't have sufficient access to perform this action.
      • ConflictException The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.
      • ValidationException The input fails to satisfy the constraints specified by an Amazon Web Services service.
      • InternalServerException The request processing failed because of an unknown error, exception, or failure.
      • 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.
      • BillingException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • serviceClientConfiguration

      default BillingServiceClientConfiguration 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 BillingAsyncClient create()
      Create a BillingAsyncClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.

    • builder

      static BillingAsyncClientBuilder builder()
      Create a builder that can be used to configure and create a BillingAsyncClient.