/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.cloudwatchevents; import javax.annotation.Generated; import com.amazonaws.services.cloudwatchevents.model.*; /** * Interface for accessing Amazon CloudWatch Events 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.cloudwatchevents.AbstractAmazonCloudWatchEventsAsync} instead. *
**
* Amazon EventBridge helps you to respond to state changes in your Amazon Web Services resources. When your resources * change state, they automatically send events to 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 Lambda function to update DNS entries when an event notifies you that Amazon EC2 instance * enters the running state. *
** Direct specific API records from 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 AmazonCloudWatchEventsAsync extends AmazonCloudWatchEvents { /** ** 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 AmazonCloudWatchEventsAsync.ActivateEventSource * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.ActivateEventSource * @see AWS API * Documentation */ java.util.concurrent.Future* Cancels the specified replay. *
* * @param cancelReplayRequest * @return A Java Future containing the result of the CancelReplay operation returned by the service. * @sample AmazonCloudWatchEventsAsync.CancelReplay * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.CancelReplay * @see AWS API * Documentation */ java.util.concurrent.Future* Creates an API destination, which is an HTTP invocation endpoint configured as a target for events. *
* * @param createApiDestinationRequest * @return A Java Future containing the result of the CreateApiDestination operation returned by the service. * @sample AmazonCloudWatchEventsAsync.CreateApiDestination * @see AWS * API Documentation */ java.util.concurrent.Future* Creates an API destination, which is an HTTP invocation endpoint configured as a target for events. *
* * @param createApiDestinationRequest * @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 CreateApiDestination operation returned by the service. * @sample AmazonCloudWatchEventsAsyncHandler.CreateApiDestination * @see AWS * API Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsync.CreateArchive * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.CreateArchive * @see AWS API * Documentation */ java.util.concurrent.Future* Creates a connection. A connection defines the authorization type and credentials to use for authorization with * an API destination HTTP endpoint. *
* * @param createConnectionRequest * @return A Java Future containing the result of the CreateConnection operation returned by the service. * @sample AmazonCloudWatchEventsAsync.CreateConnection * @see AWS API * Documentation */ java.util.concurrent.Future* Creates a connection. A connection defines the authorization type and credentials to use for authorization with * an API destination HTTP endpoint. *
* * @param createConnectionRequest * @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 CreateConnection operation returned by the service. * @sample AmazonCloudWatchEventsAsyncHandler.CreateConnection * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsync.CreateEventBus * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.CreateEventBus * @see AWS API * Documentation */ java.util.concurrent.Future* Called by an SaaS partner to create a partner event source. This operation is not used by Amazon Web Services * customers. *
** Each partner event source can be used by one Amazon Web Services account to create a matching partner event bus * in that Amazon Web Services account. A SaaS partner must create one partner event source for each Amazon Web * Services 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 Amazon Web Services 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 Amazon Web Services 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 Amazon Web Services * 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 Amazon Web * Services 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 AmazonCloudWatchEventsAsync.CreatePartnerEventSource * @see AWS API Documentation */ java.util.concurrent.Future* Called by an SaaS partner to create a partner event source. This operation is not used by Amazon Web Services * customers. *
** Each partner event source can be used by one Amazon Web Services account to create a matching partner event bus * in that Amazon Web Services account. A SaaS partner must create one partner event source for each Amazon Web * Services 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 Amazon Web Services 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 Amazon Web Services 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 Amazon Web Services * 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 Amazon Web * Services 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 AmazonCloudWatchEventsAsyncHandler.CreatePartnerEventSource * @see AWS API Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsync.DeactivateEventSource * @see AWS * API Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.DeactivateEventSource * @see AWS * API Documentation */ java.util.concurrent.Future* Removes all authorization parameters from the connection. This lets you remove the secret from the connection so * you can reuse it without having to create a new connection. *
* * @param deauthorizeConnectionRequest * @return A Java Future containing the result of the DeauthorizeConnection operation returned by the service. * @sample AmazonCloudWatchEventsAsync.DeauthorizeConnection * @see AWS * API Documentation */ java.util.concurrent.Future* Removes all authorization parameters from the connection. This lets you remove the secret from the connection so * you can reuse it without having to create a new connection. *
* * @param deauthorizeConnectionRequest * @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 DeauthorizeConnection operation returned by the service. * @sample AmazonCloudWatchEventsAsyncHandler.DeauthorizeConnection * @see AWS * API Documentation */ java.util.concurrent.Future* Deletes the specified API destination. *
* * @param deleteApiDestinationRequest * @return A Java Future containing the result of the DeleteApiDestination operation returned by the service. * @sample AmazonCloudWatchEventsAsync.DeleteApiDestination * @see AWS * API Documentation */ java.util.concurrent.Future* Deletes the specified API destination. *
* * @param deleteApiDestinationRequest * @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 DeleteApiDestination operation returned by the service. * @sample AmazonCloudWatchEventsAsyncHandler.DeleteApiDestination * @see AWS * API Documentation */ java.util.concurrent.Future* Deletes the specified archive. *
* * @param deleteArchiveRequest * @return A Java Future containing the result of the DeleteArchive operation returned by the service. * @sample AmazonCloudWatchEventsAsync.DeleteArchive * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.DeleteArchive * @see AWS API * Documentation */ java.util.concurrent.Future* Deletes a connection. *
* * @param deleteConnectionRequest * @return A Java Future containing the result of the DeleteConnection operation returned by the service. * @sample AmazonCloudWatchEventsAsync.DeleteConnection * @see AWS API * Documentation */ java.util.concurrent.Future* Deletes a connection. *
* * @param deleteConnectionRequest * @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 DeleteConnection operation returned by the service. * @sample AmazonCloudWatchEventsAsyncHandler.DeleteConnection * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsync.DeleteEventBus * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.DeleteEventBus * @see AWS API * Documentation */ java.util.concurrent.Future* This operation is used by SaaS partners to delete a partner event source. This operation is not used by Amazon * Web Services customers. *
** When you delete an event source, the status of the corresponding partner event bus in the Amazon Web Services * customer account becomes DELETED. *
* * * @param deletePartnerEventSourceRequest * @return A Java Future containing the result of the DeletePartnerEventSource operation returned by the service. * @sample AmazonCloudWatchEventsAsync.DeletePartnerEventSource * @see AWS API Documentation */ java.util.concurrent.Future* This operation is used by SaaS partners to delete a partner event source. This operation is not used by Amazon * Web Services customers. *
** When you delete an event source, the status of the corresponding partner event bus in the Amazon Web Services * 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 AmazonCloudWatchEventsAsyncHandler.DeletePartnerEventSource * @see AWS API Documentation */ java.util.concurrent.Future* 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. *
*
* If you call delete rule multiple times for the same rule, all calls will succeed. When you call delete rule for a
* non-existent custom eventbus, ResourceNotFoundException
is returned.
*
* Managed rules are rules created and managed by another Amazon Web Services service on your behalf. These rules
* are created by those other Amazon Web Services 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.
*
* 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. *
*
* If you call delete rule multiple times for the same rule, all calls will succeed. When you call delete rule for a
* non-existent custom eventbus, ResourceNotFoundException
is returned.
*
* Managed rules are rules created and managed by another Amazon Web Services service on your behalf. These rules
* are created by those other Amazon Web Services 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.
*
* Retrieves details about an API destination. *
* * @param describeApiDestinationRequest * @return A Java Future containing the result of the DescribeApiDestination operation returned by the service. * @sample AmazonCloudWatchEventsAsync.DescribeApiDestination * @see AWS * API Documentation */ java.util.concurrent.Future* Retrieves details about an API destination. *
* * @param describeApiDestinationRequest * @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 DescribeApiDestination operation returned by the service. * @sample AmazonCloudWatchEventsAsyncHandler.DescribeApiDestination * @see AWS * API Documentation */ java.util.concurrent.Future* Retrieves details about an archive. *
* * @param describeArchiveRequest * @return A Java Future containing the result of the DescribeArchive operation returned by the service. * @sample AmazonCloudWatchEventsAsync.DescribeArchive * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.DescribeArchive * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves details about a connection. *
* * @param describeConnectionRequest * @return A Java Future containing the result of the DescribeConnection operation returned by the service. * @sample AmazonCloudWatchEventsAsync.DescribeConnection * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves details about a connection. *
* * @param describeConnectionRequest * @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 DescribeConnection operation returned by the service. * @sample AmazonCloudWatchEventsAsyncHandler.DescribeConnection * @see AWS API * Documentation */ java.util.concurrent.Future* Displays details about an event bus in your account. This can include the external Amazon Web Services 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 AmazonCloudWatchEventsAsync.DescribeEventBus * @see AWS API * Documentation */ java.util.concurrent.Future* Displays details about an event bus in your account. This can include the external Amazon Web Services 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 AmazonCloudWatchEventsAsyncHandler.DescribeEventBus * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsync.DescribeEventSource * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.DescribeEventSource * @see AWS API * Documentation */ java.util.concurrent.Future* An SaaS partner can use this operation to list details about a partner event source that they have created. * Amazon Web Services customers do not use this operation. Instead, Amazon Web Services 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 AmazonCloudWatchEventsAsync.DescribePartnerEventSource * @see AWS API Documentation */ java.util.concurrent.Future* An SaaS partner can use this operation to list details about a partner event source that they have created. * Amazon Web Services customers do not use this operation. Instead, Amazon Web Services 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 AmazonCloudWatchEventsAsyncHandler.DescribePartnerEventSource * @see AWS API Documentation */ java.util.concurrent.Future
* 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.
*
* 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.
*
* 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 AmazonCloudWatchEventsAsync.DescribeRule * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.DescribeRule * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsync.DisableRule * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.DisableRule * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsync.EnableRule * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.EnableRule * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves a list of API destination in the account in the current Region. *
* * @param listApiDestinationsRequest * @return A Java Future containing the result of the ListApiDestinations operation returned by the service. * @sample AmazonCloudWatchEventsAsync.ListApiDestinations * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves a list of API destination in the account in the current Region. *
* * @param listApiDestinationsRequest * @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 ListApiDestinations operation returned by the service. * @sample AmazonCloudWatchEventsAsyncHandler.ListApiDestinations * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsync.ListArchives * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.ListArchives * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves a list of connections from the account. *
* * @param listConnectionsRequest * @return A Java Future containing the result of the ListConnections operation returned by the service. * @sample AmazonCloudWatchEventsAsync.ListConnections * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves a list of connections from the account. *
* * @param listConnectionsRequest * @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 ListConnections operation returned by the service. * @sample AmazonCloudWatchEventsAsyncHandler.ListConnections * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsync.ListEventBuses * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.ListEventBuses * @see AWS API * Documentation */ java.util.concurrent.Future* You can use this to see all the partner event sources that have been shared with your Amazon Web Services * 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 AmazonCloudWatchEventsAsync.ListEventSources * @see AWS API * Documentation */ java.util.concurrent.Future* You can use this to see all the partner event sources that have been shared with your Amazon Web Services * 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 AmazonCloudWatchEventsAsyncHandler.ListEventSources * @see AWS API * Documentation */ java.util.concurrent.Future* An SaaS partner can use this operation to display the Amazon Web Services account ID that a particular partner * event source name is associated with. This operation is not used by Amazon Web Services customers. *
* * @param listPartnerEventSourceAccountsRequest * @return A Java Future containing the result of the ListPartnerEventSourceAccounts operation returned by the * service. * @sample AmazonCloudWatchEventsAsync.ListPartnerEventSourceAccounts * @see AWS API Documentation */ java.util.concurrent.Future* An SaaS partner can use this operation to display the Amazon Web Services account ID that a particular partner * event source name is associated with. This operation is not used by Amazon Web Services 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 AmazonCloudWatchEventsAsyncHandler.ListPartnerEventSourceAccounts * @see AWS API Documentation */ java.util.concurrent.Future* 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 Amazon Web Services customers. *
* * @param listPartnerEventSourcesRequest * @return A Java Future containing the result of the ListPartnerEventSources operation returned by the service. * @sample AmazonCloudWatchEventsAsync.ListPartnerEventSources * @see AWS * API Documentation */ java.util.concurrent.Future* 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 Amazon Web Services 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 AmazonCloudWatchEventsAsyncHandler.ListPartnerEventSources * @see AWS * API Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsync.ListReplays * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.ListReplays * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsync.ListRuleNamesByTarget * @see AWS * API Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.ListRuleNamesByTarget * @see AWS * API Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsync.ListRules * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.ListRules * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsync.ListTagsForResource * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.ListTagsForResource * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsync.ListTargetsByRule * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.ListTargetsByRule * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsync.PutEvents * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.PutEvents * @see AWS API * Documentation */ java.util.concurrent.Future* This is used by SaaS partners to write events to a customer's partner event bus. Amazon Web Services customers do * not use this operation. *
* * @param putPartnerEventsRequest * @return A Java Future containing the result of the PutPartnerEvents operation returned by the service. * @sample AmazonCloudWatchEventsAsync.PutPartnerEvents * @see AWS API * Documentation */ java.util.concurrent.Future* This is used by SaaS partners to write events to a customer's partner event bus. Amazon Web Services 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 AmazonCloudWatchEventsAsyncHandler.PutPartnerEvents * @see AWS API * Documentation */ java.util.concurrent.Future
* Running PutPermission
permits the specified Amazon Web Services account or Amazon Web Services
* 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 Amazon Web Services 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 Amazon Web Services
* organization, you can run PutPermission
once specifying Principal
as "*" and specifying
* the Amazon Web Services 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 Amazon Web Services Accounts in the Amazon EventBridge User
* Guide.
*
* The permission policy on the 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 AmazonCloudWatchEventsAsync.PutPermission * @see AWS API * Documentation */ java.util.concurrent.Future
* Running PutPermission
permits the specified Amazon Web Services account or Amazon Web Services
* 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 Amazon Web Services 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 Amazon Web Services
* organization, you can run PutPermission
once specifying Principal
as "*" and specifying
* the Amazon Web Services 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 Amazon Web Services Accounts in the Amazon EventBridge User
* Guide.
*
* The permission policy on the 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 AmazonCloudWatchEventsAsyncHandler.PutPermission * @see AWS API * Documentation */ java.util.concurrent.Future* 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 Amazon Web Services 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 Amazon Web Services 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 AmazonCloudWatchEventsAsync.PutRule * @see AWS API * Documentation */ java.util.concurrent.Future* 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 Amazon Web Services 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 Amazon Web Services 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 AmazonCloudWatchEventsAsyncHandler.PutRule * @see AWS API * Documentation */ java.util.concurrent.Future* 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: *
** API destination *
** Amazon API Gateway REST API endpoints *
** API Gateway *
** Batch job queue *
** CloudWatch Logs group *
** CodeBuild project *
** CodePipeline *
*
* Amazon EC2 CreateSnapshot
API call
*
* Amazon EC2 RebootInstances
API call
*
* Amazon EC2 StopInstances
API call
*
* Amazon EC2 TerminateInstances
API call
*
* Amazon ECS tasks *
** Event bus in a different Amazon Web Services account or Region. *
** You can use an event bus in the US East (N. Virginia) us-east-1, US West (Oregon) us-west-2, or Europe (Ireland) * eu-west-1 Regions as a target for a rule. *
** Firehose delivery stream (Kinesis Data Firehose) *
** Inspector assessment template (Amazon Inspector) *
** Kinesis stream (Kinesis Data Stream) *
** Lambda function *
** Redshift clusters (Data API statement execution) *
** Amazon SNS topic *
** Amazon SQS queues (includes FIFO queues *
** SSM Automation *
** SSM OpsItem *
** SSM Run Command *
** Step Functions state machines *
*
* Creating rules with built-in targets is supported only in the 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 needs the appropriate
* permissions. For Lambda and Amazon SNS resources, EventBridge relies on resource-based policies. For EC2
* instances, Kinesis Data Streams, 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 Amazon Web Services 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 Pricing.
*
* Input
, InputPath
, and InputTransformer
are not available with
* PutTarget
if the target is an event bus of a different Amazon Web Services 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 Amazon Web Services 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.
*
* 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: *
** API destination *
** Amazon API Gateway REST API endpoints *
** API Gateway *
** Batch job queue *
** CloudWatch Logs group *
** CodeBuild project *
** CodePipeline *
*
* Amazon EC2 CreateSnapshot
API call
*
* Amazon EC2 RebootInstances
API call
*
* Amazon EC2 StopInstances
API call
*
* Amazon EC2 TerminateInstances
API call
*
* Amazon ECS tasks *
** Event bus in a different Amazon Web Services account or Region. *
** You can use an event bus in the US East (N. Virginia) us-east-1, US West (Oregon) us-west-2, or Europe (Ireland) * eu-west-1 Regions as a target for a rule. *
** Firehose delivery stream (Kinesis Data Firehose) *
** Inspector assessment template (Amazon Inspector) *
** Kinesis stream (Kinesis Data Stream) *
** Lambda function *
** Redshift clusters (Data API statement execution) *
** Amazon SNS topic *
** Amazon SQS queues (includes FIFO queues *
** SSM Automation *
** SSM OpsItem *
** SSM Run Command *
** Step Functions state machines *
*
* Creating rules with built-in targets is supported only in the 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 needs the appropriate
* permissions. For Lambda and Amazon SNS resources, EventBridge relies on resource-based policies. For EC2
* instances, Kinesis Data Streams, 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 Amazon Web Services 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 Pricing.
*
* Input
, InputPath
, and InputTransformer
are not available with
* PutTarget
if the target is an event bus of a different Amazon Web Services 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 Amazon Web Services 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.
*
* Revokes the permission of another Amazon Web Services 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
* .
*
* Revokes the permission of another Amazon Web Services 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
* .
*
* 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.
*
* 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.
*
* 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.
*
* 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.
*
* 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 Amazon Web Services 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 AmazonCloudWatchEventsAsync.TagResource * @see AWS API * Documentation */ java.util.concurrent.Future* 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 Amazon Web Services 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 AmazonCloudWatchEventsAsyncHandler.TagResource * @see AWS API * Documentation */ java.util.concurrent.Future* Tests whether the specified event pattern matches the provided event. *
** Most services in Amazon Web Services 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 AmazonCloudWatchEventsAsync.TestEventPattern * @see AWS API * Documentation */ java.util.concurrent.Future* Tests whether the specified event pattern matches the provided event. *
** Most services in Amazon Web Services 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 AmazonCloudWatchEventsAsyncHandler.TestEventPattern * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsync.UntagResource * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.UntagResource * @see AWS API * Documentation */ java.util.concurrent.Future* Updates an API destination. *
* * @param updateApiDestinationRequest * @return A Java Future containing the result of the UpdateApiDestination operation returned by the service. * @sample AmazonCloudWatchEventsAsync.UpdateApiDestination * @see AWS * API Documentation */ java.util.concurrent.Future* Updates an API destination. *
* * @param updateApiDestinationRequest * @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 UpdateApiDestination operation returned by the service. * @sample AmazonCloudWatchEventsAsyncHandler.UpdateApiDestination * @see AWS * API Documentation */ java.util.concurrent.Future* Updates the specified archive. *
* * @param updateArchiveRequest * @return A Java Future containing the result of the UpdateArchive operation returned by the service. * @sample AmazonCloudWatchEventsAsync.UpdateArchive * @see AWS API * Documentation */ java.util.concurrent.Future* 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 AmazonCloudWatchEventsAsyncHandler.UpdateArchive * @see AWS API * Documentation */ java.util.concurrent.Future* Updates settings for a connection. *
* * @param updateConnectionRequest * @return A Java Future containing the result of the UpdateConnection operation returned by the service. * @sample AmazonCloudWatchEventsAsync.UpdateConnection * @see AWS API * Documentation */ java.util.concurrent.Future* Updates settings for a connection. *
* * @param updateConnectionRequest * @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 UpdateConnection operation returned by the service. * @sample AmazonCloudWatchEventsAsyncHandler.UpdateConnection * @see AWS API * Documentation */ java.util.concurrent.Future