com.amazonaws.services.eventbridge.AmazonEventBridgeAsync Maven / Gradle / Ivy
/*
* Copyright 2016-2021 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.eventbridge;
import javax.annotation.Generated;
import com.amazonaws.services.eventbridge.model.*;
/**
* Interface for accessing Amazon EventBridge 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.eventbridge.AbstractAmazonEventBridgeAsync} instead.
*
*
*
* Amazon EventBridge helps you to respond to state changes in your AWS resources. When your resources change state,
* they automatically send events into an event stream. You can create rules that match selected events in the stream
* and route them to targets to take action. You can also use rules to take action on a predetermined schedule. For
* example, you can configure rules to:
*
*
* -
*
* Automatically invoke an AWS Lambda function to update DNS entries when an event notifies you that Amazon EC2 instance
* enters the running state.
*
*
* -
*
* Direct specific API records from AWS CloudTrail to an Amazon Kinesis data stream for detailed analysis of potential
* security or availability risks.
*
*
* -
*
* Periodically invoke a built-in target to create a snapshot of an Amazon EBS volume.
*
*
*
*
* For more information about the features of Amazon EventBridge, see the Amazon EventBridge User Guide.
*
*/
@Generated("com.amazonaws:aws-java-sdk-code-generator")
public interface AmazonEventBridgeAsync extends AmazonEventBridge {
/**
*
* Activates a partner event source that has been deactivated. Once activated, your matching event bus will start
* receiving events from the event source.
*
*
* @param activateEventSourceRequest
* @return A Java Future containing the result of the ActivateEventSource operation returned by the service.
* @sample AmazonEventBridgeAsync.ActivateEventSource
* @see AWS API Documentation
*/
java.util.concurrent.Future activateEventSourceAsync(ActivateEventSourceRequest activateEventSourceRequest);
/**
*
* Activates a partner event source that has been deactivated. Once activated, your matching event bus will start
* receiving events from the event source.
*
*
* @param activateEventSourceRequest
* @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 ActivateEventSource operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.ActivateEventSource
* @see AWS API Documentation
*/
java.util.concurrent.Future activateEventSourceAsync(ActivateEventSourceRequest activateEventSourceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Cancels the specified replay.
*
*
* @param cancelReplayRequest
* @return A Java Future containing the result of the CancelReplay operation returned by the service.
* @sample AmazonEventBridgeAsync.CancelReplay
* @see AWS API
* Documentation
*/
java.util.concurrent.Future cancelReplayAsync(CancelReplayRequest cancelReplayRequest);
/**
*
* Cancels the specified replay.
*
*
* @param cancelReplayRequest
* @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 CancelReplay operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.CancelReplay
* @see AWS API
* Documentation
*/
java.util.concurrent.Future cancelReplayAsync(CancelReplayRequest cancelReplayRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Creates an archive of events with the specified settings. When you create an archive, incoming events might not
* immediately start being sent to the archive. Allow a short period of time for changes to take effect. If you do
* not specify a pattern to filter events sent to the archive, all events are sent to the archive except replayed
* events. Replayed events are not sent to an archive.
*
*
* @param createArchiveRequest
* @return A Java Future containing the result of the CreateArchive operation returned by the service.
* @sample AmazonEventBridgeAsync.CreateArchive
* @see AWS API
* Documentation
*/
java.util.concurrent.Future createArchiveAsync(CreateArchiveRequest createArchiveRequest);
/**
*
* Creates an archive of events with the specified settings. When you create an archive, incoming events might not
* immediately start being sent to the archive. Allow a short period of time for changes to take effect. If you do
* not specify a pattern to filter events sent to the archive, all events are sent to the archive except replayed
* events. Replayed events are not sent to an archive.
*
*
* @param createArchiveRequest
* @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 CreateArchive operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.CreateArchive
* @see AWS API
* Documentation
*/
java.util.concurrent.Future createArchiveAsync(CreateArchiveRequest createArchiveRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Creates a new event bus within your account. This can be a custom event bus which you can use to receive events
* from your custom applications and services, or it can be a partner event bus which can be matched to a partner
* event source.
*
*
* @param createEventBusRequest
* @return A Java Future containing the result of the CreateEventBus operation returned by the service.
* @sample AmazonEventBridgeAsync.CreateEventBus
* @see AWS API
* Documentation
*/
java.util.concurrent.Future createEventBusAsync(CreateEventBusRequest createEventBusRequest);
/**
*
* Creates a new event bus within your account. This can be a custom event bus which you can use to receive events
* from your custom applications and services, or it can be a partner event bus which can be matched to a partner
* event source.
*
*
* @param createEventBusRequest
* @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 CreateEventBus operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.CreateEventBus
* @see AWS API
* Documentation
*/
java.util.concurrent.Future createEventBusAsync(CreateEventBusRequest createEventBusRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Called by an SaaS partner to create a partner event source. This operation is not used by AWS customers.
*
*
* Each partner event source can be used by one AWS account to create a matching partner event bus in that AWS
* account. A SaaS partner must create one partner event source for each AWS account that wants to receive those
* event types.
*
*
* A partner event source creates events based on resources within the SaaS partner's service or application.
*
*
* An AWS account that creates a partner event bus that matches the partner event source can use that event bus to
* receive events from the partner, and then process them using AWS Events rules and targets.
*
*
* Partner event source names follow this format:
*
*
* partner_name/event_namespace/event_name
*
*
* partner_name is determined during partner registration and identifies the partner to AWS customers.
* event_namespace is determined by the partner and is a way for the partner to categorize their events.
* event_name is determined by the partner, and should uniquely identify an event-generating resource within
* the partner system. The combination of event_namespace and event_name should help AWS customers
* decide whether to create an event bus to receive these events.
*
*
* @param createPartnerEventSourceRequest
* @return A Java Future containing the result of the CreatePartnerEventSource operation returned by the service.
* @sample AmazonEventBridgeAsync.CreatePartnerEventSource
* @see AWS API Documentation
*/
java.util.concurrent.Future createPartnerEventSourceAsync(CreatePartnerEventSourceRequest createPartnerEventSourceRequest);
/**
*
* Called by an SaaS partner to create a partner event source. This operation is not used by AWS customers.
*
*
* Each partner event source can be used by one AWS account to create a matching partner event bus in that AWS
* account. A SaaS partner must create one partner event source for each AWS account that wants to receive those
* event types.
*
*
* A partner event source creates events based on resources within the SaaS partner's service or application.
*
*
* An AWS account that creates a partner event bus that matches the partner event source can use that event bus to
* receive events from the partner, and then process them using AWS Events rules and targets.
*
*
* Partner event source names follow this format:
*
*
* partner_name/event_namespace/event_name
*
*
* partner_name is determined during partner registration and identifies the partner to AWS customers.
* event_namespace is determined by the partner and is a way for the partner to categorize their events.
* event_name is determined by the partner, and should uniquely identify an event-generating resource within
* the partner system. The combination of event_namespace and event_name should help AWS customers
* decide whether to create an event bus to receive these events.
*
*
* @param createPartnerEventSourceRequest
* @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 CreatePartnerEventSource operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.CreatePartnerEventSource
* @see AWS API Documentation
*/
java.util.concurrent.Future createPartnerEventSourceAsync(CreatePartnerEventSourceRequest createPartnerEventSourceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* You can use this operation to temporarily stop receiving events from the specified partner event source. The
* matching event bus is not deleted.
*
*
* When you deactivate a partner event source, the source goes into PENDING state. If it remains in PENDING state
* for more than two weeks, it is deleted.
*
*
* To activate a deactivated partner event source, use ActivateEventSource.
*
*
* @param deactivateEventSourceRequest
* @return A Java Future containing the result of the DeactivateEventSource operation returned by the service.
* @sample AmazonEventBridgeAsync.DeactivateEventSource
* @see AWS API Documentation
*/
java.util.concurrent.Future deactivateEventSourceAsync(DeactivateEventSourceRequest deactivateEventSourceRequest);
/**
*
* You can use this operation to temporarily stop receiving events from the specified partner event source. The
* matching event bus is not deleted.
*
*
* When you deactivate a partner event source, the source goes into PENDING state. If it remains in PENDING state
* for more than two weeks, it is deleted.
*
*
* To activate a deactivated partner event source, use ActivateEventSource.
*
*
* @param deactivateEventSourceRequest
* @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 DeactivateEventSource operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.DeactivateEventSource
* @see AWS API Documentation
*/
java.util.concurrent.Future deactivateEventSourceAsync(DeactivateEventSourceRequest deactivateEventSourceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Deletes the specified archive.
*
*
* @param deleteArchiveRequest
* @return A Java Future containing the result of the DeleteArchive operation returned by the service.
* @sample AmazonEventBridgeAsync.DeleteArchive
* @see AWS API
* Documentation
*/
java.util.concurrent.Future deleteArchiveAsync(DeleteArchiveRequest deleteArchiveRequest);
/**
*
* Deletes the specified archive.
*
*
* @param deleteArchiveRequest
* @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 DeleteArchive operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.DeleteArchive
* @see AWS API
* Documentation
*/
java.util.concurrent.Future deleteArchiveAsync(DeleteArchiveRequest deleteArchiveRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Deletes the specified custom event bus or partner event bus. All rules associated with this event bus need to be
* deleted. You can't delete your account's default event bus.
*
*
* @param deleteEventBusRequest
* @return A Java Future containing the result of the DeleteEventBus operation returned by the service.
* @sample AmazonEventBridgeAsync.DeleteEventBus
* @see AWS API
* Documentation
*/
java.util.concurrent.Future deleteEventBusAsync(DeleteEventBusRequest deleteEventBusRequest);
/**
*
* Deletes the specified custom event bus or partner event bus. All rules associated with this event bus need to be
* deleted. You can't delete your account's default event bus.
*
*
* @param deleteEventBusRequest
* @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 DeleteEventBus operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.DeleteEventBus
* @see AWS API
* Documentation
*/
java.util.concurrent.Future deleteEventBusAsync(DeleteEventBusRequest deleteEventBusRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation is used by SaaS partners to delete a partner event source. This operation is not used by AWS
* customers.
*
*
* When you delete an event source, the status of the corresponding partner event bus in the AWS customer account
* becomes DELETED.
*
*
*
* @param deletePartnerEventSourceRequest
* @return A Java Future containing the result of the DeletePartnerEventSource operation returned by the service.
* @sample AmazonEventBridgeAsync.DeletePartnerEventSource
* @see AWS API Documentation
*/
java.util.concurrent.Future deletePartnerEventSourceAsync(DeletePartnerEventSourceRequest deletePartnerEventSourceRequest);
/**
*
* This operation is used by SaaS partners to delete a partner event source. This operation is not used by AWS
* customers.
*
*
* When you delete an event source, the status of the corresponding partner event bus in the AWS customer account
* becomes DELETED.
*
*
*
* @param deletePartnerEventSourceRequest
* @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 DeletePartnerEventSource operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.DeletePartnerEventSource
* @see AWS API Documentation
*/
java.util.concurrent.Future deletePartnerEventSourceAsync(DeletePartnerEventSourceRequest deletePartnerEventSourceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Deletes the specified rule.
*
*
* Before you can delete the rule, you must remove all targets, using RemoveTargets.
*
*
* When you delete a rule, incoming events might continue to match to the deleted rule. Allow a short period of time
* for changes to take effect.
*
*
* Managed rules are rules created and managed by another AWS service on your behalf. These rules are created by
* those other AWS services to support functionality in those services. You can delete these rules using the
* Force option, but you should do so only if you are sure the other service is not still using that
* rule.
*
*
* @param deleteRuleRequest
* @return A Java Future containing the result of the DeleteRule operation returned by the service.
* @sample AmazonEventBridgeAsync.DeleteRule
* @see AWS API
* Documentation
*/
java.util.concurrent.Future deleteRuleAsync(DeleteRuleRequest deleteRuleRequest);
/**
*
* Deletes the specified rule.
*
*
* Before you can delete the rule, you must remove all targets, using RemoveTargets.
*
*
* When you delete a rule, incoming events might continue to match to the deleted rule. Allow a short period of time
* for changes to take effect.
*
*
* Managed rules are rules created and managed by another AWS service on your behalf. These rules are created by
* those other AWS services to support functionality in those services. You can delete these rules using the
* Force option, but you should do so only if you are sure the other service is not still using that
* rule.
*
*
* @param deleteRuleRequest
* @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 DeleteRule operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.DeleteRule
* @see AWS API
* Documentation
*/
java.util.concurrent.Future deleteRuleAsync(DeleteRuleRequest deleteRuleRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Retrieves details about an archive.
*
*
* @param describeArchiveRequest
* @return A Java Future containing the result of the DescribeArchive operation returned by the service.
* @sample AmazonEventBridgeAsync.DescribeArchive
* @see AWS
* API Documentation
*/
java.util.concurrent.Future describeArchiveAsync(DescribeArchiveRequest describeArchiveRequest);
/**
*
* Retrieves details about an archive.
*
*
* @param describeArchiveRequest
* @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 DescribeArchive operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.DescribeArchive
* @see AWS
* API Documentation
*/
java.util.concurrent.Future describeArchiveAsync(DescribeArchiveRequest describeArchiveRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Displays details about an event bus in your account. This can include the external AWS accounts that are
* permitted to write events to your default event bus, and the associated policy. For custom event buses and
* partner event buses, it displays the name, ARN, policy, state, and creation time.
*
*
* To enable your account to receive events from other accounts on its default event bus, use PutPermission.
*
*
* For more information about partner event buses, see CreateEventBus.
*
*
* @param describeEventBusRequest
* @return A Java Future containing the result of the DescribeEventBus operation returned by the service.
* @sample AmazonEventBridgeAsync.DescribeEventBus
* @see AWS
* API Documentation
*/
java.util.concurrent.Future describeEventBusAsync(DescribeEventBusRequest describeEventBusRequest);
/**
*
* Displays details about an event bus in your account. This can include the external AWS accounts that are
* permitted to write events to your default event bus, and the associated policy. For custom event buses and
* partner event buses, it displays the name, ARN, policy, state, and creation time.
*
*
* To enable your account to receive events from other accounts on its default event bus, use PutPermission.
*
*
* For more information about partner event buses, see CreateEventBus.
*
*
* @param describeEventBusRequest
* @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 DescribeEventBus operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.DescribeEventBus
* @see AWS
* API Documentation
*/
java.util.concurrent.Future describeEventBusAsync(DescribeEventBusRequest describeEventBusRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation lists details about a partner event source that is shared with your account.
*
*
* @param describeEventSourceRequest
* @return A Java Future containing the result of the DescribeEventSource operation returned by the service.
* @sample AmazonEventBridgeAsync.DescribeEventSource
* @see AWS API Documentation
*/
java.util.concurrent.Future describeEventSourceAsync(DescribeEventSourceRequest describeEventSourceRequest);
/**
*
* This operation lists details about a partner event source that is shared with your account.
*
*
* @param describeEventSourceRequest
* @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 DescribeEventSource operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.DescribeEventSource
* @see AWS API Documentation
*/
java.util.concurrent.Future describeEventSourceAsync(DescribeEventSourceRequest describeEventSourceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* An SaaS partner can use this operation to list details about a partner event source that they have created. AWS
* customers do not use this operation. Instead, AWS customers can use DescribeEventSource to see details
* about a partner event source that is shared with them.
*
*
* @param describePartnerEventSourceRequest
* @return A Java Future containing the result of the DescribePartnerEventSource operation returned by the service.
* @sample AmazonEventBridgeAsync.DescribePartnerEventSource
* @see AWS API Documentation
*/
java.util.concurrent.Future describePartnerEventSourceAsync(
DescribePartnerEventSourceRequest describePartnerEventSourceRequest);
/**
*
* An SaaS partner can use this operation to list details about a partner event source that they have created. AWS
* customers do not use this operation. Instead, AWS customers can use DescribeEventSource to see details
* about a partner event source that is shared with them.
*
*
* @param describePartnerEventSourceRequest
* @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 DescribePartnerEventSource operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.DescribePartnerEventSource
* @see AWS API Documentation
*/
java.util.concurrent.Future describePartnerEventSourceAsync(
DescribePartnerEventSourceRequest describePartnerEventSourceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Retrieves details about a replay. Use DescribeReplay to determine the progress of a running replay.
* A replay processes events to replay based on the time in the event, and replays them using 1 minute intervals. If
* you use StartReplay and specify an EventStartTime and an EventEndTime that
* covers a 20 minute time range, the events are replayed from the first minute of that 20 minute range first. Then
* the events from the second minute are replayed. You can use DescribeReplay to determine the progress
* of a replay. The value returned for EventLastReplayedTime indicates the time within the specified
* time range associated with the last event replayed.
*
*
* @param describeReplayRequest
* @return A Java Future containing the result of the DescribeReplay operation returned by the service.
* @sample AmazonEventBridgeAsync.DescribeReplay
* @see AWS API
* Documentation
*/
java.util.concurrent.Future describeReplayAsync(DescribeReplayRequest describeReplayRequest);
/**
*
* Retrieves details about a replay. Use DescribeReplay to determine the progress of a running replay.
* A replay processes events to replay based on the time in the event, and replays them using 1 minute intervals. If
* you use StartReplay and specify an EventStartTime and an EventEndTime that
* covers a 20 minute time range, the events are replayed from the first minute of that 20 minute range first. Then
* the events from the second minute are replayed. You can use DescribeReplay to determine the progress
* of a replay. The value returned for EventLastReplayedTime indicates the time within the specified
* time range associated with the last event replayed.
*
*
* @param describeReplayRequest
* @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 DescribeReplay operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.DescribeReplay
* @see AWS API
* Documentation
*/
java.util.concurrent.Future describeReplayAsync(DescribeReplayRequest describeReplayRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Describes the specified rule.
*
*
* DescribeRule does not list the targets of a rule. To see the targets associated with a rule, use
* ListTargetsByRule.
*
*
* @param describeRuleRequest
* @return A Java Future containing the result of the DescribeRule operation returned by the service.
* @sample AmazonEventBridgeAsync.DescribeRule
* @see AWS API
* Documentation
*/
java.util.concurrent.Future describeRuleAsync(DescribeRuleRequest describeRuleRequest);
/**
*
* Describes the specified rule.
*
*
* DescribeRule does not list the targets of a rule. To see the targets associated with a rule, use
* ListTargetsByRule.
*
*
* @param describeRuleRequest
* @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 DescribeRule operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.DescribeRule
* @see AWS API
* Documentation
*/
java.util.concurrent.Future describeRuleAsync(DescribeRuleRequest describeRuleRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Disables the specified rule. A disabled rule won't match any events, and won't self-trigger if it has a schedule
* expression.
*
*
* When you disable a rule, incoming events might continue to match to the disabled rule. Allow a short period of
* time for changes to take effect.
*
*
* @param disableRuleRequest
* @return A Java Future containing the result of the DisableRule operation returned by the service.
* @sample AmazonEventBridgeAsync.DisableRule
* @see AWS API
* Documentation
*/
java.util.concurrent.Future disableRuleAsync(DisableRuleRequest disableRuleRequest);
/**
*
* Disables the specified rule. A disabled rule won't match any events, and won't self-trigger if it has a schedule
* expression.
*
*
* When you disable a rule, incoming events might continue to match to the disabled rule. Allow a short period of
* time for changes to take effect.
*
*
* @param disableRuleRequest
* @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 DisableRule operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.DisableRule
* @see AWS API
* Documentation
*/
java.util.concurrent.Future disableRuleAsync(DisableRuleRequest disableRuleRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Enables the specified rule. If the rule does not exist, the operation fails.
*
*
* When you enable a rule, incoming events might not immediately start matching to a newly enabled rule. Allow a
* short period of time for changes to take effect.
*
*
* @param enableRuleRequest
* @return A Java Future containing the result of the EnableRule operation returned by the service.
* @sample AmazonEventBridgeAsync.EnableRule
* @see AWS API
* Documentation
*/
java.util.concurrent.Future enableRuleAsync(EnableRuleRequest enableRuleRequest);
/**
*
* Enables the specified rule. If the rule does not exist, the operation fails.
*
*
* When you enable a rule, incoming events might not immediately start matching to a newly enabled rule. Allow a
* short period of time for changes to take effect.
*
*
* @param enableRuleRequest
* @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 EnableRule operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.EnableRule
* @see AWS API
* Documentation
*/
java.util.concurrent.Future enableRuleAsync(EnableRuleRequest enableRuleRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Lists your archives. You can either list all the archives or you can provide a prefix to match to the archive
* names. Filter parameters are exclusive.
*
*
* @param listArchivesRequest
* @return A Java Future containing the result of the ListArchives operation returned by the service.
* @sample AmazonEventBridgeAsync.ListArchives
* @see AWS API
* Documentation
*/
java.util.concurrent.Future listArchivesAsync(ListArchivesRequest listArchivesRequest);
/**
*
* Lists your archives. You can either list all the archives or you can provide a prefix to match to the archive
* names. Filter parameters are exclusive.
*
*
* @param listArchivesRequest
* @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 ListArchives operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.ListArchives
* @see AWS API
* Documentation
*/
java.util.concurrent.Future listArchivesAsync(ListArchivesRequest listArchivesRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Lists all the event buses in your account, including the default event bus, custom event buses, and partner event
* buses.
*
*
* @param listEventBusesRequest
* @return A Java Future containing the result of the ListEventBuses operation returned by the service.
* @sample AmazonEventBridgeAsync.ListEventBuses
* @see AWS API
* Documentation
*/
java.util.concurrent.Future listEventBusesAsync(ListEventBusesRequest listEventBusesRequest);
/**
*
* Lists all the event buses in your account, including the default event bus, custom event buses, and partner event
* buses.
*
*
* @param listEventBusesRequest
* @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 ListEventBuses operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.ListEventBuses
* @see AWS API
* Documentation
*/
java.util.concurrent.Future listEventBusesAsync(ListEventBusesRequest listEventBusesRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* You can use this to see all the partner event sources that have been shared with your AWS account. For more
* information about partner event sources, see CreateEventBus.
*
*
* @param listEventSourcesRequest
* @return A Java Future containing the result of the ListEventSources operation returned by the service.
* @sample AmazonEventBridgeAsync.ListEventSources
* @see AWS
* API Documentation
*/
java.util.concurrent.Future listEventSourcesAsync(ListEventSourcesRequest listEventSourcesRequest);
/**
*
* You can use this to see all the partner event sources that have been shared with your AWS account. For more
* information about partner event sources, see CreateEventBus.
*
*
* @param listEventSourcesRequest
* @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 ListEventSources operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.ListEventSources
* @see AWS
* API Documentation
*/
java.util.concurrent.Future listEventSourcesAsync(ListEventSourcesRequest listEventSourcesRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* An SaaS partner can use this operation to display the AWS account ID that a particular partner event source name
* is associated with. This operation is not used by AWS customers.
*
*
* @param listPartnerEventSourceAccountsRequest
* @return A Java Future containing the result of the ListPartnerEventSourceAccounts operation returned by the
* service.
* @sample AmazonEventBridgeAsync.ListPartnerEventSourceAccounts
* @see AWS API Documentation
*/
java.util.concurrent.Future listPartnerEventSourceAccountsAsync(
ListPartnerEventSourceAccountsRequest listPartnerEventSourceAccountsRequest);
/**
*
* An SaaS partner can use this operation to display the AWS account ID that a particular partner event source name
* is associated with. This operation is not used by AWS customers.
*
*
* @param listPartnerEventSourceAccountsRequest
* @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 ListPartnerEventSourceAccounts operation returned by the
* service.
* @sample AmazonEventBridgeAsyncHandler.ListPartnerEventSourceAccounts
* @see AWS API Documentation
*/
java.util.concurrent.Future listPartnerEventSourceAccountsAsync(
ListPartnerEventSourceAccountsRequest listPartnerEventSourceAccountsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* An SaaS partner can use this operation to list all the partner event source names that they have created. This
* operation is not used by AWS customers.
*
*
* @param listPartnerEventSourcesRequest
* @return A Java Future containing the result of the ListPartnerEventSources operation returned by the service.
* @sample AmazonEventBridgeAsync.ListPartnerEventSources
* @see AWS API Documentation
*/
java.util.concurrent.Future listPartnerEventSourcesAsync(ListPartnerEventSourcesRequest listPartnerEventSourcesRequest);
/**
*
* An SaaS partner can use this operation to list all the partner event source names that they have created. This
* operation is not used by AWS customers.
*
*
* @param listPartnerEventSourcesRequest
* @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 ListPartnerEventSources operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.ListPartnerEventSources
* @see AWS API Documentation
*/
java.util.concurrent.Future listPartnerEventSourcesAsync(ListPartnerEventSourcesRequest listPartnerEventSourcesRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Lists your replays. You can either list all the replays or you can provide a prefix to match to the replay names.
* Filter parameters are exclusive.
*
*
* @param listReplaysRequest
* @return A Java Future containing the result of the ListReplays operation returned by the service.
* @sample AmazonEventBridgeAsync.ListReplays
* @see AWS API
* Documentation
*/
java.util.concurrent.Future listReplaysAsync(ListReplaysRequest listReplaysRequest);
/**
*
* Lists your replays. You can either list all the replays or you can provide a prefix to match to the replay names.
* Filter parameters are exclusive.
*
*
* @param listReplaysRequest
* @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 ListReplays operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.ListReplays
* @see AWS API
* Documentation
*/
java.util.concurrent.Future listReplaysAsync(ListReplaysRequest listReplaysRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Lists the rules for the specified target. You can see which of the rules in Amazon EventBridge can invoke a
* specific target in your account.
*
*
* @param listRuleNamesByTargetRequest
* @return A Java Future containing the result of the ListRuleNamesByTarget operation returned by the service.
* @sample AmazonEventBridgeAsync.ListRuleNamesByTarget
* @see AWS API Documentation
*/
java.util.concurrent.Future listRuleNamesByTargetAsync(ListRuleNamesByTargetRequest listRuleNamesByTargetRequest);
/**
*
* Lists the rules for the specified target. You can see which of the rules in Amazon EventBridge can invoke a
* specific target in your account.
*
*
* @param listRuleNamesByTargetRequest
* @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 ListRuleNamesByTarget operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.ListRuleNamesByTarget
* @see AWS API Documentation
*/
java.util.concurrent.Future listRuleNamesByTargetAsync(ListRuleNamesByTargetRequest listRuleNamesByTargetRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Lists your Amazon EventBridge rules. You can either list all the rules or you can provide a prefix to match to
* the rule names.
*
*
* ListRules does not list the targets of a rule. To see the targets associated with a rule, use
* ListTargetsByRule.
*
*
* @param listRulesRequest
* @return A Java Future containing the result of the ListRules operation returned by the service.
* @sample AmazonEventBridgeAsync.ListRules
* @see AWS API
* Documentation
*/
java.util.concurrent.Future listRulesAsync(ListRulesRequest listRulesRequest);
/**
*
* Lists your Amazon EventBridge rules. You can either list all the rules or you can provide a prefix to match to
* the rule names.
*
*
* ListRules does not list the targets of a rule. To see the targets associated with a rule, use
* ListTargetsByRule.
*
*
* @param listRulesRequest
* @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 ListRules operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.ListRules
* @see AWS API
* Documentation
*/
java.util.concurrent.Future listRulesAsync(ListRulesRequest listRulesRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Displays the tags associated with an EventBridge resource. In EventBridge, rules and event buses can be tagged.
*
*
* @param listTagsForResourceRequest
* @return A Java Future containing the result of the ListTagsForResource operation returned by the service.
* @sample AmazonEventBridgeAsync.ListTagsForResource
* @see AWS API Documentation
*/
java.util.concurrent.Future listTagsForResourceAsync(ListTagsForResourceRequest listTagsForResourceRequest);
/**
*
* Displays the tags associated with an EventBridge resource. In EventBridge, rules and event buses can be tagged.
*
*
* @param listTagsForResourceRequest
* @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 ListTagsForResource operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.ListTagsForResource
* @see AWS API Documentation
*/
java.util.concurrent.Future listTagsForResourceAsync(ListTagsForResourceRequest listTagsForResourceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Lists the targets assigned to the specified rule.
*
*
* @param listTargetsByRuleRequest
* @return A Java Future containing the result of the ListTargetsByRule operation returned by the service.
* @sample AmazonEventBridgeAsync.ListTargetsByRule
* @see AWS
* API Documentation
*/
java.util.concurrent.Future listTargetsByRuleAsync(ListTargetsByRuleRequest listTargetsByRuleRequest);
/**
*
* Lists the targets assigned to the specified rule.
*
*
* @param listTargetsByRuleRequest
* @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 ListTargetsByRule operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.ListTargetsByRule
* @see AWS
* API Documentation
*/
java.util.concurrent.Future listTargetsByRuleAsync(ListTargetsByRuleRequest listTargetsByRuleRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Sends custom events to Amazon EventBridge so that they can be matched to rules.
*
*
* @param putEventsRequest
* @return A Java Future containing the result of the PutEvents operation returned by the service.
* @sample AmazonEventBridgeAsync.PutEvents
* @see AWS API
* Documentation
*/
java.util.concurrent.Future putEventsAsync(PutEventsRequest putEventsRequest);
/**
*
* Sends custom events to Amazon EventBridge so that they can be matched to rules.
*
*
* @param putEventsRequest
* @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 PutEvents operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.PutEvents
* @see AWS API
* Documentation
*/
java.util.concurrent.Future putEventsAsync(PutEventsRequest putEventsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This is used by SaaS partners to write events to a customer's partner event bus. AWS customers do not use this
* operation.
*
*
* @param putPartnerEventsRequest
* @return A Java Future containing the result of the PutPartnerEvents operation returned by the service.
* @sample AmazonEventBridgeAsync.PutPartnerEvents
* @see AWS
* API Documentation
*/
java.util.concurrent.Future putPartnerEventsAsync(PutPartnerEventsRequest putPartnerEventsRequest);
/**
*
* This is used by SaaS partners to write events to a customer's partner event bus. AWS customers do not use this
* operation.
*
*
* @param putPartnerEventsRequest
* @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 PutPartnerEvents operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.PutPartnerEvents
* @see AWS
* API Documentation
*/
java.util.concurrent.Future putPartnerEventsAsync(PutPartnerEventsRequest putPartnerEventsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Running PutPermission permits the specified AWS account or AWS organization to put events to the
* specified event bus. Amazon EventBridge (CloudWatch Events) rules in your account are triggered by these
* events arriving to an event bus in your account.
*
*
* For another account to send events to your account, that external account must have an EventBridge rule with your
* account's event bus as a target.
*
*
* To enable multiple AWS accounts to put events to your event bus, run PutPermission once for each of
* these accounts. Or, if all the accounts are members of the same AWS organization, you can run
* PutPermission once specifying Principal as "*" and specifying the AWS organization ID
* in Condition, to grant permissions to all accounts in that organization.
*
*
* If you grant permissions using an organization, then accounts in that organization must specify a
* RoleArn with proper permissions when they use PutTarget to add your account's event bus
* as a target. For more information, see Sending and Receiving Events Between AWS Accounts in the Amazon EventBridge User Guide.
*
*
* The permission policy on the default event bus cannot exceed 10 KB in size.
*
*
* @param putPermissionRequest
* @return A Java Future containing the result of the PutPermission operation returned by the service.
* @sample AmazonEventBridgeAsync.PutPermission
* @see AWS API
* Documentation
*/
java.util.concurrent.Future putPermissionAsync(PutPermissionRequest putPermissionRequest);
/**
*
* Running PutPermission permits the specified AWS account or AWS organization to put events to the
* specified event bus. Amazon EventBridge (CloudWatch Events) rules in your account are triggered by these
* events arriving to an event bus in your account.
*
*
* For another account to send events to your account, that external account must have an EventBridge rule with your
* account's event bus as a target.
*
*
* To enable multiple AWS accounts to put events to your event bus, run PutPermission once for each of
* these accounts. Or, if all the accounts are members of the same AWS organization, you can run
* PutPermission once specifying Principal as "*" and specifying the AWS organization ID
* in Condition, to grant permissions to all accounts in that organization.
*
*
* If you grant permissions using an organization, then accounts in that organization must specify a
* RoleArn with proper permissions when they use PutTarget to add your account's event bus
* as a target. For more information, see Sending and Receiving Events Between AWS Accounts in the Amazon EventBridge User Guide.
*
*
* The permission policy on the default event bus cannot exceed 10 KB in size.
*
*
* @param putPermissionRequest
* @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 PutPermission operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.PutPermission
* @see AWS API
* Documentation
*/
java.util.concurrent.Future putPermissionAsync(PutPermissionRequest putPermissionRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Creates or updates the specified rule. Rules are enabled by default, or based on value of the state. You can
* disable a rule using DisableRule.
*
*
* A single rule watches for events from a single event bus. Events generated by AWS services go to your account's
* default event bus. Events generated by SaaS partner services or applications go to the matching partner event
* bus. If you have custom applications or services, you can specify whether their events go to your default event
* bus or a custom event bus that you have created. For more information, see CreateEventBus.
*
*
* If you are updating an existing rule, the rule is replaced with what you specify in this PutRule
* command. If you omit arguments in PutRule, the old values for those arguments are not kept. Instead,
* they are replaced with null values.
*
*
* When you create or update a rule, incoming events might not immediately start matching to new or updated rules.
* Allow a short period of time for changes to take effect.
*
*
* A rule must contain at least an EventPattern or ScheduleExpression. Rules with EventPatterns are triggered when a
* matching event is observed. Rules with ScheduleExpressions self-trigger based on the given schedule. A rule can
* have both an EventPattern and a ScheduleExpression, in which case the rule triggers on matching events as well as
* on a schedule.
*
*
* When you initially create a rule, you can optionally assign one or more tags to the rule. Tags can help you
* organize and categorize your resources. You can also use them to scope user permissions, by granting a user
* permission to access or change only rules with certain tag values. To use the PutRule operation and
* assign tags, you must have both the events:PutRule and events:TagResource permissions.
*
*
* If you are updating an existing rule, any tags you specify in the PutRule operation are ignored. To
* update the tags of an existing rule, use TagResource and UntagResource.
*
*
* Most services in AWS treat : or / as the same character in Amazon Resource Names (ARNs). However, EventBridge
* uses an exact match in event patterns and rules. Be sure to use the correct ARN characters when creating event
* patterns so that they match the ARN syntax in the event you want to match.
*
*
* In EventBridge, it is possible to create rules that lead to infinite loops, where a rule is fired repeatedly. For
* example, a rule might detect that ACLs have changed on an S3 bucket, and trigger software to change them to the
* desired state. If the rule is not written carefully, the subsequent change to the ACLs fires the rule again,
* creating an infinite loop.
*
*
* To prevent this, write the rules so that the triggered actions do not re-fire the same rule. For example, your
* rule could fire only if ACLs are found to be in a bad state, instead of after any change.
*
*
* An infinite loop can quickly cause higher than expected charges. We recommend that you use budgeting, which
* alerts you when charges exceed your specified limit. For more information, see Managing Your
* Costs with Budgets.
*
*
* @param putRuleRequest
* @return A Java Future containing the result of the PutRule operation returned by the service.
* @sample AmazonEventBridgeAsync.PutRule
* @see AWS API
* Documentation
*/
java.util.concurrent.Future putRuleAsync(PutRuleRequest putRuleRequest);
/**
*
* Creates or updates the specified rule. Rules are enabled by default, or based on value of the state. You can
* disable a rule using DisableRule.
*
*
* A single rule watches for events from a single event bus. Events generated by AWS services go to your account's
* default event bus. Events generated by SaaS partner services or applications go to the matching partner event
* bus. If you have custom applications or services, you can specify whether their events go to your default event
* bus or a custom event bus that you have created. For more information, see CreateEventBus.
*
*
* If you are updating an existing rule, the rule is replaced with what you specify in this PutRule
* command. If you omit arguments in PutRule, the old values for those arguments are not kept. Instead,
* they are replaced with null values.
*
*
* When you create or update a rule, incoming events might not immediately start matching to new or updated rules.
* Allow a short period of time for changes to take effect.
*
*
* A rule must contain at least an EventPattern or ScheduleExpression. Rules with EventPatterns are triggered when a
* matching event is observed. Rules with ScheduleExpressions self-trigger based on the given schedule. A rule can
* have both an EventPattern and a ScheduleExpression, in which case the rule triggers on matching events as well as
* on a schedule.
*
*
* When you initially create a rule, you can optionally assign one or more tags to the rule. Tags can help you
* organize and categorize your resources. You can also use them to scope user permissions, by granting a user
* permission to access or change only rules with certain tag values. To use the PutRule operation and
* assign tags, you must have both the events:PutRule and events:TagResource permissions.
*
*
* If you are updating an existing rule, any tags you specify in the PutRule operation are ignored. To
* update the tags of an existing rule, use TagResource and UntagResource.
*
*
* Most services in AWS treat : or / as the same character in Amazon Resource Names (ARNs). However, EventBridge
* uses an exact match in event patterns and rules. Be sure to use the correct ARN characters when creating event
* patterns so that they match the ARN syntax in the event you want to match.
*
*
* In EventBridge, it is possible to create rules that lead to infinite loops, where a rule is fired repeatedly. For
* example, a rule might detect that ACLs have changed on an S3 bucket, and trigger software to change them to the
* desired state. If the rule is not written carefully, the subsequent change to the ACLs fires the rule again,
* creating an infinite loop.
*
*
* To prevent this, write the rules so that the triggered actions do not re-fire the same rule. For example, your
* rule could fire only if ACLs are found to be in a bad state, instead of after any change.
*
*
* An infinite loop can quickly cause higher than expected charges. We recommend that you use budgeting, which
* alerts you when charges exceed your specified limit. For more information, see Managing Your
* Costs with Budgets.
*
*
* @param putRuleRequest
* @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 PutRule operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.PutRule
* @see AWS API
* Documentation
*/
java.util.concurrent.Future putRuleAsync(PutRuleRequest putRuleRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Adds the specified targets to the specified rule, or updates the targets if they are already associated with the
* rule.
*
*
* Targets are the resources that are invoked when a rule is triggered.
*
*
* You can configure the following as targets for Events:
*
*
* -
*
* EC2 instances
*
*
* -
*
* SSM Run Command
*
*
* -
*
* SSM Automation
*
*
* -
*
* AWS Lambda functions
*
*
* -
*
* Data streams in Amazon Kinesis Data Streams
*
*
* -
*
* Data delivery streams in Amazon Kinesis Data Firehose
*
*
* -
*
* Amazon ECS tasks
*
*
* -
*
* AWS Step Functions state machines
*
*
* -
*
* AWS Batch jobs
*
*
* -
*
* AWS CodeBuild projects
*
*
* -
*
* Pipelines in AWS CodePipeline
*
*
* -
*
* Amazon Inspector assessment templates
*
*
* -
*
* Amazon SNS topics
*
*
* -
*
* Amazon SQS queues, including FIFO queues
*
*
* -
*
* The default event bus of another AWS account
*
*
* -
*
* Amazon API Gateway REST APIs
*
*
* -
*
* Redshift Clusters to invoke Data API ExecuteStatement on
*
*
*
*
* Creating rules with built-in targets is supported only in the AWS Management Console. The built-in targets are
* EC2 CreateSnapshot API call, EC2 RebootInstances API call,
* EC2 StopInstances API call, and EC2 TerminateInstances API call.
*
*
* For some target types, PutTargets provides target-specific parameters. If the target is a Kinesis
* data stream, you can optionally specify which shard the event goes to by using the KinesisParameters
* argument. To invoke a command on multiple EC2 instances with one rule, you can use the
* RunCommandParameters field.
*
*
* To be able to make API calls against the resources that you own, Amazon EventBridge (CloudWatch Events) needs the
* appropriate permissions. For AWS Lambda and Amazon SNS resources, EventBridge relies on resource-based policies.
* For EC2 instances, Kinesis data streams, AWS Step Functions state machines and API Gateway REST APIs, EventBridge
* relies on IAM roles that you specify in the RoleARN argument in PutTargets. For more
* information, see Authentication and Access Control in the Amazon EventBridge User Guide.
*
*
* If another AWS account is in the same region and has granted you permission (using PutPermission),
* you can send events to that account. Set that account's event bus as a target of the rules in your account. To
* send the matched events to the other account, specify that account's event bus as the Arn value when
* you run PutTargets. If your account sends events to another account, your account is charged for
* each sent event. Each event sent to another account is charged as a custom event. The account receiving the event
* is not charged. For more information, see Amazon
* EventBridge (CloudWatch Events) Pricing.
*
*
*
* Input, InputPath, and InputTransformer are not available with
* PutTarget if the target is an event bus of a different AWS account.
*
*
*
* If you are setting the event bus of another account as the target, and that account granted permission to your
* account through an organization instead of directly by the account ID, then you must specify a
* RoleArn with proper permissions in the Target structure. For more information, see
* Sending and Receiving Events Between AWS Accounts in the Amazon EventBridge User Guide.
*
*
* For more information about enabling cross-account events, see PutPermission.
*
*
* Input, InputPath, and InputTransformer are mutually exclusive and optional parameters of a
* target. When a rule is triggered due to a matched event:
*
*
* -
*
* If none of the following arguments are specified for a target, then the entire event is passed to the target in
* JSON format (unless the target is Amazon EC2 Run Command or Amazon ECS task, in which case nothing from the event
* is passed to the target).
*
*
* -
*
* If Input is specified in the form of valid JSON, then the matched event is overridden with this constant.
*
*
* -
*
* If InputPath is specified in the form of JSONPath (for example, $.detail), then only the part
* of the event specified in the path is passed to the target (for example, only the detail part of the event is
* passed).
*
*
* -
*
* If InputTransformer is specified, then one or more specified JSONPaths are extracted from the event and
* used as values in a template that you specify as the input to the target.
*
*
*
*
* When you specify InputPath or InputTransformer, you must use JSON dot notation, not
* bracket notation.
*
*
* When you add targets to a rule and the associated rule triggers soon after, new or updated targets might not be
* immediately invoked. Allow a short period of time for changes to take effect.
*
*
* This action can partially fail if too many requests are made at the same time. If that happens,
* FailedEntryCount is non-zero in the response and each entry in FailedEntries provides
* the ID of the failed target and the error code.
*
*
* @param putTargetsRequest
* @return A Java Future containing the result of the PutTargets operation returned by the service.
* @sample AmazonEventBridgeAsync.PutTargets
* @see AWS API
* Documentation
*/
java.util.concurrent.Future putTargetsAsync(PutTargetsRequest putTargetsRequest);
/**
*
* Adds the specified targets to the specified rule, or updates the targets if they are already associated with the
* rule.
*
*
* Targets are the resources that are invoked when a rule is triggered.
*
*
* You can configure the following as targets for Events:
*
*
* -
*
* EC2 instances
*
*
* -
*
* SSM Run Command
*
*
* -
*
* SSM Automation
*
*
* -
*
* AWS Lambda functions
*
*
* -
*
* Data streams in Amazon Kinesis Data Streams
*
*
* -
*
* Data delivery streams in Amazon Kinesis Data Firehose
*
*
* -
*
* Amazon ECS tasks
*
*
* -
*
* AWS Step Functions state machines
*
*
* -
*
* AWS Batch jobs
*
*
* -
*
* AWS CodeBuild projects
*
*
* -
*
* Pipelines in AWS CodePipeline
*
*
* -
*
* Amazon Inspector assessment templates
*
*
* -
*
* Amazon SNS topics
*
*
* -
*
* Amazon SQS queues, including FIFO queues
*
*
* -
*
* The default event bus of another AWS account
*
*
* -
*
* Amazon API Gateway REST APIs
*
*
* -
*
* Redshift Clusters to invoke Data API ExecuteStatement on
*
*
*
*
* Creating rules with built-in targets is supported only in the AWS Management Console. The built-in targets are
* EC2 CreateSnapshot API call, EC2 RebootInstances API call,
* EC2 StopInstances API call, and EC2 TerminateInstances API call.
*
*
* For some target types, PutTargets provides target-specific parameters. If the target is a Kinesis
* data stream, you can optionally specify which shard the event goes to by using the KinesisParameters
* argument. To invoke a command on multiple EC2 instances with one rule, you can use the
* RunCommandParameters field.
*
*
* To be able to make API calls against the resources that you own, Amazon EventBridge (CloudWatch Events) needs the
* appropriate permissions. For AWS Lambda and Amazon SNS resources, EventBridge relies on resource-based policies.
* For EC2 instances, Kinesis data streams, AWS Step Functions state machines and API Gateway REST APIs, EventBridge
* relies on IAM roles that you specify in the RoleARN argument in PutTargets. For more
* information, see Authentication and Access Control in the Amazon EventBridge User Guide.
*
*
* If another AWS account is in the same region and has granted you permission (using PutPermission),
* you can send events to that account. Set that account's event bus as a target of the rules in your account. To
* send the matched events to the other account, specify that account's event bus as the Arn value when
* you run PutTargets. If your account sends events to another account, your account is charged for
* each sent event. Each event sent to another account is charged as a custom event. The account receiving the event
* is not charged. For more information, see Amazon
* EventBridge (CloudWatch Events) Pricing.
*
*
*
* Input, InputPath, and InputTransformer are not available with
* PutTarget if the target is an event bus of a different AWS account.
*
*
*
* If you are setting the event bus of another account as the target, and that account granted permission to your
* account through an organization instead of directly by the account ID, then you must specify a
* RoleArn with proper permissions in the Target structure. For more information, see
* Sending and Receiving Events Between AWS Accounts in the Amazon EventBridge User Guide.
*
*
* For more information about enabling cross-account events, see PutPermission.
*
*
* Input, InputPath, and InputTransformer are mutually exclusive and optional parameters of a
* target. When a rule is triggered due to a matched event:
*
*
* -
*
* If none of the following arguments are specified for a target, then the entire event is passed to the target in
* JSON format (unless the target is Amazon EC2 Run Command or Amazon ECS task, in which case nothing from the event
* is passed to the target).
*
*
* -
*
* If Input is specified in the form of valid JSON, then the matched event is overridden with this constant.
*
*
* -
*
* If InputPath is specified in the form of JSONPath (for example, $.detail), then only the part
* of the event specified in the path is passed to the target (for example, only the detail part of the event is
* passed).
*
*
* -
*
* If InputTransformer is specified, then one or more specified JSONPaths are extracted from the event and
* used as values in a template that you specify as the input to the target.
*
*
*
*
* When you specify InputPath or InputTransformer, you must use JSON dot notation, not
* bracket notation.
*
*
* When you add targets to a rule and the associated rule triggers soon after, new or updated targets might not be
* immediately invoked. Allow a short period of time for changes to take effect.
*
*
* This action can partially fail if too many requests are made at the same time. If that happens,
* FailedEntryCount is non-zero in the response and each entry in FailedEntries provides
* the ID of the failed target and the error code.
*
*
* @param putTargetsRequest
* @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 PutTargets operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.PutTargets
* @see AWS API
* Documentation
*/
java.util.concurrent.Future putTargetsAsync(PutTargetsRequest putTargetsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Revokes the permission of another AWS account to be able to put events to the specified event bus. Specify the
* account to revoke by the StatementId value that you associated with the account when you granted it
* permission with PutPermission. You can find the StatementId by using
* DescribeEventBus.
*
*
* @param removePermissionRequest
* @return A Java Future containing the result of the RemovePermission operation returned by the service.
* @sample AmazonEventBridgeAsync.RemovePermission
* @see AWS
* API Documentation
*/
java.util.concurrent.Future removePermissionAsync(RemovePermissionRequest removePermissionRequest);
/**
*
* Revokes the permission of another AWS account to be able to put events to the specified event bus. Specify the
* account to revoke by the StatementId value that you associated with the account when you granted it
* permission with PutPermission. You can find the StatementId by using
* DescribeEventBus.
*
*
* @param removePermissionRequest
* @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 RemovePermission operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.RemovePermission
* @see AWS
* API Documentation
*/
java.util.concurrent.Future removePermissionAsync(RemovePermissionRequest removePermissionRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Removes the specified targets from the specified rule. When the rule is triggered, those targets are no longer be
* invoked.
*
*
* When you remove a target, when the associated rule triggers, removed targets might continue to be invoked. Allow
* a short period of time for changes to take effect.
*
*
* This action can partially fail if too many requests are made at the same time. If that happens,
* FailedEntryCount is non-zero in the response and each entry in FailedEntries provides
* the ID of the failed target and the error code.
*
*
* @param removeTargetsRequest
* @return A Java Future containing the result of the RemoveTargets operation returned by the service.
* @sample AmazonEventBridgeAsync.RemoveTargets
* @see AWS API
* Documentation
*/
java.util.concurrent.Future removeTargetsAsync(RemoveTargetsRequest removeTargetsRequest);
/**
*
* Removes the specified targets from the specified rule. When the rule is triggered, those targets are no longer be
* invoked.
*
*
* When you remove a target, when the associated rule triggers, removed targets might continue to be invoked. Allow
* a short period of time for changes to take effect.
*
*
* This action can partially fail if too many requests are made at the same time. If that happens,
* FailedEntryCount is non-zero in the response and each entry in FailedEntries provides
* the ID of the failed target and the error code.
*
*
* @param removeTargetsRequest
* @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 RemoveTargets operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.RemoveTargets
* @see AWS API
* Documentation
*/
java.util.concurrent.Future removeTargetsAsync(RemoveTargetsRequest removeTargetsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Starts the specified replay. Events are not necessarily replayed in the exact same order that they were added to
* the archive. A replay processes events to replay based on the time in the event, and replays them using 1 minute
* intervals. If you specify an EventStartTime and an EventEndTime that covers a 20 minute
* time range, the events are replayed from the first minute of that 20 minute range first. Then the events from the
* second minute are replayed. You can use DescribeReplay to determine the progress of a replay. The
* value returned for EventLastReplayedTime indicates the time within the specified time range
* associated with the last event replayed.
*
*
* @param startReplayRequest
* @return A Java Future containing the result of the StartReplay operation returned by the service.
* @sample AmazonEventBridgeAsync.StartReplay
* @see AWS API
* Documentation
*/
java.util.concurrent.Future startReplayAsync(StartReplayRequest startReplayRequest);
/**
*
* Starts the specified replay. Events are not necessarily replayed in the exact same order that they were added to
* the archive. A replay processes events to replay based on the time in the event, and replays them using 1 minute
* intervals. If you specify an EventStartTime and an EventEndTime that covers a 20 minute
* time range, the events are replayed from the first minute of that 20 minute range first. Then the events from the
* second minute are replayed. You can use DescribeReplay to determine the progress of a replay. The
* value returned for EventLastReplayedTime indicates the time within the specified time range
* associated with the last event replayed.
*
*
* @param startReplayRequest
* @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 StartReplay operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.StartReplay
* @see AWS API
* Documentation
*/
java.util.concurrent.Future startReplayAsync(StartReplayRequest startReplayRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Assigns one or more tags (key-value pairs) to the specified EventBridge resource. Tags can help you organize and
* categorize your resources. You can also use them to scope user permissions by granting a user permission to
* access or change only resources with certain tag values. In EventBridge, rules and event buses can be tagged.
*
*
* Tags don't have any semantic meaning to AWS and are interpreted strictly as strings of characters.
*
*
* You can use the TagResource action with a resource that already has tags. If you specify a new tag
* key, this tag is appended to the list of tags associated with the resource. If you specify a tag key that is
* already associated with the resource, the new tag value that you specify replaces the previous value for that
* tag.
*
*
* You can associate as many as 50 tags with a resource.
*
*
* @param tagResourceRequest
* @return A Java Future containing the result of the TagResource operation returned by the service.
* @sample AmazonEventBridgeAsync.TagResource
* @see AWS API
* Documentation
*/
java.util.concurrent.Future tagResourceAsync(TagResourceRequest tagResourceRequest);
/**
*
* Assigns one or more tags (key-value pairs) to the specified EventBridge resource. Tags can help you organize and
* categorize your resources. You can also use them to scope user permissions by granting a user permission to
* access or change only resources with certain tag values. In EventBridge, rules and event buses can be tagged.
*
*
* Tags don't have any semantic meaning to AWS and are interpreted strictly as strings of characters.
*
*
* You can use the TagResource action with a resource that already has tags. If you specify a new tag
* key, this tag is appended to the list of tags associated with the resource. If you specify a tag key that is
* already associated with the resource, the new tag value that you specify replaces the previous value for that
* tag.
*
*
* You can associate as many as 50 tags with a resource.
*
*
* @param tagResourceRequest
* @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 TagResource operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.TagResource
* @see AWS API
* Documentation
*/
java.util.concurrent.Future tagResourceAsync(TagResourceRequest tagResourceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Tests whether the specified event pattern matches the provided event.
*
*
* Most services in AWS treat : or / as the same character in Amazon Resource Names (ARNs). However, EventBridge
* uses an exact match in event patterns and rules. Be sure to use the correct ARN characters when creating event
* patterns so that they match the ARN syntax in the event you want to match.
*
*
* @param testEventPatternRequest
* @return A Java Future containing the result of the TestEventPattern operation returned by the service.
* @sample AmazonEventBridgeAsync.TestEventPattern
* @see AWS
* API Documentation
*/
java.util.concurrent.Future testEventPatternAsync(TestEventPatternRequest testEventPatternRequest);
/**
*
* Tests whether the specified event pattern matches the provided event.
*
*
* Most services in AWS treat : or / as the same character in Amazon Resource Names (ARNs). However, EventBridge
* uses an exact match in event patterns and rules. Be sure to use the correct ARN characters when creating event
* patterns so that they match the ARN syntax in the event you want to match.
*
*
* @param testEventPatternRequest
* @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 TestEventPattern operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.TestEventPattern
* @see AWS
* API Documentation
*/
java.util.concurrent.Future testEventPatternAsync(TestEventPatternRequest testEventPatternRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Removes one or more tags from the specified EventBridge resource. In Amazon EventBridge (CloudWatch Events, rules
* and event buses can be tagged.
*
*
* @param untagResourceRequest
* @return A Java Future containing the result of the UntagResource operation returned by the service.
* @sample AmazonEventBridgeAsync.UntagResource
* @see AWS API
* Documentation
*/
java.util.concurrent.Future untagResourceAsync(UntagResourceRequest untagResourceRequest);
/**
*
* Removes one or more tags from the specified EventBridge resource. In Amazon EventBridge (CloudWatch Events, rules
* and event buses can be tagged.
*
*
* @param untagResourceRequest
* @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 UntagResource operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.UntagResource
* @see AWS API
* Documentation
*/
java.util.concurrent.Future untagResourceAsync(UntagResourceRequest untagResourceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Updates the specified archive.
*
*
* @param updateArchiveRequest
* @return A Java Future containing the result of the UpdateArchive operation returned by the service.
* @sample AmazonEventBridgeAsync.UpdateArchive
* @see AWS API
* Documentation
*/
java.util.concurrent.Future updateArchiveAsync(UpdateArchiveRequest updateArchiveRequest);
/**
*
* Updates the specified archive.
*
*
* @param updateArchiveRequest
* @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 UpdateArchive operation returned by the service.
* @sample AmazonEventBridgeAsyncHandler.UpdateArchive
* @see AWS API
* Documentation
*/
java.util.concurrent.Future updateArchiveAsync(UpdateArchiveRequest updateArchiveRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
}