@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AbstractAWSBudgetsAsync extends AbstractAWSBudgets implements AWSBudgetsAsync
AWSBudgetsAsync. Convenient method forms pass through to the corresponding
overload that takes a request object and an AsyncHandler, which throws an
UnsupportedOperationException.ENDPOINT_PREFIXcreateBudget, createBudgetAction, createNotification, createSubscriber, deleteBudget, deleteBudgetAction, deleteNotification, deleteSubscriber, describeBudget, describeBudgetAction, describeBudgetActionHistories, describeBudgetActionsForAccount, describeBudgetActionsForBudget, describeBudgetNotificationsForAccount, describeBudgetPerformanceHistory, describeBudgets, describeNotificationsForBudget, describeSubscribersForNotification, executeBudgetAction, getCachedResponseMetadata, listTagsForResource, setEndpoint, setRegion, shutdown, tagResource, untagResource, updateBudget, updateBudgetAction, updateNotification, updateSubscriberequals, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitcreateBudget, createBudgetAction, createNotification, createSubscriber, deleteBudget, deleteBudgetAction, deleteNotification, deleteSubscriber, describeBudget, describeBudgetAction, describeBudgetActionHistories, describeBudgetActionsForAccount, describeBudgetActionsForBudget, describeBudgetNotificationsForAccount, describeBudgetPerformanceHistory, describeBudgets, describeNotificationsForBudget, describeSubscribersForNotification, executeBudgetAction, getCachedResponseMetadata, listTagsForResource, setEndpoint, setRegion, shutdown, tagResource, untagResource, updateBudget, updateBudgetAction, updateNotification, updateSubscriberpublic Future<CreateBudgetResult> createBudgetAsync(CreateBudgetRequest request)
AWSBudgetsAsyncCreates 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.
createBudgetAsync in interface AWSBudgetsAsyncrequest - Request of CreateBudgetpublic Future<CreateBudgetResult> createBudgetAsync(CreateBudgetRequest request, AsyncHandler<CreateBudgetRequest,CreateBudgetResult> asyncHandler)
AWSBudgetsAsyncCreates 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.
createBudgetAsync in interface AWSBudgetsAsyncrequest - Request of CreateBudgetasyncHandler - 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.public Future<CreateBudgetActionResult> createBudgetActionAsync(CreateBudgetActionRequest request)
AWSBudgetsAsyncCreates a budget action.
createBudgetActionAsync in interface AWSBudgetsAsyncpublic Future<CreateBudgetActionResult> createBudgetActionAsync(CreateBudgetActionRequest request, AsyncHandler<CreateBudgetActionRequest,CreateBudgetActionResult> asyncHandler)
AWSBudgetsAsyncCreates a budget action.
createBudgetActionAsync in interface AWSBudgetsAsyncasyncHandler - 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.public Future<CreateNotificationResult> createNotificationAsync(CreateNotificationRequest request)
AWSBudgetsAsyncCreates a notification. You must create the budget before you create the associated notification.
createNotificationAsync in interface AWSBudgetsAsyncrequest - Request of CreateNotificationpublic Future<CreateNotificationResult> createNotificationAsync(CreateNotificationRequest request, AsyncHandler<CreateNotificationRequest,CreateNotificationResult> asyncHandler)
AWSBudgetsAsyncCreates a notification. You must create the budget before you create the associated notification.
createNotificationAsync in interface AWSBudgetsAsyncrequest - Request of CreateNotificationasyncHandler - 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.public Future<CreateSubscriberResult> createSubscriberAsync(CreateSubscriberRequest request)
AWSBudgetsAsyncCreates a subscriber. You must create the associated budget and notification before you create the subscriber.
createSubscriberAsync in interface AWSBudgetsAsyncrequest - Request of CreateSubscriberpublic Future<CreateSubscriberResult> createSubscriberAsync(CreateSubscriberRequest request, AsyncHandler<CreateSubscriberRequest,CreateSubscriberResult> asyncHandler)
AWSBudgetsAsyncCreates a subscriber. You must create the associated budget and notification before you create the subscriber.
createSubscriberAsync in interface AWSBudgetsAsyncrequest - Request of CreateSubscriberasyncHandler - 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.public Future<DeleteBudgetResult> deleteBudgetAsync(DeleteBudgetRequest request)
AWSBudgetsAsyncDeletes 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.
deleteBudgetAsync in interface AWSBudgetsAsyncrequest - Request of DeleteBudgetpublic Future<DeleteBudgetResult> deleteBudgetAsync(DeleteBudgetRequest request, AsyncHandler<DeleteBudgetRequest,DeleteBudgetResult> asyncHandler)
AWSBudgetsAsyncDeletes 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.
deleteBudgetAsync in interface AWSBudgetsAsyncrequest - Request of DeleteBudgetasyncHandler - 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.public Future<DeleteBudgetActionResult> deleteBudgetActionAsync(DeleteBudgetActionRequest request)
AWSBudgetsAsyncDeletes a budget action.
deleteBudgetActionAsync in interface AWSBudgetsAsyncpublic Future<DeleteBudgetActionResult> deleteBudgetActionAsync(DeleteBudgetActionRequest request, AsyncHandler<DeleteBudgetActionRequest,DeleteBudgetActionResult> asyncHandler)
AWSBudgetsAsyncDeletes a budget action.
deleteBudgetActionAsync in interface AWSBudgetsAsyncasyncHandler - 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.public Future<DeleteNotificationResult> deleteNotificationAsync(DeleteNotificationRequest request)
AWSBudgetsAsyncDeletes a notification.
Deleting a notification also deletes the subscribers that are associated with the notification.
deleteNotificationAsync in interface AWSBudgetsAsyncrequest - Request of DeleteNotificationpublic Future<DeleteNotificationResult> deleteNotificationAsync(DeleteNotificationRequest request, AsyncHandler<DeleteNotificationRequest,DeleteNotificationResult> asyncHandler)
AWSBudgetsAsyncDeletes a notification.
Deleting a notification also deletes the subscribers that are associated with the notification.
deleteNotificationAsync in interface AWSBudgetsAsyncrequest - Request of DeleteNotificationasyncHandler - 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.public Future<DeleteSubscriberResult> deleteSubscriberAsync(DeleteSubscriberRequest request)
AWSBudgetsAsyncDeletes a subscriber.
Deleting the last subscriber to a notification also deletes the notification.
deleteSubscriberAsync in interface AWSBudgetsAsyncrequest - Request of DeleteSubscriberpublic Future<DeleteSubscriberResult> deleteSubscriberAsync(DeleteSubscriberRequest request, AsyncHandler<DeleteSubscriberRequest,DeleteSubscriberResult> asyncHandler)
AWSBudgetsAsyncDeletes a subscriber.
Deleting the last subscriber to a notification also deletes the notification.
deleteSubscriberAsync in interface AWSBudgetsAsyncrequest - Request of DeleteSubscriberasyncHandler - 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.public Future<DescribeBudgetResult> describeBudgetAsync(DescribeBudgetRequest request)
AWSBudgetsAsyncDescribes a budget.
The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see
the Examples section.
describeBudgetAsync in interface AWSBudgetsAsyncrequest - Request of DescribeBudgetpublic Future<DescribeBudgetResult> describeBudgetAsync(DescribeBudgetRequest request, AsyncHandler<DescribeBudgetRequest,DescribeBudgetResult> asyncHandler)
AWSBudgetsAsyncDescribes a budget.
The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see
the Examples section.
describeBudgetAsync in interface AWSBudgetsAsyncrequest - Request of DescribeBudgetasyncHandler - 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.public Future<DescribeBudgetActionResult> describeBudgetActionAsync(DescribeBudgetActionRequest request)
AWSBudgetsAsyncDescribes a budget action detail.
describeBudgetActionAsync in interface AWSBudgetsAsyncpublic Future<DescribeBudgetActionResult> describeBudgetActionAsync(DescribeBudgetActionRequest request, AsyncHandler<DescribeBudgetActionRequest,DescribeBudgetActionResult> asyncHandler)
AWSBudgetsAsyncDescribes a budget action detail.
describeBudgetActionAsync in interface AWSBudgetsAsyncasyncHandler - 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.public Future<DescribeBudgetActionHistoriesResult> describeBudgetActionHistoriesAsync(DescribeBudgetActionHistoriesRequest request)
AWSBudgetsAsyncDescribes a budget action history detail.
describeBudgetActionHistoriesAsync in interface AWSBudgetsAsyncpublic Future<DescribeBudgetActionHistoriesResult> describeBudgetActionHistoriesAsync(DescribeBudgetActionHistoriesRequest request, AsyncHandler<DescribeBudgetActionHistoriesRequest,DescribeBudgetActionHistoriesResult> asyncHandler)
AWSBudgetsAsyncDescribes a budget action history detail.
describeBudgetActionHistoriesAsync in interface AWSBudgetsAsyncasyncHandler - 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.public Future<DescribeBudgetActionsForAccountResult> describeBudgetActionsForAccountAsync(DescribeBudgetActionsForAccountRequest request)
AWSBudgetsAsyncDescribes all of the budget actions for an account.
describeBudgetActionsForAccountAsync in interface AWSBudgetsAsyncpublic Future<DescribeBudgetActionsForAccountResult> describeBudgetActionsForAccountAsync(DescribeBudgetActionsForAccountRequest request, AsyncHandler<DescribeBudgetActionsForAccountRequest,DescribeBudgetActionsForAccountResult> asyncHandler)
AWSBudgetsAsyncDescribes all of the budget actions for an account.
describeBudgetActionsForAccountAsync in interface AWSBudgetsAsyncasyncHandler - 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.public Future<DescribeBudgetActionsForBudgetResult> describeBudgetActionsForBudgetAsync(DescribeBudgetActionsForBudgetRequest request)
AWSBudgetsAsyncDescribes all of the budget actions for a budget.
describeBudgetActionsForBudgetAsync in interface AWSBudgetsAsyncpublic Future<DescribeBudgetActionsForBudgetResult> describeBudgetActionsForBudgetAsync(DescribeBudgetActionsForBudgetRequest request, AsyncHandler<DescribeBudgetActionsForBudgetRequest,DescribeBudgetActionsForBudgetResult> asyncHandler)
AWSBudgetsAsyncDescribes all of the budget actions for a budget.
describeBudgetActionsForBudgetAsync in interface AWSBudgetsAsyncasyncHandler - 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.public Future<DescribeBudgetNotificationsForAccountResult> describeBudgetNotificationsForAccountAsync(DescribeBudgetNotificationsForAccountRequest request)
AWSBudgetsAsyncLists the budget names and notifications that are associated with an account.
describeBudgetNotificationsForAccountAsync in interface AWSBudgetsAsyncpublic Future<DescribeBudgetNotificationsForAccountResult> describeBudgetNotificationsForAccountAsync(DescribeBudgetNotificationsForAccountRequest request, AsyncHandler<DescribeBudgetNotificationsForAccountRequest,DescribeBudgetNotificationsForAccountResult> asyncHandler)
AWSBudgetsAsyncLists the budget names and notifications that are associated with an account.
describeBudgetNotificationsForAccountAsync in interface AWSBudgetsAsyncasyncHandler - 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.public Future<DescribeBudgetPerformanceHistoryResult> describeBudgetPerformanceHistoryAsync(DescribeBudgetPerformanceHistoryRequest request)
AWSBudgetsAsync
Describes the history for DAILY, MONTHLY, and QUARTERLY budgets. Budget
history isn't available for ANNUAL budgets.
describeBudgetPerformanceHistoryAsync in interface AWSBudgetsAsyncpublic Future<DescribeBudgetPerformanceHistoryResult> describeBudgetPerformanceHistoryAsync(DescribeBudgetPerformanceHistoryRequest request, AsyncHandler<DescribeBudgetPerformanceHistoryRequest,DescribeBudgetPerformanceHistoryResult> asyncHandler)
AWSBudgetsAsync
Describes the history for DAILY, MONTHLY, and QUARTERLY budgets. Budget
history isn't available for ANNUAL budgets.
describeBudgetPerformanceHistoryAsync in interface AWSBudgetsAsyncasyncHandler - 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.public Future<DescribeBudgetsResult> describeBudgetsAsync(DescribeBudgetsRequest request)
AWSBudgetsAsyncLists the budgets that are associated with an account.
The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see
the Examples section.
describeBudgetsAsync in interface AWSBudgetsAsyncrequest - Request of DescribeBudgetspublic Future<DescribeBudgetsResult> describeBudgetsAsync(DescribeBudgetsRequest request, AsyncHandler<DescribeBudgetsRequest,DescribeBudgetsResult> asyncHandler)
AWSBudgetsAsyncLists the budgets that are associated with an account.
The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see
the Examples section.
describeBudgetsAsync in interface AWSBudgetsAsyncrequest - Request of DescribeBudgetsasyncHandler - 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.public Future<DescribeNotificationsForBudgetResult> describeNotificationsForBudgetAsync(DescribeNotificationsForBudgetRequest request)
AWSBudgetsAsyncLists the notifications that are associated with a budget.
describeNotificationsForBudgetAsync in interface AWSBudgetsAsyncrequest - Request of DescribeNotificationsForBudgetpublic Future<DescribeNotificationsForBudgetResult> describeNotificationsForBudgetAsync(DescribeNotificationsForBudgetRequest request, AsyncHandler<DescribeNotificationsForBudgetRequest,DescribeNotificationsForBudgetResult> asyncHandler)
AWSBudgetsAsyncLists the notifications that are associated with a budget.
describeNotificationsForBudgetAsync in interface AWSBudgetsAsyncrequest - Request of DescribeNotificationsForBudgetasyncHandler - 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.public Future<DescribeSubscribersForNotificationResult> describeSubscribersForNotificationAsync(DescribeSubscribersForNotificationRequest request)
AWSBudgetsAsyncLists the subscribers that are associated with a notification.
describeSubscribersForNotificationAsync in interface AWSBudgetsAsyncrequest - Request of DescribeSubscribersForNotificationpublic Future<DescribeSubscribersForNotificationResult> describeSubscribersForNotificationAsync(DescribeSubscribersForNotificationRequest request, AsyncHandler<DescribeSubscribersForNotificationRequest,DescribeSubscribersForNotificationResult> asyncHandler)
AWSBudgetsAsyncLists the subscribers that are associated with a notification.
describeSubscribersForNotificationAsync in interface AWSBudgetsAsyncrequest - Request of DescribeSubscribersForNotificationasyncHandler - 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.public Future<ExecuteBudgetActionResult> executeBudgetActionAsync(ExecuteBudgetActionRequest request)
AWSBudgetsAsyncExecutes a budget action.
executeBudgetActionAsync in interface AWSBudgetsAsyncpublic Future<ExecuteBudgetActionResult> executeBudgetActionAsync(ExecuteBudgetActionRequest request, AsyncHandler<ExecuteBudgetActionRequest,ExecuteBudgetActionResult> asyncHandler)
AWSBudgetsAsyncExecutes a budget action.
executeBudgetActionAsync in interface AWSBudgetsAsyncasyncHandler - 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.public Future<ListTagsForResourceResult> listTagsForResourceAsync(ListTagsForResourceRequest request)
AWSBudgetsAsyncLists tags associated with a budget or budget action resource.
listTagsForResourceAsync in interface AWSBudgetsAsyncpublic Future<ListTagsForResourceResult> listTagsForResourceAsync(ListTagsForResourceRequest request, AsyncHandler<ListTagsForResourceRequest,ListTagsForResourceResult> asyncHandler)
AWSBudgetsAsyncLists tags associated with a budget or budget action resource.
listTagsForResourceAsync in interface AWSBudgetsAsyncasyncHandler - 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.public Future<TagResourceResult> tagResourceAsync(TagResourceRequest request)
AWSBudgetsAsyncCreates tags for a budget or budget action resource.
tagResourceAsync in interface AWSBudgetsAsyncpublic Future<TagResourceResult> tagResourceAsync(TagResourceRequest request, AsyncHandler<TagResourceRequest,TagResourceResult> asyncHandler)
AWSBudgetsAsyncCreates tags for a budget or budget action resource.
tagResourceAsync in interface AWSBudgetsAsyncasyncHandler - 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.public Future<UntagResourceResult> untagResourceAsync(UntagResourceRequest request)
AWSBudgetsAsyncDeletes tags associated with a budget or budget action resource.
untagResourceAsync in interface AWSBudgetsAsyncpublic Future<UntagResourceResult> untagResourceAsync(UntagResourceRequest request, AsyncHandler<UntagResourceRequest,UntagResourceResult> asyncHandler)
AWSBudgetsAsyncDeletes tags associated with a budget or budget action resource.
untagResourceAsync in interface AWSBudgetsAsyncasyncHandler - 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.public Future<UpdateBudgetResult> updateBudgetAsync(UpdateBudgetRequest request)
AWSBudgetsAsync
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.
updateBudgetAsync in interface AWSBudgetsAsyncrequest - Request of UpdateBudgetpublic Future<UpdateBudgetResult> updateBudgetAsync(UpdateBudgetRequest request, AsyncHandler<UpdateBudgetRequest,UpdateBudgetResult> asyncHandler)
AWSBudgetsAsync
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.
updateBudgetAsync in interface AWSBudgetsAsyncrequest - Request of UpdateBudgetasyncHandler - 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.public Future<UpdateBudgetActionResult> updateBudgetActionAsync(UpdateBudgetActionRequest request)
AWSBudgetsAsyncUpdates a budget action.
updateBudgetActionAsync in interface AWSBudgetsAsyncpublic Future<UpdateBudgetActionResult> updateBudgetActionAsync(UpdateBudgetActionRequest request, AsyncHandler<UpdateBudgetActionRequest,UpdateBudgetActionResult> asyncHandler)
AWSBudgetsAsyncUpdates a budget action.
updateBudgetActionAsync in interface AWSBudgetsAsyncasyncHandler - 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.public Future<UpdateNotificationResult> updateNotificationAsync(UpdateNotificationRequest request)
AWSBudgetsAsyncUpdates a notification.
updateNotificationAsync in interface AWSBudgetsAsyncrequest - Request of UpdateNotificationpublic Future<UpdateNotificationResult> updateNotificationAsync(UpdateNotificationRequest request, AsyncHandler<UpdateNotificationRequest,UpdateNotificationResult> asyncHandler)
AWSBudgetsAsyncUpdates a notification.
updateNotificationAsync in interface AWSBudgetsAsyncrequest - Request of UpdateNotificationasyncHandler - 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.public Future<UpdateSubscriberResult> updateSubscriberAsync(UpdateSubscriberRequest request)
AWSBudgetsAsyncUpdates a subscriber.
updateSubscriberAsync in interface AWSBudgetsAsyncrequest - Request of UpdateSubscriberpublic Future<UpdateSubscriberResult> updateSubscriberAsync(UpdateSubscriberRequest request, AsyncHandler<UpdateSubscriberRequest,UpdateSubscriberResult> asyncHandler)
AWSBudgetsAsyncUpdates a subscriber.
updateSubscriberAsync in interface AWSBudgetsAsyncrequest - Request of UpdateSubscriberasyncHandler - 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.