Interface BudgetsAsyncClient

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

Use the Amazon Web Services Budgets API to plan your service usage, service costs, and instance reservations. This API reference provides descriptions, syntax, and usage examples for each of the actions and data types for the Amazon Web Services Budgets feature.

Budgets provide you with a way to see the following information:

  • How close your plan is to your budgeted amount or to the free tier limits

  • Your usage-to-date, including how much you've used of your Reserved Instances (RIs)

  • Your current estimated charges from Amazon Web Services, and how much your predicted usage will accrue in charges by the end of the month

  • How much of your budget has been used

Amazon Web Services updates your budget status several times a day. Budgets track your unblended costs, subscriptions, refunds, and RIs. You can create the following types of budgets:

  • Cost budgets - Plan how much you want to spend on a service.

  • Usage budgets - Plan how much you want to use one or more services.

  • RI utilization budgets - Define a utilization threshold, and receive alerts when your RI usage falls below that threshold. This lets you see if your RIs are unused or under-utilized.

  • RI coverage budgets - Define a coverage threshold, and receive alerts when the number of your instance hours that are covered by RIs fall below that threshold. This lets you see how much of your instance usage is covered by a reservation.

Service Endpoint

The Amazon Web Services Budgets API provides the following endpoint:

  • https://budgets.amazonaws.com

