/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.budgets; import javax.annotation.Generated; import com.amazonaws.services.budgets.model.*; /** * Interface for accessing AWSBudgets asynchronously. Each asynchronous method will return a Java Future object * representing the asynchronous operation; overloads which accept an {@code AsyncHandler} can be used to receive * notification when an asynchronous operation completes. *
* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from * {@link com.amazonaws.services.budgets.AbstractAWSBudgetsAsync} instead. *
**
* 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. *
*/ @Generated("com.amazonaws:aws-java-sdk-code-generator") public interface AWSBudgetsAsync extends AWSBudgets { /** ** 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 case. The Request Syntax section shows the BudgetLimit
* syntax. For PlannedBudgetLimits
, see the Examples section.
*
* 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 case. The Request Syntax section shows the BudgetLimit
* syntax. For PlannedBudgetLimits
, see the Examples section.
*
* Creates a budget action. *
* * @param createBudgetActionRequest * @return A Java Future containing the result of the CreateBudgetAction operation returned by the service. * @sample AWSBudgetsAsync.CreateBudgetAction */ java.util.concurrent.Future* Creates a budget action. *
* * @param createBudgetActionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateBudgetAction operation returned by the service. * @sample AWSBudgetsAsyncHandler.CreateBudgetAction */ java.util.concurrent.Future* Creates a notification. You must create the budget before you create the associated notification. *
* * @param createNotificationRequest * Request of CreateNotification * @return A Java Future containing the result of the CreateNotification operation returned by the service. * @sample AWSBudgetsAsync.CreateNotification */ java.util.concurrent.Future* Creates a notification. You must create the budget before you create the associated notification. *
* * @param createNotificationRequest * Request of CreateNotification * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateNotification operation returned by the service. * @sample AWSBudgetsAsyncHandler.CreateNotification */ java.util.concurrent.Future* Creates a subscriber. You must create the associated budget and notification before you create the subscriber. *
* * @param createSubscriberRequest * Request of CreateSubscriber * @return A Java Future containing the result of the CreateSubscriber operation returned by the service. * @sample AWSBudgetsAsync.CreateSubscriber */ java.util.concurrent.Future* Creates a subscriber. You must create the associated budget and notification before you create the subscriber. *
* * @param createSubscriberRequest * Request of CreateSubscriber * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateSubscriber operation returned by the service. * @sample AWSBudgetsAsyncHandler.CreateSubscriber */ java.util.concurrent.Future* 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. *
** 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. *
** Deletes a budget action. *
* * @param deleteBudgetActionRequest * @return A Java Future containing the result of the DeleteBudgetAction operation returned by the service. * @sample AWSBudgetsAsync.DeleteBudgetAction */ java.util.concurrent.Future* Deletes a budget action. *
* * @param deleteBudgetActionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteBudgetAction operation returned by the service. * @sample AWSBudgetsAsyncHandler.DeleteBudgetAction */ java.util.concurrent.Future* Deletes a notification. *
** Deleting a notification also deletes the subscribers that are associated with the notification. *
** Deletes a notification. *
** Deleting a notification also deletes the subscribers that are associated with the notification. *
** Deletes a subscriber. *
** Deleting the last subscriber to a notification also deletes the notification. *
** Deletes a subscriber. *
** Deleting the last subscriber to a notification also deletes the notification. *
** Describes a budget. *
*
* The Request Syntax section shows the BudgetLimit
syntax. For PlannedBudgetLimits
, see
* the Examples section.
*
* Describes a budget. *
*
* The Request Syntax section shows the BudgetLimit
syntax. For PlannedBudgetLimits
, see
* the Examples section.
*
* Describes a budget action detail. *
* * @param describeBudgetActionRequest * @return A Java Future containing the result of the DescribeBudgetAction operation returned by the service. * @sample AWSBudgetsAsync.DescribeBudgetAction */ java.util.concurrent.Future* Describes a budget action detail. *
* * @param describeBudgetActionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeBudgetAction operation returned by the service. * @sample AWSBudgetsAsyncHandler.DescribeBudgetAction */ java.util.concurrent.Future* Describes a budget action history detail. *
* * @param describeBudgetActionHistoriesRequest * @return A Java Future containing the result of the DescribeBudgetActionHistories operation returned by the * service. * @sample AWSBudgetsAsync.DescribeBudgetActionHistories */ java.util.concurrent.Future* Describes a budget action history detail. *
* * @param describeBudgetActionHistoriesRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeBudgetActionHistories operation returned by the * service. * @sample AWSBudgetsAsyncHandler.DescribeBudgetActionHistories */ java.util.concurrent.Future* Describes all of the budget actions for an account. *
* * @param describeBudgetActionsForAccountRequest * @return A Java Future containing the result of the DescribeBudgetActionsForAccount operation returned by the * service. * @sample AWSBudgetsAsync.DescribeBudgetActionsForAccount */ java.util.concurrent.Future* Describes all of the budget actions for an account. *
* * @param describeBudgetActionsForAccountRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeBudgetActionsForAccount operation returned by the * service. * @sample AWSBudgetsAsyncHandler.DescribeBudgetActionsForAccount */ java.util.concurrent.Future* Describes all of the budget actions for a budget. *
* * @param describeBudgetActionsForBudgetRequest * @return A Java Future containing the result of the DescribeBudgetActionsForBudget operation returned by the * service. * @sample AWSBudgetsAsync.DescribeBudgetActionsForBudget */ java.util.concurrent.Future* Describes all of the budget actions for a budget. *
* * @param describeBudgetActionsForBudgetRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeBudgetActionsForBudget operation returned by the * service. * @sample AWSBudgetsAsyncHandler.DescribeBudgetActionsForBudget */ java.util.concurrent.Future* Lists the budget names and notifications that are associated with an account. *
* * @param describeBudgetNotificationsForAccountRequest * @return A Java Future containing the result of the DescribeBudgetNotificationsForAccount operation returned by * the service. * @sample AWSBudgetsAsync.DescribeBudgetNotificationsForAccount */ java.util.concurrent.Future* Lists the budget names and notifications that are associated with an account. *
* * @param describeBudgetNotificationsForAccountRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeBudgetNotificationsForAccount operation returned by * the service. * @sample AWSBudgetsAsyncHandler.DescribeBudgetNotificationsForAccount */ java.util.concurrent.Future
* Describes the history for DAILY
, MONTHLY
, and QUARTERLY
budgets. Budget
* history isn't available for ANNUAL
budgets.
*
* Describes the history for DAILY
, MONTHLY
, and QUARTERLY
budgets. Budget
* history isn't available for ANNUAL
budgets.
*
* Lists the budgets that are associated with an account. *
*
* The Request Syntax section shows the BudgetLimit
syntax. For PlannedBudgetLimits
, see
* the Examples section.
*
* Lists the budgets that are associated with an account. *
*
* The Request Syntax section shows the BudgetLimit
syntax. For PlannedBudgetLimits
, see
* the Examples section.
*
* Lists the notifications that are associated with a budget. *
* * @param describeNotificationsForBudgetRequest * Request of DescribeNotificationsForBudget * @return A Java Future containing the result of the DescribeNotificationsForBudget operation returned by the * service. * @sample AWSBudgetsAsync.DescribeNotificationsForBudget */ java.util.concurrent.Future* Lists the notifications that are associated with a budget. *
* * @param describeNotificationsForBudgetRequest * Request of DescribeNotificationsForBudget * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeNotificationsForBudget operation returned by the * service. * @sample AWSBudgetsAsyncHandler.DescribeNotificationsForBudget */ java.util.concurrent.Future* Lists the subscribers that are associated with a notification. *
* * @param describeSubscribersForNotificationRequest * Request of DescribeSubscribersForNotification * @return A Java Future containing the result of the DescribeSubscribersForNotification operation returned by the * service. * @sample AWSBudgetsAsync.DescribeSubscribersForNotification */ java.util.concurrent.Future* Lists the subscribers that are associated with a notification. *
* * @param describeSubscribersForNotificationRequest * Request of DescribeSubscribersForNotification * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeSubscribersForNotification operation returned by the * service. * @sample AWSBudgetsAsyncHandler.DescribeSubscribersForNotification */ java.util.concurrent.Future* Executes a budget action. *
* * @param executeBudgetActionRequest * @return A Java Future containing the result of the ExecuteBudgetAction operation returned by the service. * @sample AWSBudgetsAsync.ExecuteBudgetAction */ java.util.concurrent.Future* Executes a budget action. *
* * @param executeBudgetActionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ExecuteBudgetAction operation returned by the service. * @sample AWSBudgetsAsyncHandler.ExecuteBudgetAction */ java.util.concurrent.Future
* 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.
*
* 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.
*
* Updates a budget action. *
* * @param updateBudgetActionRequest * @return A Java Future containing the result of the UpdateBudgetAction operation returned by the service. * @sample AWSBudgetsAsync.UpdateBudgetAction */ java.util.concurrent.Future* Updates a budget action. *
* * @param updateBudgetActionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UpdateBudgetAction operation returned by the service. * @sample AWSBudgetsAsyncHandler.UpdateBudgetAction */ java.util.concurrent.Future* Updates a notification. *
* * @param updateNotificationRequest * Request of UpdateNotification * @return A Java Future containing the result of the UpdateNotification operation returned by the service. * @sample AWSBudgetsAsync.UpdateNotification */ java.util.concurrent.Future* Updates a notification. *
* * @param updateNotificationRequest * Request of UpdateNotification * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UpdateNotification operation returned by the service. * @sample AWSBudgetsAsyncHandler.UpdateNotification */ java.util.concurrent.Future* Updates a subscriber. *
* * @param updateSubscriberRequest * Request of UpdateSubscriber * @return A Java Future containing the result of the UpdateSubscriber operation returned by the service. * @sample AWSBudgetsAsync.UpdateSubscriber */ java.util.concurrent.Future* Updates a subscriber. *
* * @param updateSubscriberRequest * Request of UpdateSubscriber * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UpdateSubscriber operation returned by the service. * @sample AWSBudgetsAsyncHandler.UpdateSubscriber */ java.util.concurrent.Future