@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public interface AmazonApplicationInsightsAsync extends AmazonApplicationInsights
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
AbstractAmazonApplicationInsightsAsync instead.
Amazon CloudWatch Application Insights is a service that helps you detect common problems with your applications. It enables you to pinpoint the source of issues in your applications (built with technologies such as Microsoft IIS, .NET, and Microsoft SQL Server), by providing key insights into detected problems.
After you onboard your application, CloudWatch Application Insights identifies, recommends, and sets up metrics and logs. It continuously analyzes and correlates your metrics and logs for unusual behavior to surface actionable problems with your application. For example, if your application is slow and unresponsive and leading to HTTP 500 errors in your Application Load Balancer (ALB), Application Insights informs you that a memory pressure problem with your SQL Server database is occurring. It bases this analysis on impactful metrics and log errors.
ENDPOINT_PREFIX addWorkload, createApplication, createComponent, createLogPattern, deleteApplication, deleteComponent, deleteLogPattern, describeApplication, describeComponent, describeComponentConfiguration, describeComponentConfigurationRecommendation, describeLogPattern, describeObservation, describeProblem, describeProblemObservations, describeWorkload, getCachedResponseMetadata, listApplications, listComponents, listConfigurationHistory, listLogPatterns, listLogPatternSets, listProblems, listTagsForResource, listWorkloads, removeWorkload, shutdown, tagResource, untagResource, updateApplication, updateComponent, updateComponentConfiguration, updateLogPattern, updateProblem, updateWorkload Future<AddWorkloadResult> addWorkloadAsync(AddWorkloadRequest addWorkloadRequest)
Adds a workload to a component. Each component can have at most five workloads.
addWorkloadRequest - Future<AddWorkloadResult> addWorkloadAsync(AddWorkloadRequest addWorkloadRequest, AsyncHandler<AddWorkloadRequest,AddWorkloadResult> asyncHandler)
Adds a workload to a component. Each component can have at most five workloads.
addWorkloadRequest - 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.Future<CreateApplicationResult> createApplicationAsync(CreateApplicationRequest createApplicationRequest)
Adds an application that is created from a resource group.
createApplicationRequest - Future<CreateApplicationResult> createApplicationAsync(CreateApplicationRequest createApplicationRequest, AsyncHandler<CreateApplicationRequest,CreateApplicationResult> asyncHandler)
Adds an application that is created from a resource group.
createApplicationRequest - 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.Future<CreateComponentResult> createComponentAsync(CreateComponentRequest createComponentRequest)
Creates a custom component by grouping similar standalone instances to monitor.
createComponentRequest - Future<CreateComponentResult> createComponentAsync(CreateComponentRequest createComponentRequest, AsyncHandler<CreateComponentRequest,CreateComponentResult> asyncHandler)
Creates a custom component by grouping similar standalone instances to monitor.
createComponentRequest - 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.Future<CreateLogPatternResult> createLogPatternAsync(CreateLogPatternRequest createLogPatternRequest)
Adds an log pattern to a LogPatternSet.
createLogPatternRequest - Future<CreateLogPatternResult> createLogPatternAsync(CreateLogPatternRequest createLogPatternRequest, AsyncHandler<CreateLogPatternRequest,CreateLogPatternResult> asyncHandler)
Adds an log pattern to a LogPatternSet.
createLogPatternRequest - 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.Future<DeleteApplicationResult> deleteApplicationAsync(DeleteApplicationRequest deleteApplicationRequest)
Removes the specified application from monitoring. Does not delete the application.
deleteApplicationRequest - Future<DeleteApplicationResult> deleteApplicationAsync(DeleteApplicationRequest deleteApplicationRequest, AsyncHandler<DeleteApplicationRequest,DeleteApplicationResult> asyncHandler)
Removes the specified application from monitoring. Does not delete the application.
deleteApplicationRequest - 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.Future<DeleteComponentResult> deleteComponentAsync(DeleteComponentRequest deleteComponentRequest)
Ungroups a custom component. When you ungroup custom components, all applicable monitors that are set up for the component are removed and the instances revert to their standalone status.
deleteComponentRequest - Future<DeleteComponentResult> deleteComponentAsync(DeleteComponentRequest deleteComponentRequest, AsyncHandler<DeleteComponentRequest,DeleteComponentResult> asyncHandler)
Ungroups a custom component. When you ungroup custom components, all applicable monitors that are set up for the component are removed and the instances revert to their standalone status.
deleteComponentRequest - 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.Future<DeleteLogPatternResult> deleteLogPatternAsync(DeleteLogPatternRequest deleteLogPatternRequest)
Removes the specified log pattern from a LogPatternSet.
deleteLogPatternRequest - Future<DeleteLogPatternResult> deleteLogPatternAsync(DeleteLogPatternRequest deleteLogPatternRequest, AsyncHandler<DeleteLogPatternRequest,DeleteLogPatternResult> asyncHandler)
Removes the specified log pattern from a LogPatternSet.
deleteLogPatternRequest - 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.Future<DescribeApplicationResult> describeApplicationAsync(DescribeApplicationRequest describeApplicationRequest)
Describes the application.
describeApplicationRequest - Future<DescribeApplicationResult> describeApplicationAsync(DescribeApplicationRequest describeApplicationRequest, AsyncHandler<DescribeApplicationRequest,DescribeApplicationResult> asyncHandler)
Describes the application.
describeApplicationRequest - 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.Future<DescribeComponentResult> describeComponentAsync(DescribeComponentRequest describeComponentRequest)
Describes a component and lists the resources that are grouped together in a component.
describeComponentRequest - Future<DescribeComponentResult> describeComponentAsync(DescribeComponentRequest describeComponentRequest, AsyncHandler<DescribeComponentRequest,DescribeComponentResult> asyncHandler)
Describes a component and lists the resources that are grouped together in a component.
describeComponentRequest - 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.Future<DescribeComponentConfigurationResult> describeComponentConfigurationAsync(DescribeComponentConfigurationRequest describeComponentConfigurationRequest)
Describes the monitoring configuration of the component.
describeComponentConfigurationRequest - Future<DescribeComponentConfigurationResult> describeComponentConfigurationAsync(DescribeComponentConfigurationRequest describeComponentConfigurationRequest, AsyncHandler<DescribeComponentConfigurationRequest,DescribeComponentConfigurationResult> asyncHandler)
Describes the monitoring configuration of the component.
describeComponentConfigurationRequest - 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.Future<DescribeComponentConfigurationRecommendationResult> describeComponentConfigurationRecommendationAsync(DescribeComponentConfigurationRecommendationRequest describeComponentConfigurationRecommendationRequest)
Describes the recommended monitoring configuration of the component.
describeComponentConfigurationRecommendationRequest - Future<DescribeComponentConfigurationRecommendationResult> describeComponentConfigurationRecommendationAsync(DescribeComponentConfigurationRecommendationRequest describeComponentConfigurationRecommendationRequest, AsyncHandler<DescribeComponentConfigurationRecommendationRequest,DescribeComponentConfigurationRecommendationResult> asyncHandler)
Describes the recommended monitoring configuration of the component.
describeComponentConfigurationRecommendationRequest - 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.Future<DescribeLogPatternResult> describeLogPatternAsync(DescribeLogPatternRequest describeLogPatternRequest)
Describe a specific log pattern from a LogPatternSet.
describeLogPatternRequest - Future<DescribeLogPatternResult> describeLogPatternAsync(DescribeLogPatternRequest describeLogPatternRequest, AsyncHandler<DescribeLogPatternRequest,DescribeLogPatternResult> asyncHandler)
Describe a specific log pattern from a LogPatternSet.
describeLogPatternRequest - 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.Future<DescribeObservationResult> describeObservationAsync(DescribeObservationRequest describeObservationRequest)
Describes an anomaly or error with the application.
describeObservationRequest - Future<DescribeObservationResult> describeObservationAsync(DescribeObservationRequest describeObservationRequest, AsyncHandler<DescribeObservationRequest,DescribeObservationResult> asyncHandler)
Describes an anomaly or error with the application.
describeObservationRequest - 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.Future<DescribeProblemResult> describeProblemAsync(DescribeProblemRequest describeProblemRequest)
Describes an application problem.
describeProblemRequest - Future<DescribeProblemResult> describeProblemAsync(DescribeProblemRequest describeProblemRequest, AsyncHandler<DescribeProblemRequest,DescribeProblemResult> asyncHandler)
Describes an application problem.
describeProblemRequest - 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.Future<DescribeProblemObservationsResult> describeProblemObservationsAsync(DescribeProblemObservationsRequest describeProblemObservationsRequest)
Describes the anomalies or errors associated with the problem.
describeProblemObservationsRequest - Future<DescribeProblemObservationsResult> describeProblemObservationsAsync(DescribeProblemObservationsRequest describeProblemObservationsRequest, AsyncHandler<DescribeProblemObservationsRequest,DescribeProblemObservationsResult> asyncHandler)
Describes the anomalies or errors associated with the problem.
describeProblemObservationsRequest - 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.Future<DescribeWorkloadResult> describeWorkloadAsync(DescribeWorkloadRequest describeWorkloadRequest)
Describes a workload and its configuration.
describeWorkloadRequest - Future<DescribeWorkloadResult> describeWorkloadAsync(DescribeWorkloadRequest describeWorkloadRequest, AsyncHandler<DescribeWorkloadRequest,DescribeWorkloadResult> asyncHandler)
Describes a workload and its configuration.
describeWorkloadRequest - 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.Future<ListApplicationsResult> listApplicationsAsync(ListApplicationsRequest listApplicationsRequest)
Lists the IDs of the applications that you are monitoring.
listApplicationsRequest - Future<ListApplicationsResult> listApplicationsAsync(ListApplicationsRequest listApplicationsRequest, AsyncHandler<ListApplicationsRequest,ListApplicationsResult> asyncHandler)
Lists the IDs of the applications that you are monitoring.
listApplicationsRequest - 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.Future<ListComponentsResult> listComponentsAsync(ListComponentsRequest listComponentsRequest)
Lists the auto-grouped, standalone, and custom components of the application.
listComponentsRequest - Future<ListComponentsResult> listComponentsAsync(ListComponentsRequest listComponentsRequest, AsyncHandler<ListComponentsRequest,ListComponentsResult> asyncHandler)
Lists the auto-grouped, standalone, and custom components of the application.
listComponentsRequest - 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.Future<ListConfigurationHistoryResult> listConfigurationHistoryAsync(ListConfigurationHistoryRequest listConfigurationHistoryRequest)
Lists the INFO, WARN, and ERROR events for periodic configuration updates performed by Application Insights. Examples of events represented are:
INFO: creating a new alarm or updating an alarm threshold.
WARN: alarm not created due to insufficient data points used to predict thresholds.
ERROR: alarm not created due to permission errors or exceeding quotas.
listConfigurationHistoryRequest - Future<ListConfigurationHistoryResult> listConfigurationHistoryAsync(ListConfigurationHistoryRequest listConfigurationHistoryRequest, AsyncHandler<ListConfigurationHistoryRequest,ListConfigurationHistoryResult> asyncHandler)
Lists the INFO, WARN, and ERROR events for periodic configuration updates performed by Application Insights. Examples of events represented are:
INFO: creating a new alarm or updating an alarm threshold.
WARN: alarm not created due to insufficient data points used to predict thresholds.
ERROR: alarm not created due to permission errors or exceeding quotas.
listConfigurationHistoryRequest - 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.Future<ListLogPatternSetsResult> listLogPatternSetsAsync(ListLogPatternSetsRequest listLogPatternSetsRequest)
Lists the log pattern sets in the specific application.
listLogPatternSetsRequest - Future<ListLogPatternSetsResult> listLogPatternSetsAsync(ListLogPatternSetsRequest listLogPatternSetsRequest, AsyncHandler<ListLogPatternSetsRequest,ListLogPatternSetsResult> asyncHandler)
Lists the log pattern sets in the specific application.
listLogPatternSetsRequest - 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.Future<ListLogPatternsResult> listLogPatternsAsync(ListLogPatternsRequest listLogPatternsRequest)
Lists the log patterns in the specific log LogPatternSet.
listLogPatternsRequest - Future<ListLogPatternsResult> listLogPatternsAsync(ListLogPatternsRequest listLogPatternsRequest, AsyncHandler<ListLogPatternsRequest,ListLogPatternsResult> asyncHandler)
Lists the log patterns in the specific log LogPatternSet.
listLogPatternsRequest - 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.Future<ListProblemsResult> listProblemsAsync(ListProblemsRequest listProblemsRequest)
Lists the problems with your application.
listProblemsRequest - Future<ListProblemsResult> listProblemsAsync(ListProblemsRequest listProblemsRequest, AsyncHandler<ListProblemsRequest,ListProblemsResult> asyncHandler)
Lists the problems with your application.
listProblemsRequest - 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.Future<ListTagsForResourceResult> listTagsForResourceAsync(ListTagsForResourceRequest listTagsForResourceRequest)
Retrieve a list of the tags (keys and values) that are associated with a specified application. A tag is a label that you optionally define and associate with an application. Each tag consists of a required tag key and an optional associated tag value. A tag key is a general label that acts as a category for more specific tag values. A tag value acts as a descriptor within a tag key.
listTagsForResourceRequest - Future<ListTagsForResourceResult> listTagsForResourceAsync(ListTagsForResourceRequest listTagsForResourceRequest, AsyncHandler<ListTagsForResourceRequest,ListTagsForResourceResult> asyncHandler)
Retrieve a list of the tags (keys and values) that are associated with a specified application. A tag is a label that you optionally define and associate with an application. Each tag consists of a required tag key and an optional associated tag value. A tag key is a general label that acts as a category for more specific tag values. A tag value acts as a descriptor within a tag key.
listTagsForResourceRequest - 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.Future<ListWorkloadsResult> listWorkloadsAsync(ListWorkloadsRequest listWorkloadsRequest)
Lists the workloads that are configured on a given component.
listWorkloadsRequest - Future<ListWorkloadsResult> listWorkloadsAsync(ListWorkloadsRequest listWorkloadsRequest, AsyncHandler<ListWorkloadsRequest,ListWorkloadsResult> asyncHandler)
Lists the workloads that are configured on a given component.
listWorkloadsRequest - 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.Future<RemoveWorkloadResult> removeWorkloadAsync(RemoveWorkloadRequest removeWorkloadRequest)
Remove workload from a component.
removeWorkloadRequest - Future<RemoveWorkloadResult> removeWorkloadAsync(RemoveWorkloadRequest removeWorkloadRequest, AsyncHandler<RemoveWorkloadRequest,RemoveWorkloadResult> asyncHandler)
Remove workload from a component.
removeWorkloadRequest - 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.Future<TagResourceResult> tagResourceAsync(TagResourceRequest tagResourceRequest)
Add one or more tags (keys and values) to a specified application. A tag is a label that you optionally define and associate with an application. Tags can help you categorize and manage application in different ways, such as by purpose, owner, environment, or other criteria.
Each tag consists of a required tag key and an associated tag value, both of which you define. A tag key is a general label that acts as a category for more specific tag values. A tag value acts as a descriptor within a tag key.
tagResourceRequest - Future<TagResourceResult> tagResourceAsync(TagResourceRequest tagResourceRequest, AsyncHandler<TagResourceRequest,TagResourceResult> asyncHandler)
Add one or more tags (keys and values) to a specified application. A tag is a label that you optionally define and associate with an application. Tags can help you categorize and manage application in different ways, such as by purpose, owner, environment, or other criteria.
Each tag consists of a required tag key and an associated tag value, both of which you define. A tag key is a general label that acts as a category for more specific tag values. A tag value acts as a descriptor within a tag key.
tagResourceRequest - 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.Future<UntagResourceResult> untagResourceAsync(UntagResourceRequest untagResourceRequest)
Remove one or more tags (keys and values) from a specified application.
untagResourceRequest - Future<UntagResourceResult> untagResourceAsync(UntagResourceRequest untagResourceRequest, AsyncHandler<UntagResourceRequest,UntagResourceResult> asyncHandler)
Remove one or more tags (keys and values) from a specified application.
untagResourceRequest - 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.Future<UpdateApplicationResult> updateApplicationAsync(UpdateApplicationRequest updateApplicationRequest)
Updates the application.
updateApplicationRequest - Future<UpdateApplicationResult> updateApplicationAsync(UpdateApplicationRequest updateApplicationRequest, AsyncHandler<UpdateApplicationRequest,UpdateApplicationResult> asyncHandler)
Updates the application.
updateApplicationRequest - 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.Future<UpdateComponentResult> updateComponentAsync(UpdateComponentRequest updateComponentRequest)
Updates the custom component name and/or the list of resources that make up the component.
updateComponentRequest - Future<UpdateComponentResult> updateComponentAsync(UpdateComponentRequest updateComponentRequest, AsyncHandler<UpdateComponentRequest,UpdateComponentResult> asyncHandler)
Updates the custom component name and/or the list of resources that make up the component.
updateComponentRequest - 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.Future<UpdateComponentConfigurationResult> updateComponentConfigurationAsync(UpdateComponentConfigurationRequest updateComponentConfigurationRequest)
Updates the monitoring configurations for the component. The configuration input parameter is an escaped JSON of
the configuration and should match the schema of what is returned by
DescribeComponentConfigurationRecommendation.
updateComponentConfigurationRequest - Future<UpdateComponentConfigurationResult> updateComponentConfigurationAsync(UpdateComponentConfigurationRequest updateComponentConfigurationRequest, AsyncHandler<UpdateComponentConfigurationRequest,UpdateComponentConfigurationResult> asyncHandler)
Updates the monitoring configurations for the component. The configuration input parameter is an escaped JSON of
the configuration and should match the schema of what is returned by
DescribeComponentConfigurationRecommendation.
updateComponentConfigurationRequest - 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.Future<UpdateLogPatternResult> updateLogPatternAsync(UpdateLogPatternRequest updateLogPatternRequest)
Adds a log pattern to a LogPatternSet.
updateLogPatternRequest - Future<UpdateLogPatternResult> updateLogPatternAsync(UpdateLogPatternRequest updateLogPatternRequest, AsyncHandler<UpdateLogPatternRequest,UpdateLogPatternResult> asyncHandler)
Adds a log pattern to a LogPatternSet.
updateLogPatternRequest - 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.Future<UpdateProblemResult> updateProblemAsync(UpdateProblemRequest updateProblemRequest)
Updates the visibility of the problem or specifies the problem as RESOLVED.
updateProblemRequest - Future<UpdateProblemResult> updateProblemAsync(UpdateProblemRequest updateProblemRequest, AsyncHandler<UpdateProblemRequest,UpdateProblemResult> asyncHandler)
Updates the visibility of the problem or specifies the problem as RESOLVED.
updateProblemRequest - 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.Future<UpdateWorkloadResult> updateWorkloadAsync(UpdateWorkloadRequest updateWorkloadRequest)
Adds a workload to a component. Each component can have at most five workloads.
updateWorkloadRequest - Future<UpdateWorkloadResult> updateWorkloadAsync(UpdateWorkloadRequest updateWorkloadRequest, AsyncHandler<UpdateWorkloadRequest,UpdateWorkloadResult> asyncHandler)
Adds a workload to a component. Each component can have at most five workloads.
updateWorkloadRequest - 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.