For information about costs that are associated with the Amazon Web Services Budgets API, see Amazon Web Services Cost Management Pricing.

  • Field Details

  • Method Details

    • createBudget

      default CompletableFuture<CreateBudgetResponse> createBudget(CreateBudgetRequest createBudgetRequest)

      Creates a budget and, if included, notifications and subscribers.

      Only one of BudgetLimit or PlannedBudgetLimits can be present in the syntax at one time. Use the syntax that matches your use case. The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see the Examples section.

      Similarly, only one set of filter and metric selections can be present in the syntax at one time. Either FilterExpression and Metrics or CostFilters and CostTypes, not both or a different combination. We recommend using FilterExpression and Metrics as they provide more flexible and powerful filtering capabilities. The Request Syntax section shows the FilterExpression/Metrics syntax.

      Parameters:
      createBudgetRequest - Request of CreateBudget
      Returns:
      A Java Future containing the result of the CreateBudget 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.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • CreationLimitExceededException You've exceeded the notification or subscriber limit.
      • DuplicateRecordException The budget name already exists. Budget names must be unique within an account.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • ServiceQuotaExceededException You've reached the limit on the number of tags you can associate with a resource.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • createBudget

      default CompletableFuture<CreateBudgetResponse> createBudget(Consumer<CreateBudgetRequest.Builder> createBudgetRequest)

      Creates a budget and, if included, notifications and subscribers.

      Only one of BudgetLimit or PlannedBudgetLimits can be present in the syntax at one time. Use the syntax that matches your use case. The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see the Examples section.

      Similarly, only one set of filter and metric selections can be present in the syntax at one time. Either FilterExpression and Metrics or CostFilters and CostTypes, not both or a different combination. We recommend using FilterExpression and Metrics as they provide more flexible and powerful filtering capabilities. The Request Syntax section shows the FilterExpression/Metrics syntax.


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

      Parameters:
      createBudgetRequest - A Consumer that will call methods on CreateBudgetRequest.Builder to create a request. Request of CreateBudget
      Returns:
      A Java Future containing the result of the CreateBudget 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.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • CreationLimitExceededException You've exceeded the notification or subscriber limit.
      • DuplicateRecordException The budget name already exists. Budget names must be unique within an account.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • ServiceQuotaExceededException You've reached the limit on the number of tags you can associate with a resource.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • createBudgetAction

      default CompletableFuture<CreateBudgetActionResponse> createBudgetAction(CreateBudgetActionRequest createBudgetActionRequest)

      Creates a budget action.

      Parameters:
      createBudgetActionRequest -
      Returns:
      A Java Future containing the result of the CreateBudgetAction 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.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • CreationLimitExceededException You've exceeded the notification or subscriber limit.
      • DuplicateRecordException The budget name already exists. Budget names must be unique within an account.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • ServiceQuotaExceededException You've reached the limit on the number of tags you can associate with a resource.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • createBudgetAction

      default CompletableFuture<CreateBudgetActionResponse> createBudgetAction(Consumer<CreateBudgetActionRequest.Builder> createBudgetActionRequest)

      Creates a budget action.


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

      Parameters:
      createBudgetActionRequest - A Consumer that will call methods on CreateBudgetActionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreateBudgetAction 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.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • CreationLimitExceededException You've exceeded the notification or subscriber limit.
      • DuplicateRecordException The budget name already exists. Budget names must be unique within an account.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • ServiceQuotaExceededException You've reached the limit on the number of tags you can associate with a resource.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • createNotification

      default CompletableFuture<CreateNotificationResponse> createNotification(CreateNotificationRequest createNotificationRequest)

      Creates a notification. You must create the budget before you create the associated notification.

      Parameters:
      createNotificationRequest - Request of CreateNotification
      Returns:
      A Java Future containing the result of the CreateNotification 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • CreationLimitExceededException You've exceeded the notification or subscriber limit.
      • DuplicateRecordException The budget name already exists. Budget names must be unique within an account.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • createNotification

      default CompletableFuture<CreateNotificationResponse> createNotification(Consumer<CreateNotificationRequest.Builder> createNotificationRequest)

      Creates a notification. You must create the budget before you create the associated notification.


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

      Parameters:
      createNotificationRequest - A Consumer that will call methods on CreateNotificationRequest.Builder to create a request. Request of CreateNotification
      Returns:
      A Java Future containing the result of the CreateNotification 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • CreationLimitExceededException You've exceeded the notification or subscriber limit.
      • DuplicateRecordException The budget name already exists. Budget names must be unique within an account.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • createSubscriber

      default CompletableFuture<CreateSubscriberResponse> createSubscriber(CreateSubscriberRequest createSubscriberRequest)

      Creates a subscriber. You must create the associated budget and notification before you create the subscriber.

      Parameters:
      createSubscriberRequest - Request of CreateSubscriber
      Returns:
      A Java Future containing the result of the CreateSubscriber 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • CreationLimitExceededException You've exceeded the notification or subscriber limit.
      • DuplicateRecordException The budget name already exists. Budget names must be unique within an account.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • createSubscriber

      default CompletableFuture<CreateSubscriberResponse> createSubscriber(Consumer<CreateSubscriberRequest.Builder> createSubscriberRequest)

      Creates a subscriber. You must create the associated budget and notification before you create the subscriber.


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

      Parameters:
      createSubscriberRequest - A Consumer that will call methods on CreateSubscriberRequest.Builder to create a request. Request of CreateSubscriber
      Returns:
      A Java Future containing the result of the CreateSubscriber 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • CreationLimitExceededException You've exceeded the notification or subscriber limit.
      • DuplicateRecordException The budget name already exists. Budget names must be unique within an account.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • deleteBudget

      default CompletableFuture<DeleteBudgetResponse> deleteBudget(DeleteBudgetRequest deleteBudgetRequest)

      Deletes a budget. You can delete your budget at any time.

      Deleting a budget also deletes the notifications and subscribers that are associated with that budget.

      Parameters:
      deleteBudgetRequest - Request of DeleteBudget
      Returns:
      A Java Future containing the result of the DeleteBudget 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • deleteBudget

      default CompletableFuture<DeleteBudgetResponse> deleteBudget(Consumer<DeleteBudgetRequest.Builder> deleteBudgetRequest)

      Deletes a budget. You can delete your budget at any time.

      Deleting a budget also deletes the notifications and subscribers that are associated with that budget.


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

      Parameters:
      deleteBudgetRequest - A Consumer that will call methods on DeleteBudgetRequest.Builder to create a request. Request of DeleteBudget
      Returns:
      A Java Future containing the result of the DeleteBudget 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • deleteBudgetAction

      default CompletableFuture<DeleteBudgetActionResponse> deleteBudgetAction(DeleteBudgetActionRequest deleteBudgetActionRequest)

      Deletes a budget action.

      Parameters:
      deleteBudgetActionRequest -
      Returns:
      A Java Future containing the result of the DeleteBudgetAction 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ResourceLockedException The request was received and recognized by the server, but the server rejected that particular method for the requested resource.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • deleteBudgetAction

      default CompletableFuture<DeleteBudgetActionResponse> deleteBudgetAction(Consumer<DeleteBudgetActionRequest.Builder> deleteBudgetActionRequest)

      Deletes a budget action.


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

      Parameters:
      deleteBudgetActionRequest - A Consumer that will call methods on DeleteBudgetActionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteBudgetAction 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ResourceLockedException The request was received and recognized by the server, but the server rejected that particular method for the requested resource.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • deleteNotification

      default CompletableFuture<DeleteNotificationResponse> deleteNotification(DeleteNotificationRequest deleteNotificationRequest)

      Deletes a notification.

      Deleting a notification also deletes the subscribers that are associated with the notification.

      Parameters:
      deleteNotificationRequest - Request of DeleteNotification
      Returns:
      A Java Future containing the result of the DeleteNotification 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.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • deleteNotification

      default CompletableFuture<DeleteNotificationResponse> deleteNotification(Consumer<DeleteNotificationRequest.Builder> deleteNotificationRequest)

      Deletes a notification.

      Deleting a notification also deletes the subscribers that are associated with the notification.


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

      Parameters:
      deleteNotificationRequest - A Consumer that will call methods on DeleteNotificationRequest.Builder to create a request. Request of DeleteNotification
      Returns:
      A Java Future containing the result of the DeleteNotification 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.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • deleteSubscriber

      default CompletableFuture<DeleteSubscriberResponse> deleteSubscriber(DeleteSubscriberRequest deleteSubscriberRequest)

      Deletes a subscriber.

      Deleting the last subscriber to a notification also deletes the notification.

      Parameters:
      deleteSubscriberRequest - Request of DeleteSubscriber
      Returns:
      A Java Future containing the result of the DeleteSubscriber 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • deleteSubscriber

      default CompletableFuture<DeleteSubscriberResponse> deleteSubscriber(Consumer<DeleteSubscriberRequest.Builder> deleteSubscriberRequest)

      Deletes a subscriber.

      Deleting the last subscriber to a notification also deletes the notification.


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

      Parameters:
      deleteSubscriberRequest - A Consumer that will call methods on DeleteSubscriberRequest.Builder to create a request. Request of DeleteSubscriber
      Returns:
      A Java Future containing the result of the DeleteSubscriber 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudget

      default CompletableFuture<DescribeBudgetResponse> describeBudget(DescribeBudgetRequest describeBudgetRequest)

      Describes a budget.

      The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see the Examples section.

      Parameters:
      describeBudgetRequest - Request of DescribeBudget
      Returns:
      A Java Future containing the result of the DescribeBudget 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudget

      default CompletableFuture<DescribeBudgetResponse> describeBudget(Consumer<DescribeBudgetRequest.Builder> describeBudgetRequest)

      Describes a budget.

      The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see the Examples section.


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

      Parameters:
      describeBudgetRequest - A Consumer that will call methods on DescribeBudgetRequest.Builder to create a request. Request of DescribeBudget
      Returns:
      A Java Future containing the result of the DescribeBudget 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetAction

      default CompletableFuture<DescribeBudgetActionResponse> describeBudgetAction(DescribeBudgetActionRequest describeBudgetActionRequest)

      Describes a budget action detail.

      Parameters:
      describeBudgetActionRequest -
      Returns:
      A Java Future containing the result of the DescribeBudgetAction 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetAction

      default CompletableFuture<DescribeBudgetActionResponse> describeBudgetAction(Consumer<DescribeBudgetActionRequest.Builder> describeBudgetActionRequest)

      Describes a budget action detail.


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

      Parameters:
      describeBudgetActionRequest - A Consumer that will call methods on DescribeBudgetActionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DescribeBudgetAction 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetActionHistories

      default CompletableFuture<DescribeBudgetActionHistoriesResponse> describeBudgetActionHistories(DescribeBudgetActionHistoriesRequest describeBudgetActionHistoriesRequest)

      Describes a budget action history detail.

      Parameters:
      describeBudgetActionHistoriesRequest -
      Returns:
      A Java Future containing the result of the DescribeBudgetActionHistories 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • InvalidNextTokenException The pagination token is invalid.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetActionHistories

      default CompletableFuture<DescribeBudgetActionHistoriesResponse> describeBudgetActionHistories(Consumer<DescribeBudgetActionHistoriesRequest.Builder> describeBudgetActionHistoriesRequest)

      Describes a budget action history detail.


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

      Parameters:
      describeBudgetActionHistoriesRequest - A Consumer that will call methods on DescribeBudgetActionHistoriesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DescribeBudgetActionHistories 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • InvalidNextTokenException The pagination token is invalid.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetActionHistoriesPaginator

      default DescribeBudgetActionHistoriesPublisher describeBudgetActionHistoriesPaginator(DescribeBudgetActionHistoriesRequest describeBudgetActionHistoriesRequest)

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

      Parameters:
      describeBudgetActionHistoriesRequest -
      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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • InvalidNextTokenException The pagination token is invalid.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetActionHistoriesPaginator

      default DescribeBudgetActionHistoriesPublisher describeBudgetActionHistoriesPaginator(Consumer<DescribeBudgetActionHistoriesRequest.Builder> describeBudgetActionHistoriesRequest)

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


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

      Parameters:
      describeBudgetActionHistoriesRequest - A Consumer that will call methods on DescribeBudgetActionHistoriesRequest.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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • InvalidNextTokenException The pagination token is invalid.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetActionsForAccount

      default CompletableFuture<DescribeBudgetActionsForAccountResponse> describeBudgetActionsForAccount(DescribeBudgetActionsForAccountRequest describeBudgetActionsForAccountRequest)

      Describes all of the budget actions for an account.

      Parameters:
      describeBudgetActionsForAccountRequest -
      Returns:
      A Java Future containing the result of the DescribeBudgetActionsForAccount 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • InvalidNextTokenException The pagination token is invalid.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetActionsForAccount

      default CompletableFuture<DescribeBudgetActionsForAccountResponse> describeBudgetActionsForAccount(Consumer<DescribeBudgetActionsForAccountRequest.Builder> describeBudgetActionsForAccountRequest)

      Describes all of the budget actions for an account.


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

      Parameters:
      describeBudgetActionsForAccountRequest - A Consumer that will call methods on DescribeBudgetActionsForAccountRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DescribeBudgetActionsForAccount 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • InvalidNextTokenException The pagination token is invalid.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetActionsForAccountPaginator

      default DescribeBudgetActionsForAccountPublisher describeBudgetActionsForAccountPaginator(DescribeBudgetActionsForAccountRequest describeBudgetActionsForAccountRequest)

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

      Parameters:
      describeBudgetActionsForAccountRequest -
      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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • InvalidNextTokenException The pagination token is invalid.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetActionsForAccountPaginator

      default DescribeBudgetActionsForAccountPublisher describeBudgetActionsForAccountPaginator(Consumer<DescribeBudgetActionsForAccountRequest.Builder> describeBudgetActionsForAccountRequest)

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


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

      Parameters:
      describeBudgetActionsForAccountRequest - A Consumer that will call methods on DescribeBudgetActionsForAccountRequest.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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • InvalidNextTokenException The pagination token is invalid.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetActionsForBudget

      default CompletableFuture<DescribeBudgetActionsForBudgetResponse> describeBudgetActionsForBudget(DescribeBudgetActionsForBudgetRequest describeBudgetActionsForBudgetRequest)

      Describes all of the budget actions for a budget.

      Parameters:
      describeBudgetActionsForBudgetRequest -
      Returns:
      A Java Future containing the result of the DescribeBudgetActionsForBudget 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • InvalidNextTokenException The pagination token is invalid.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetActionsForBudget

      default CompletableFuture<DescribeBudgetActionsForBudgetResponse> describeBudgetActionsForBudget(Consumer<DescribeBudgetActionsForBudgetRequest.Builder> describeBudgetActionsForBudgetRequest)

      Describes all of the budget actions for a budget.


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

      Parameters:
      describeBudgetActionsForBudgetRequest - A Consumer that will call methods on DescribeBudgetActionsForBudgetRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DescribeBudgetActionsForBudget 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • InvalidNextTokenException The pagination token is invalid.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetActionsForBudgetPaginator

      default DescribeBudgetActionsForBudgetPublisher describeBudgetActionsForBudgetPaginator(DescribeBudgetActionsForBudgetRequest describeBudgetActionsForBudgetRequest)

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

      Parameters:
      describeBudgetActionsForBudgetRequest -
      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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • InvalidNextTokenException The pagination token is invalid.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetActionsForBudgetPaginator

      default DescribeBudgetActionsForBudgetPublisher describeBudgetActionsForBudgetPaginator(Consumer<DescribeBudgetActionsForBudgetRequest.Builder> describeBudgetActionsForBudgetRequest)

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


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

      Parameters:
      describeBudgetActionsForBudgetRequest - A Consumer that will call methods on DescribeBudgetActionsForBudgetRequest.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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • InvalidNextTokenException The pagination token is invalid.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetNotificationsForAccount

      default CompletableFuture<DescribeBudgetNotificationsForAccountResponse> describeBudgetNotificationsForAccount(DescribeBudgetNotificationsForAccountRequest describeBudgetNotificationsForAccountRequest)

      Lists the budget names and notifications that are associated with an account.

      Parameters:
      describeBudgetNotificationsForAccountRequest -
      Returns:
      A Java Future containing the result of the DescribeBudgetNotificationsForAccount 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetNotificationsForAccount

      default CompletableFuture<DescribeBudgetNotificationsForAccountResponse> describeBudgetNotificationsForAccount(Consumer<DescribeBudgetNotificationsForAccountRequest.Builder> describeBudgetNotificationsForAccountRequest)

      Lists the budget names and notifications that are associated with an account.


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

      Parameters:
      describeBudgetNotificationsForAccountRequest - A Consumer that will call methods on DescribeBudgetNotificationsForAccountRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DescribeBudgetNotificationsForAccount 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetNotificationsForAccountPaginator

      default DescribeBudgetNotificationsForAccountPublisher describeBudgetNotificationsForAccountPaginator(DescribeBudgetNotificationsForAccountRequest describeBudgetNotificationsForAccountRequest)

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

      Parameters:
      describeBudgetNotificationsForAccountRequest -
      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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetNotificationsForAccountPaginator

      default DescribeBudgetNotificationsForAccountPublisher describeBudgetNotificationsForAccountPaginator(Consumer<DescribeBudgetNotificationsForAccountRequest.Builder> describeBudgetNotificationsForAccountRequest)

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


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

      Parameters:
      describeBudgetNotificationsForAccountRequest - A Consumer that will call methods on DescribeBudgetNotificationsForAccountRequest.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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetPerformanceHistory

      default CompletableFuture<DescribeBudgetPerformanceHistoryResponse> describeBudgetPerformanceHistory(DescribeBudgetPerformanceHistoryRequest describeBudgetPerformanceHistoryRequest)

      Describes the history for DAILY, MONTHLY, and QUARTERLY budgets. Budget history isn't available for ANNUAL budgets.

      Parameters:
      describeBudgetPerformanceHistoryRequest -
      Returns:
      A Java Future containing the result of the DescribeBudgetPerformanceHistory 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetPerformanceHistory

      default CompletableFuture<DescribeBudgetPerformanceHistoryResponse> describeBudgetPerformanceHistory(Consumer<DescribeBudgetPerformanceHistoryRequest.Builder> describeBudgetPerformanceHistoryRequest)

      Describes the history for DAILY, MONTHLY, and QUARTERLY budgets. Budget history isn't available for ANNUAL budgets.


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

      Parameters:
      describeBudgetPerformanceHistoryRequest - A Consumer that will call methods on DescribeBudgetPerformanceHistoryRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DescribeBudgetPerformanceHistory 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetPerformanceHistoryPaginator

      default DescribeBudgetPerformanceHistoryPublisher describeBudgetPerformanceHistoryPaginator(DescribeBudgetPerformanceHistoryRequest describeBudgetPerformanceHistoryRequest)

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

      Parameters:
      describeBudgetPerformanceHistoryRequest -
      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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetPerformanceHistoryPaginator

      default DescribeBudgetPerformanceHistoryPublisher describeBudgetPerformanceHistoryPaginator(Consumer<DescribeBudgetPerformanceHistoryRequest.Builder> describeBudgetPerformanceHistoryRequest)

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


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

      Parameters:
      describeBudgetPerformanceHistoryRequest - A Consumer that will call methods on DescribeBudgetPerformanceHistoryRequest.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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgets

      default CompletableFuture<DescribeBudgetsResponse> describeBudgets(DescribeBudgetsRequest describeBudgetsRequest)

      Lists the budgets that are associated with an account.

      The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see the Examples section.

      Parameters:
      describeBudgetsRequest - Request of DescribeBudgets
      Returns:
      A Java Future containing the result of the DescribeBudgets 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgets

      default CompletableFuture<DescribeBudgetsResponse> describeBudgets(Consumer<DescribeBudgetsRequest.Builder> describeBudgetsRequest)

      Lists the budgets that are associated with an account.

      The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see the Examples section.


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

      Parameters:
      describeBudgetsRequest - A Consumer that will call methods on DescribeBudgetsRequest.Builder to create a request. Request of DescribeBudgets
      Returns:
      A Java Future containing the result of the DescribeBudgets 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetsPaginator

      default DescribeBudgetsPublisher describeBudgetsPaginator(DescribeBudgetsRequest describeBudgetsRequest)

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

      Parameters:
      describeBudgetsRequest - Request of DescribeBudgets
      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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeBudgetsPaginator

      default DescribeBudgetsPublisher describeBudgetsPaginator(Consumer<DescribeBudgetsRequest.Builder> describeBudgetsRequest)

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


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

      Parameters:
      describeBudgetsRequest - A Consumer that will call methods on DescribeBudgetsRequest.Builder to create a request. Request of DescribeBudgets
      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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeNotificationsForBudget

      default CompletableFuture<DescribeNotificationsForBudgetResponse> describeNotificationsForBudget(DescribeNotificationsForBudgetRequest describeNotificationsForBudgetRequest)

      Lists the notifications that are associated with a budget.

      Parameters:
      describeNotificationsForBudgetRequest - Request of DescribeNotificationsForBudget
      Returns:
      A Java Future containing the result of the DescribeNotificationsForBudget 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeNotificationsForBudget

      default CompletableFuture<DescribeNotificationsForBudgetResponse> describeNotificationsForBudget(Consumer<DescribeNotificationsForBudgetRequest.Builder> describeNotificationsForBudgetRequest)

      Lists the notifications that are associated with a budget.


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

      Parameters:
      describeNotificationsForBudgetRequest - A Consumer that will call methods on DescribeNotificationsForBudgetRequest.Builder to create a request. Request of DescribeNotificationsForBudget
      Returns:
      A Java Future containing the result of the DescribeNotificationsForBudget 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeNotificationsForBudgetPaginator

      default DescribeNotificationsForBudgetPublisher describeNotificationsForBudgetPaginator(DescribeNotificationsForBudgetRequest describeNotificationsForBudgetRequest)

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

      Parameters:
      describeNotificationsForBudgetRequest - Request of DescribeNotificationsForBudget
      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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeNotificationsForBudgetPaginator

      default DescribeNotificationsForBudgetPublisher describeNotificationsForBudgetPaginator(Consumer<DescribeNotificationsForBudgetRequest.Builder> describeNotificationsForBudgetRequest)

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


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

      Parameters:
      describeNotificationsForBudgetRequest - A Consumer that will call methods on DescribeNotificationsForBudgetRequest.Builder to create a request. Request of DescribeNotificationsForBudget
      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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeSubscribersForNotification

      default CompletableFuture<DescribeSubscribersForNotificationResponse> describeSubscribersForNotification(DescribeSubscribersForNotificationRequest describeSubscribersForNotificationRequest)

      Lists the subscribers that are associated with a notification.

      Parameters:
      describeSubscribersForNotificationRequest - Request of DescribeSubscribersForNotification
      Returns:
      A Java Future containing the result of the DescribeSubscribersForNotification 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeSubscribersForNotification

      default CompletableFuture<DescribeSubscribersForNotificationResponse> describeSubscribersForNotification(Consumer<DescribeSubscribersForNotificationRequest.Builder> describeSubscribersForNotificationRequest)

      Lists the subscribers that are associated with a notification.


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

      Parameters:
      describeSubscribersForNotificationRequest - A Consumer that will call methods on DescribeSubscribersForNotificationRequest.Builder to create a request. Request of DescribeSubscribersForNotification
      Returns:
      A Java Future containing the result of the DescribeSubscribersForNotification 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeSubscribersForNotificationPaginator

      default DescribeSubscribersForNotificationPublisher describeSubscribersForNotificationPaginator(DescribeSubscribersForNotificationRequest describeSubscribersForNotificationRequest)

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

      Parameters:
      describeSubscribersForNotificationRequest - Request of DescribeSubscribersForNotification
      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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • describeSubscribersForNotificationPaginator

      default DescribeSubscribersForNotificationPublisher describeSubscribersForNotificationPaginator(Consumer<DescribeSubscribersForNotificationRequest.Builder> describeSubscribersForNotificationRequest)

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


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

      Parameters:
      describeSubscribersForNotificationRequest - A Consumer that will call methods on DescribeSubscribersForNotificationRequest.Builder to create a request. Request of DescribeSubscribersForNotification
      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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • NotFoundException We can’t locate the resource that you specified.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • InvalidNextTokenException The pagination token is invalid.
      • ExpiredNextTokenException The pagination token expired.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • executeBudgetAction

      default CompletableFuture<ExecuteBudgetActionResponse> executeBudgetAction(ExecuteBudgetActionRequest executeBudgetActionRequest)

      Executes a budget action.

      Parameters:
      executeBudgetActionRequest -
      Returns:
      A Java Future containing the result of the ExecuteBudgetAction 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ResourceLockedException The request was received and recognized by the server, but the server rejected that particular method for the requested resource.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • executeBudgetAction

      default CompletableFuture<ExecuteBudgetActionResponse> executeBudgetAction(Consumer<ExecuteBudgetActionRequest.Builder> executeBudgetActionRequest)

      Executes a budget action.


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

      Parameters:
      executeBudgetActionRequest - A Consumer that will call methods on ExecuteBudgetActionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ExecuteBudgetAction 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ResourceLockedException The request was received and recognized by the server, but the server rejected that particular method for the requested resource.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • listTagsForResource

      default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)

      Lists tags associated with a budget or budget action 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 number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • listTagsForResource

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

      Lists tags associated with a budget or budget action 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 number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • tagResource

      default CompletableFuture<TagResourceResponse> tagResource(TagResourceRequest tagResourceRequest)

      Creates tags for a budget or budget action 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 number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • ServiceQuotaExceededException You've reached the limit on the number of tags you can associate with a resource.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • tagResource

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

      Creates tags for a budget or budget action 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 number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • ServiceQuotaExceededException You've reached the limit on the number of tags you can associate with a resource.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • untagResource

      default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest)

      Deletes tags associated with a budget or budget action resource.

      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 number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • untagResource

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

      Deletes tags associated with a budget or budget action resource.


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

      Parameters:
      untagResourceRequest - A Consumer that will call methods on UntagResourceRequest.Builder to create a request.
      Returns:
      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 number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • updateBudget

      default CompletableFuture<UpdateBudgetResponse> updateBudget(UpdateBudgetRequest updateBudgetRequest)

      Updates a budget. You can change every part of a budget except for the budgetName and the calculatedSpend. When you modify a budget, the calculatedSpend drops to zero until Amazon Web Services has new usage data to use for forecasting.

      Only one of BudgetLimit or PlannedBudgetLimits can be present in the syntax at one time. Use the syntax that matches your case. The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see the Examples section.

      Similarly, only one set of filter and metric selections can be present in the syntax at one time. Either FilterExpression and Metrics or CostFilters and CostTypes, not both or a different combination. We recommend using FilterExpression and Metrics as they provide more flexible and powerful filtering capabilities. The Request Syntax section shows the FilterExpression/Metrics syntax.

      Parameters:
      updateBudgetRequest - Request of UpdateBudget
      Returns:
      A Java Future containing the result of the UpdateBudget 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • updateBudget

      default CompletableFuture<UpdateBudgetResponse> updateBudget(Consumer<UpdateBudgetRequest.Builder> updateBudgetRequest)

      Updates a budget. You can change every part of a budget except for the budgetName and the calculatedSpend. When you modify a budget, the calculatedSpend drops to zero until Amazon Web Services has new usage data to use for forecasting.

      Only one of BudgetLimit or PlannedBudgetLimits can be present in the syntax at one time. Use the syntax that matches your case. The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see the Examples section.

      Similarly, only one set of filter and metric selections can be present in the syntax at one time. Either FilterExpression and Metrics or CostFilters and CostTypes, not both or a different combination. We recommend using FilterExpression and Metrics as they provide more flexible and powerful filtering capabilities. The Request Syntax section shows the FilterExpression/Metrics syntax.


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

      Parameters:
      updateBudgetRequest - A Consumer that will call methods on UpdateBudgetRequest.Builder to create a request. Request of UpdateBudget
      Returns:
      A Java Future containing the result of the UpdateBudget 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • updateBudgetAction

      default CompletableFuture<UpdateBudgetActionResponse> updateBudgetAction(UpdateBudgetActionRequest updateBudgetActionRequest)

      Updates a budget action.

      Parameters:
      updateBudgetActionRequest -
      Returns:
      A Java Future containing the result of the UpdateBudgetAction 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ResourceLockedException The request was received and recognized by the server, but the server rejected that particular method for the requested resource.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • updateBudgetAction

      default CompletableFuture<UpdateBudgetActionResponse> updateBudgetAction(Consumer<UpdateBudgetActionRequest.Builder> updateBudgetActionRequest)

      Updates a budget action.


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

      Parameters:
      updateBudgetActionRequest - A Consumer that will call methods on UpdateBudgetActionRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdateBudgetAction 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ResourceLockedException The request was received and recognized by the server, but the server rejected that particular method for the requested resource.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • updateNotification

      default CompletableFuture<UpdateNotificationResponse> updateNotification(UpdateNotificationRequest updateNotificationRequest)

      Updates a notification.

      Parameters:
      updateNotificationRequest - Request of UpdateNotification
      Returns:
      A Java Future containing the result of the UpdateNotification 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • DuplicateRecordException The budget name already exists. Budget names must be unique within an account.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • updateNotification

      default CompletableFuture<UpdateNotificationResponse> updateNotification(Consumer<UpdateNotificationRequest.Builder> updateNotificationRequest)

      Updates a notification.


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

      Parameters:
      updateNotificationRequest - A Consumer that will call methods on UpdateNotificationRequest.Builder to create a request. Request of UpdateNotification
      Returns:
      A Java Future containing the result of the UpdateNotification 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • DuplicateRecordException The budget name already exists. Budget names must be unique within an account.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • updateSubscriber

      default CompletableFuture<UpdateSubscriberResponse> updateSubscriber(UpdateSubscriberRequest updateSubscriberRequest)

      Updates a subscriber.

      Parameters:
      updateSubscriberRequest - Request of UpdateSubscriber
      Returns:
      A Java Future containing the result of the UpdateSubscriber 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • DuplicateRecordException The budget name already exists. Budget names must be unique within an account.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • updateSubscriber

      default CompletableFuture<UpdateSubscriberResponse> updateSubscriber(Consumer<UpdateSubscriberRequest.Builder> updateSubscriberRequest)

      Updates a subscriber.


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

      Parameters:
      updateSubscriberRequest - A Consumer that will call methods on UpdateSubscriberRequest.Builder to create a request. Request of UpdateSubscriber
      Returns:
      A Java Future containing the result of the UpdateSubscriber 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.
      • InternalErrorException An error on the server occurred during the processing of your request. Try again later.
      • InvalidParameterException An error on the client occurred. Typically, the cause is an invalid input value.
      • NotFoundException We can’t locate the resource that you specified.
      • DuplicateRecordException The budget name already exists. Budget names must be unique within an account.
      • AccessDeniedException You are not authorized to use this operation with the given parameters.
      • ThrottlingException The number of API requests has exceeded the maximum allowed API request throttling limit for the account.
      • 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.
      • BudgetsException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

    • serviceClientConfiguration

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

    • builder

      static BudgetsAsyncClientBuilder builder()
      Create a builder that can be used to configure and create a BudgetsAsyncClient.