software.amazon.awssdk.services.eventbridge.EventBridgeAsyncClient Maven / Gradle / Ivy
Show all versions of eventbridge Show documentation
/*
* Copyright 2014-2019 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 software.amazon.awssdk.services.eventbridge;
import java.util.concurrent.CompletableFuture;
import java.util.function.Consumer;
import software.amazon.awssdk.annotations.Generated;
import software.amazon.awssdk.core.SdkClient;
import software.amazon.awssdk.services.eventbridge.model.ActivateEventSourceRequest;
import software.amazon.awssdk.services.eventbridge.model.ActivateEventSourceResponse;
import software.amazon.awssdk.services.eventbridge.model.CreateEventBusRequest;
import software.amazon.awssdk.services.eventbridge.model.CreateEventBusResponse;
import software.amazon.awssdk.services.eventbridge.model.CreatePartnerEventSourceRequest;
import software.amazon.awssdk.services.eventbridge.model.CreatePartnerEventSourceResponse;
import software.amazon.awssdk.services.eventbridge.model.DeactivateEventSourceRequest;
import software.amazon.awssdk.services.eventbridge.model.DeactivateEventSourceResponse;
import software.amazon.awssdk.services.eventbridge.model.DeleteEventBusRequest;
import software.amazon.awssdk.services.eventbridge.model.DeleteEventBusResponse;
import software.amazon.awssdk.services.eventbridge.model.DeletePartnerEventSourceRequest;
import software.amazon.awssdk.services.eventbridge.model.DeletePartnerEventSourceResponse;
import software.amazon.awssdk.services.eventbridge.model.DeleteRuleRequest;
import software.amazon.awssdk.services.eventbridge.model.DeleteRuleResponse;
import software.amazon.awssdk.services.eventbridge.model.DescribeEventBusRequest;
import software.amazon.awssdk.services.eventbridge.model.DescribeEventBusResponse;
import software.amazon.awssdk.services.eventbridge.model.DescribeEventSourceRequest;
import software.amazon.awssdk.services.eventbridge.model.DescribeEventSourceResponse;
import software.amazon.awssdk.services.eventbridge.model.DescribePartnerEventSourceRequest;
import software.amazon.awssdk.services.eventbridge.model.DescribePartnerEventSourceResponse;
import software.amazon.awssdk.services.eventbridge.model.DescribeRuleRequest;
import software.amazon.awssdk.services.eventbridge.model.DescribeRuleResponse;
import software.amazon.awssdk.services.eventbridge.model.DisableRuleRequest;
import software.amazon.awssdk.services.eventbridge.model.DisableRuleResponse;
import software.amazon.awssdk.services.eventbridge.model.EnableRuleRequest;
import software.amazon.awssdk.services.eventbridge.model.EnableRuleResponse;
import software.amazon.awssdk.services.eventbridge.model.ListEventBusesRequest;
import software.amazon.awssdk.services.eventbridge.model.ListEventBusesResponse;
import software.amazon.awssdk.services.eventbridge.model.ListEventSourcesRequest;
import software.amazon.awssdk.services.eventbridge.model.ListEventSourcesResponse;
import software.amazon.awssdk.services.eventbridge.model.ListPartnerEventSourceAccountsRequest;
import software.amazon.awssdk.services.eventbridge.model.ListPartnerEventSourceAccountsResponse;
import software.amazon.awssdk.services.eventbridge.model.ListPartnerEventSourcesRequest;
import software.amazon.awssdk.services.eventbridge.model.ListPartnerEventSourcesResponse;
import software.amazon.awssdk.services.eventbridge.model.ListRuleNamesByTargetRequest;
import software.amazon.awssdk.services.eventbridge.model.ListRuleNamesByTargetResponse;
import software.amazon.awssdk.services.eventbridge.model.ListRulesRequest;
import software.amazon.awssdk.services.eventbridge.model.ListRulesResponse;
import software.amazon.awssdk.services.eventbridge.model.ListTagsForResourceRequest;
import software.amazon.awssdk.services.eventbridge.model.ListTagsForResourceResponse;
import software.amazon.awssdk.services.eventbridge.model.ListTargetsByRuleRequest;
import software.amazon.awssdk.services.eventbridge.model.ListTargetsByRuleResponse;
import software.amazon.awssdk.services.eventbridge.model.PutEventsRequest;
import software.amazon.awssdk.services.eventbridge.model.PutEventsResponse;
import software.amazon.awssdk.services.eventbridge.model.PutPartnerEventsRequest;
import software.amazon.awssdk.services.eventbridge.model.PutPartnerEventsResponse;
import software.amazon.awssdk.services.eventbridge.model.PutPermissionRequest;
import software.amazon.awssdk.services.eventbridge.model.PutPermissionResponse;
import software.amazon.awssdk.services.eventbridge.model.PutRuleRequest;
import software.amazon.awssdk.services.eventbridge.model.PutRuleResponse;
import software.amazon.awssdk.services.eventbridge.model.PutTargetsRequest;
import software.amazon.awssdk.services.eventbridge.model.PutTargetsResponse;
import software.amazon.awssdk.services.eventbridge.model.RemovePermissionRequest;
import software.amazon.awssdk.services.eventbridge.model.RemovePermissionResponse;
import software.amazon.awssdk.services.eventbridge.model.RemoveTargetsRequest;
import software.amazon.awssdk.services.eventbridge.model.RemoveTargetsResponse;
import software.amazon.awssdk.services.eventbridge.model.TagResourceRequest;
import software.amazon.awssdk.services.eventbridge.model.TagResourceResponse;
import software.amazon.awssdk.services.eventbridge.model.TestEventPatternRequest;
import software.amazon.awssdk.services.eventbridge.model.TestEventPatternResponse;
import software.amazon.awssdk.services.eventbridge.model.UntagResourceRequest;
import software.amazon.awssdk.services.eventbridge.model.UntagResourceResponse;
/**
* Service client for accessing Amazon EventBridge asynchronously. This can be created using the static
* {@link #builder()} method.
*
*
* 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("software.amazon.awssdk:codegen")
public interface EventBridgeAsyncClient extends SdkClient {
String SERVICE_NAME = "events";
/**
* Create a {@link EventBridgeAsyncClient} with the region loaded from the
* {@link software.amazon.awssdk.regions.providers.DefaultAwsRegionProviderChain} and credentials loaded from the
* {@link software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider}.
*/
static EventBridgeAsyncClient create() {
return builder().build();
}
/**
* Create a builder that can be used to configure and create a {@link EventBridgeAsyncClient}.
*/
static EventBridgeAsyncClientBuilder builder() {
return new DefaultEventBridgeAsyncClientBuilder();
}
/**
*
* Activates a partner event source that has been deactivated. Once activated, your matching event bus will start
* receiving events from the event source.
*
*
*
* This operation is performed by AWS customers, not by SaaS partners.
*
*
*
* @param activateEventSourceRequest
* @return A Java Future containing the result of the ActivateEventSource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InvalidStateException The specified state isn't a valid state for an event source.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.ActivateEventSource
* @see AWS API Documentation
*/
default CompletableFuture activateEventSource(
ActivateEventSourceRequest activateEventSourceRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Activates a partner event source that has been deactivated. Once activated, your matching event bus will start
* receiving events from the event source.
*
*
*
* This operation is performed by AWS customers, not by SaaS partners.
*
*
*
* This is a convenience which creates an instance of the {@link ActivateEventSourceRequest.Builder} avoiding the
* need to create one manually via {@link ActivateEventSourceRequest#builder()}
*
*
* @param activateEventSourceRequest
* A {@link Consumer} that will call methods on {@link ActivateEventSourceRequest.Builder} to create a
* request.
* @return A Java Future containing the result of the ActivateEventSource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InvalidStateException The specified state isn't a valid state for an event source.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.ActivateEventSource
* @see AWS API Documentation
*/
default CompletableFuture activateEventSource(
Consumer activateEventSourceRequest) {
return activateEventSource(ActivateEventSourceRequest.builder().applyMutation(activateEventSourceRequest).build());
}
/**
*
* Creates a new event bus within your account. This can be a custom event bus which you can use to receive events
* from your own custom applications and services, or it can be a partner event bus which can be matched to a
* partner event source.
*
*
*
* This operation is used by AWS customers, not by SaaS partners.
*
*
*
* @param createEventBusRequest
* @return A Java Future containing the result of the CreateEventBus operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceAlreadyExistsException The resource that you're trying to create already exists.
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InvalidStateException The specified state isn't a valid state for an event source.
* - InternalException This exception occurs due to unexpected causes.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - LimitExceededException You tried to create more resources than is allowed.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.CreateEventBus
* @see AWS API
* Documentation
*/
default CompletableFuture createEventBus(CreateEventBusRequest createEventBusRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Creates a new event bus within your account. This can be a custom event bus which you can use to receive events
* from your own custom applications and services, or it can be a partner event bus which can be matched to a
* partner event source.
*
*
*
* This operation is used by AWS customers, not by SaaS partners.
*
*
*
* This is a convenience which creates an instance of the {@link CreateEventBusRequest.Builder} avoiding the need to
* create one manually via {@link CreateEventBusRequest#builder()}
*
*
* @param createEventBusRequest
* A {@link Consumer} that will call methods on {@link CreateEventBusRequest.Builder} to create a request.
* @return A Java Future containing the result of the CreateEventBus operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceAlreadyExistsException The resource that you're trying to create already exists.
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InvalidStateException The specified state isn't a valid state for an event source.
* - InternalException This exception occurs due to unexpected causes.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - LimitExceededException You tried to create more resources than is allowed.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.CreateEventBus
* @see AWS API
* Documentation
*/
default CompletableFuture createEventBus(Consumer createEventBusRequest) {
return createEventBus(CreateEventBusRequest.builder().applyMutation(createEventBusRequest).build());
}
/**
*
* 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 in 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:
*
*
* aws.partner/partner_name/event_namespace/event_name
*
*
* -
*
* partner_name is determined during partner registration and identifies the partner to AWS customers.
*
*
* -
*
* For event_namespace, we recommend that partners use a string that identifies the AWS customer within the
* partner's system. This should not be the customer's AWS account ID.
*
*
* -
*
* event_name is determined by the partner, and should uniquely identify an event-generating resource within
* the partner system. This 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.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceAlreadyExistsException The resource that you're trying to create already exists.
* - InternalException This exception occurs due to unexpected causes.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - LimitExceededException You tried to create more resources than is allowed.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.CreatePartnerEventSource
* @see AWS API Documentation
*/
default CompletableFuture createPartnerEventSource(
CreatePartnerEventSourceRequest createPartnerEventSourceRequest) {
throw new UnsupportedOperationException();
}
/**
*
* 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 in 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:
*
*
* aws.partner/partner_name/event_namespace/event_name
*
*
* -
*
* partner_name is determined during partner registration and identifies the partner to AWS customers.
*
*
* -
*
* For event_namespace, we recommend that partners use a string that identifies the AWS customer within the
* partner's system. This should not be the customer's AWS account ID.
*
*
* -
*
* event_name is determined by the partner, and should uniquely identify an event-generating resource within
* the partner system. This should help AWS customers decide whether to create an event bus to receive these events.
*
*
*
*
*
* This is a convenience which creates an instance of the {@link CreatePartnerEventSourceRequest.Builder} avoiding
* the need to create one manually via {@link CreatePartnerEventSourceRequest#builder()}
*
*
* @param createPartnerEventSourceRequest
* A {@link Consumer} that will call methods on {@link CreatePartnerEventSourceRequest.Builder} to create a
* request.
* @return A Java Future containing the result of the CreatePartnerEventSource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceAlreadyExistsException The resource that you're trying to create already exists.
* - InternalException This exception occurs due to unexpected causes.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - LimitExceededException You tried to create more resources than is allowed.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.CreatePartnerEventSource
* @see AWS API Documentation
*/
default CompletableFuture createPartnerEventSource(
Consumer createPartnerEventSourceRequest) {
return createPartnerEventSource(CreatePartnerEventSourceRequest.builder().applyMutation(createPartnerEventSourceRequest)
.build());
}
/**
*
* An AWS customer uses this operation to temporarily stop receiving events from the specified partner event source.
* The matching event bus isn't 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's 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.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InvalidStateException The specified state isn't a valid state for an event source.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.DeactivateEventSource
* @see AWS API Documentation
*/
default CompletableFuture deactivateEventSource(
DeactivateEventSourceRequest deactivateEventSourceRequest) {
throw new UnsupportedOperationException();
}
/**
*
* An AWS customer uses this operation to temporarily stop receiving events from the specified partner event source.
* The matching event bus isn't 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's deleted.
*
*
* To activate a deactivated partner event source, use ActivateEventSource.
*
*
*
* This is a convenience which creates an instance of the {@link DeactivateEventSourceRequest.Builder} avoiding the
* need to create one manually via {@link DeactivateEventSourceRequest#builder()}
*
*
* @param deactivateEventSourceRequest
* A {@link Consumer} that will call methods on {@link DeactivateEventSourceRequest.Builder} to create a
* request.
* @return A Java Future containing the result of the DeactivateEventSource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InvalidStateException The specified state isn't a valid state for an event source.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.DeactivateEventSource
* @see AWS API Documentation
*/
default CompletableFuture deactivateEventSource(
Consumer deactivateEventSourceRequest) {
return deactivateEventSource(DeactivateEventSourceRequest.builder().applyMutation(deactivateEventSourceRequest).build());
}
/**
*
* Deletes the specified custom event bus or partner event bus. All rules associated with this event bus are also
* deleted. You can't delete your account's default event bus.
*
*
*
* This operation is performed by AWS customers, not by SaaS partners.
*
*
*
* @param deleteEventBusRequest
* @return A Java Future containing the result of the DeleteEventBus operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.DeleteEventBus
* @see AWS API
* Documentation
*/
default CompletableFuture deleteEventBus(DeleteEventBusRequest deleteEventBusRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Deletes the specified custom event bus or partner event bus. All rules associated with this event bus are also
* deleted. You can't delete your account's default event bus.
*
*
*
* This operation is performed by AWS customers, not by SaaS partners.
*
*
*
* This is a convenience which creates an instance of the {@link DeleteEventBusRequest.Builder} avoiding the need to
* create one manually via {@link DeleteEventBusRequest#builder()}
*
*
* @param deleteEventBusRequest
* A {@link Consumer} that will call methods on {@link DeleteEventBusRequest.Builder} to create a request.
* @return A Java Future containing the result of the DeleteEventBus operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.DeleteEventBus
* @see AWS API
* Documentation
*/
default CompletableFuture deleteEventBus(Consumer deleteEventBusRequest) {
return deleteEventBus(DeleteEventBusRequest.builder().applyMutation(deleteEventBusRequest).build());
}
/**
*
* This operation is used by SaaS partners to delete a partner event source. AWS customers don't use this operation.
*
*
* 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.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.DeletePartnerEventSource
* @see AWS API Documentation
*/
default CompletableFuture deletePartnerEventSource(
DeletePartnerEventSourceRequest deletePartnerEventSourceRequest) {
throw new UnsupportedOperationException();
}
/**
*
* This operation is used by SaaS partners to delete a partner event source. AWS customers don't use this operation.
*
*
* When you delete an event source, the status of the corresponding partner event bus in the AWS customer account
* becomes DELETED
.
*
*
*
* This is a convenience which creates an instance of the {@link DeletePartnerEventSourceRequest.Builder} avoiding
* the need to create one manually via {@link DeletePartnerEventSourceRequest#builder()}
*
*
* @param deletePartnerEventSourceRequest
* A {@link Consumer} that will call methods on {@link DeletePartnerEventSourceRequest.Builder} to create a
* request.
* @return A Java Future containing the result of the DeletePartnerEventSource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.DeletePartnerEventSource
* @see AWS API Documentation
*/
default CompletableFuture deletePartnerEventSource(
Consumer deletePartnerEventSourceRequest) {
return deletePartnerEventSource(DeletePartnerEventSourceRequest.builder().applyMutation(deletePartnerEventSourceRequest)
.build());
}
/**
*
* 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're sure that the other service isn't still using that
* rule.
*
*
* @param deleteRuleRequest
* @return A Java Future containing the result of the DeleteRule operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ConcurrentModificationException There is concurrent modification on a resource.
* - ManagedRuleException An AWS service created this rule on behalf of your account. That service manages
* it. If you see this error in response to
DeleteRule
or RemoveTargets
, you can
* use the Force
parameter in those calls to delete the rule or remove targets from the rule.
* You can't modify these managed rules by using DisableRule
, EnableRule
,
* PutTargets
, PutRule
, TagResource
, or UntagResource
.
* - InternalException This exception occurs due to unexpected causes.
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.DeleteRule
* @see AWS API
* Documentation
*/
default CompletableFuture deleteRule(DeleteRuleRequest deleteRuleRequest) {
throw new UnsupportedOperationException();
}
/**
*
* 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're sure that the other service isn't still using that
* rule.
*
*
*
* This is a convenience which creates an instance of the {@link DeleteRuleRequest.Builder} avoiding the need to
* create one manually via {@link DeleteRuleRequest#builder()}
*
*
* @param deleteRuleRequest
* A {@link Consumer} that will call methods on {@link DeleteRuleRequest.Builder} to create a request.
* @return A Java Future containing the result of the DeleteRule operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ConcurrentModificationException There is concurrent modification on a resource.
* - ManagedRuleException An AWS service created this rule on behalf of your account. That service manages
* it. If you see this error in response to
DeleteRule
or RemoveTargets
, you can
* use the Force
parameter in those calls to delete the rule or remove targets from the rule.
* You can't modify these managed rules by using DisableRule
, EnableRule
,
* PutTargets
, PutRule
, TagResource
, or UntagResource
.
* - InternalException This exception occurs due to unexpected causes.
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.DeleteRule
* @see AWS API
* Documentation
*/
default CompletableFuture deleteRule(Consumer deleteRuleRequest) {
return deleteRule(DeleteRuleRequest.builder().applyMutation(deleteRuleRequest).build());
}
/**
*
* 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.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.DescribeEventBus
* @see AWS
* API Documentation
*/
default CompletableFuture describeEventBus(DescribeEventBusRequest describeEventBusRequest) {
throw new UnsupportedOperationException();
}
/**
*
* 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.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeEventBusRequest.Builder} avoiding the need
* to create one manually via {@link DescribeEventBusRequest#builder()}
*
*
* @param describeEventBusRequest
* A {@link Consumer} that will call methods on {@link DescribeEventBusRequest.Builder} to create a request.
* @return A Java Future containing the result of the DescribeEventBus operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.DescribeEventBus
* @see AWS
* API Documentation
*/
default CompletableFuture describeEventBus(
Consumer describeEventBusRequest) {
return describeEventBus(DescribeEventBusRequest.builder().applyMutation(describeEventBusRequest).build());
}
/**
*
* This operation lists details about a partner event source that is shared with your account.
*
*
*
* This operation is run by AWS customers, not by SaaS partners.
*
*
*
* @param describeEventSourceRequest
* @return A Java Future containing the result of the DescribeEventSource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.DescribeEventSource
* @see AWS API Documentation
*/
default CompletableFuture describeEventSource(
DescribeEventSourceRequest describeEventSourceRequest) {
throw new UnsupportedOperationException();
}
/**
*
* This operation lists details about a partner event source that is shared with your account.
*
*
*
* This operation is run by AWS customers, not by SaaS partners.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeEventSourceRequest.Builder} avoiding the
* need to create one manually via {@link DescribeEventSourceRequest#builder()}
*
*
* @param describeEventSourceRequest
* A {@link Consumer} that will call methods on {@link DescribeEventSourceRequest.Builder} to create a
* request.
* @return A Java Future containing the result of the DescribeEventSource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.DescribeEventSource
* @see AWS API Documentation
*/
default CompletableFuture describeEventSource(
Consumer describeEventSourceRequest) {
return describeEventSource(DescribeEventSourceRequest.builder().applyMutation(describeEventSourceRequest).build());
}
/**
*
* 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.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.DescribePartnerEventSource
* @see AWS API Documentation
*/
default CompletableFuture describePartnerEventSource(
DescribePartnerEventSourceRequest describePartnerEventSourceRequest) {
throw new UnsupportedOperationException();
}
/**
*
* 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.
*
*
*
* This is a convenience which creates an instance of the {@link DescribePartnerEventSourceRequest.Builder} avoiding
* the need to create one manually via {@link DescribePartnerEventSourceRequest#builder()}
*
*
* @param describePartnerEventSourceRequest
* A {@link Consumer} that will call methods on {@link DescribePartnerEventSourceRequest.Builder} to create a
* request.
* @return A Java Future containing the result of the DescribePartnerEventSource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.DescribePartnerEventSource
* @see AWS API Documentation
*/
default CompletableFuture describePartnerEventSource(
Consumer describePartnerEventSourceRequest) {
return describePartnerEventSource(DescribePartnerEventSourceRequest.builder()
.applyMutation(describePartnerEventSourceRequest).build());
}
/**
*
* Describes the specified rule.
*
*
* DescribeRule
doesn't 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.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.DescribeRule
* @see AWS API
* Documentation
*/
default CompletableFuture describeRule(DescribeRuleRequest describeRuleRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Describes the specified rule.
*
*
* DescribeRule
doesn't list the targets of a rule. To see the targets associated with a rule, use
* ListTargetsByRule.
*
*
*
* This is a convenience which creates an instance of the {@link DescribeRuleRequest.Builder} avoiding the need to
* create one manually via {@link DescribeRuleRequest#builder()}
*
*
* @param describeRuleRequest
* A {@link Consumer} that will call methods on {@link DescribeRuleRequest.Builder} to create a request.
* @return A Java Future containing the result of the DescribeRule operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.DescribeRule
* @see AWS API
* Documentation
*/
default CompletableFuture describeRule(Consumer describeRuleRequest) {
return describeRule(DescribeRuleRequest.builder().applyMutation(describeRuleRequest).build());
}
/**
*
* 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.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - ManagedRuleException An AWS service created this rule on behalf of your account. That service manages
* it. If you see this error in response to
DeleteRule
or RemoveTargets
, you can
* use the Force
parameter in those calls to delete the rule or remove targets from the rule.
* You can't modify these managed rules by using DisableRule
, EnableRule
,
* PutTargets
, PutRule
, TagResource
, or UntagResource
.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.DisableRule
* @see AWS API
* Documentation
*/
default CompletableFuture disableRule(DisableRuleRequest disableRuleRequest) {
throw new UnsupportedOperationException();
}
/**
*
* 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.
*
*
*
* This is a convenience which creates an instance of the {@link DisableRuleRequest.Builder} avoiding the need to
* create one manually via {@link DisableRuleRequest#builder()}
*
*
* @param disableRuleRequest
* A {@link Consumer} that will call methods on {@link DisableRuleRequest.Builder} to create a request.
* @return A Java Future containing the result of the DisableRule operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - ManagedRuleException An AWS service created this rule on behalf of your account. That service manages
* it. If you see this error in response to
DeleteRule
or RemoveTargets
, you can
* use the Force
parameter in those calls to delete the rule or remove targets from the rule.
* You can't modify these managed rules by using DisableRule
, EnableRule
,
* PutTargets
, PutRule
, TagResource
, or UntagResource
.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.DisableRule
* @see AWS API
* Documentation
*/
default CompletableFuture disableRule(Consumer disableRuleRequest) {
return disableRule(DisableRuleRequest.builder().applyMutation(disableRuleRequest).build());
}
/**
*
* Enables the specified rule. If the rule doesn't 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.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - ManagedRuleException An AWS service created this rule on behalf of your account. That service manages
* it. If you see this error in response to
DeleteRule
or RemoveTargets
, you can
* use the Force
parameter in those calls to delete the rule or remove targets from the rule.
* You can't modify these managed rules by using DisableRule
, EnableRule
,
* PutTargets
, PutRule
, TagResource
, or UntagResource
.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.EnableRule
* @see AWS API
* Documentation
*/
default CompletableFuture enableRule(EnableRuleRequest enableRuleRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Enables the specified rule. If the rule doesn't 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.
*
*
*
* This is a convenience which creates an instance of the {@link EnableRuleRequest.Builder} avoiding the need to
* create one manually via {@link EnableRuleRequest#builder()}
*
*
* @param enableRuleRequest
* A {@link Consumer} that will call methods on {@link EnableRuleRequest.Builder} to create a request.
* @return A Java Future containing the result of the EnableRule operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - ManagedRuleException An AWS service created this rule on behalf of your account. That service manages
* it. If you see this error in response to
DeleteRule
or RemoveTargets
, you can
* use the Force
parameter in those calls to delete the rule or remove targets from the rule.
* You can't modify these managed rules by using DisableRule
, EnableRule
,
* PutTargets
, PutRule
, TagResource
, or UntagResource
.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.EnableRule
* @see AWS API
* Documentation
*/
default CompletableFuture enableRule(Consumer enableRuleRequest) {
return enableRule(EnableRuleRequest.builder().applyMutation(enableRuleRequest).build());
}
/**
*
* Lists all the event buses in your account, including the default event bus, custom event buses, and partner event
* buses.
*
*
*
* This operation is run by AWS customers, not by SaaS partners.
*
*
*
* @param listEventBusesRequest
* @return A Java Future containing the result of the ListEventBuses operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.ListEventBuses
* @see AWS API
* Documentation
*/
default CompletableFuture listEventBuses(ListEventBusesRequest listEventBusesRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Lists all the event buses in your account, including the default event bus, custom event buses, and partner event
* buses.
*
*
*
* This operation is run by AWS customers, not by SaaS partners.
*
*
*
* This is a convenience which creates an instance of the {@link ListEventBusesRequest.Builder} avoiding the need to
* create one manually via {@link ListEventBusesRequest#builder()}
*
*
* @param listEventBusesRequest
* A {@link Consumer} that will call methods on {@link ListEventBusesRequest.Builder} to create a request.
* @return A Java Future containing the result of the ListEventBuses operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.ListEventBuses
* @see AWS API
* Documentation
*/
default CompletableFuture listEventBuses(Consumer listEventBusesRequest) {
return listEventBuses(ListEventBusesRequest.builder().applyMutation(listEventBusesRequest).build());
}
/**
*
* 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.
*
*
*
* This operation is run by AWS customers, not by SaaS partners.
*
*
*
* @param listEventSourcesRequest
* @return A Java Future containing the result of the ListEventSources operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.ListEventSources
* @see AWS
* API Documentation
*/
default CompletableFuture listEventSources(ListEventSourcesRequest listEventSourcesRequest) {
throw new UnsupportedOperationException();
}
/**
*
* 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.
*
*
*
* This operation is run by AWS customers, not by SaaS partners.
*
*
*
* This is a convenience which creates an instance of the {@link ListEventSourcesRequest.Builder} avoiding the need
* to create one manually via {@link ListEventSourcesRequest#builder()}
*
*
* @param listEventSourcesRequest
* A {@link Consumer} that will call methods on {@link ListEventSourcesRequest.Builder} to create a request.
* @return A Java Future containing the result of the ListEventSources operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.ListEventSources
* @see AWS
* API Documentation
*/
default CompletableFuture listEventSources(
Consumer listEventSourcesRequest) {
return listEventSources(ListEventSourcesRequest.builder().applyMutation(listEventSourcesRequest).build());
}
/**
*
* 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 used by SaaS partners, not by AWS customers.
*
*
*
* @param listPartnerEventSourceAccountsRequest
* @return A Java Future containing the result of the ListPartnerEventSourceAccounts operation returned by the
* service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.ListPartnerEventSourceAccounts
* @see AWS API Documentation
*/
default CompletableFuture listPartnerEventSourceAccounts(
ListPartnerEventSourceAccountsRequest listPartnerEventSourceAccountsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* 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 used by SaaS partners, not by AWS customers.
*
*
*
* This is a convenience which creates an instance of the {@link ListPartnerEventSourceAccountsRequest.Builder}
* avoiding the need to create one manually via {@link ListPartnerEventSourceAccountsRequest#builder()}
*
*
* @param listPartnerEventSourceAccountsRequest
* A {@link Consumer} that will call methods on {@link ListPartnerEventSourceAccountsRequest.Builder} to
* create a request.
* @return A Java Future containing the result of the ListPartnerEventSourceAccounts operation returned by the
* service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.ListPartnerEventSourceAccounts
* @see AWS API Documentation
*/
default CompletableFuture listPartnerEventSourceAccounts(
Consumer listPartnerEventSourceAccountsRequest) {
return listPartnerEventSourceAccounts(ListPartnerEventSourceAccountsRequest.builder()
.applyMutation(listPartnerEventSourceAccountsRequest).build());
}
/**
*
* 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.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.ListPartnerEventSources
* @see AWS API Documentation
*/
default CompletableFuture listPartnerEventSources(
ListPartnerEventSourcesRequest listPartnerEventSourcesRequest) {
throw new UnsupportedOperationException();
}
/**
*
* 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.
*
*
*
* This is a convenience which creates an instance of the {@link ListPartnerEventSourcesRequest.Builder} avoiding
* the need to create one manually via {@link ListPartnerEventSourcesRequest#builder()}
*
*
* @param listPartnerEventSourcesRequest
* A {@link Consumer} that will call methods on {@link ListPartnerEventSourcesRequest.Builder} to create a
* request.
* @return A Java Future containing the result of the ListPartnerEventSources operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.ListPartnerEventSources
* @see AWS API Documentation
*/
default CompletableFuture listPartnerEventSources(
Consumer listPartnerEventSourcesRequest) {
return listPartnerEventSources(ListPartnerEventSourcesRequest.builder().applyMutation(listPartnerEventSourcesRequest)
.build());
}
/**
*
* Lists the rules for the specified target. You can see which rules 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.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalException This exception occurs due to unexpected causes.
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.ListRuleNamesByTarget
* @see AWS API Documentation
*/
default CompletableFuture listRuleNamesByTarget(
ListRuleNamesByTargetRequest listRuleNamesByTargetRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Lists the rules for the specified target. You can see which rules can invoke a specific target in your account.
*
*
*
* This is a convenience which creates an instance of the {@link ListRuleNamesByTargetRequest.Builder} avoiding the
* need to create one manually via {@link ListRuleNamesByTargetRequest#builder()}
*
*
* @param listRuleNamesByTargetRequest
* A {@link Consumer} that will call methods on {@link ListRuleNamesByTargetRequest.Builder} to create a
* request.
* @return A Java Future containing the result of the ListRuleNamesByTarget operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalException This exception occurs due to unexpected causes.
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.ListRuleNamesByTarget
* @see AWS API Documentation
*/
default CompletableFuture listRuleNamesByTarget(
Consumer listRuleNamesByTargetRequest) {
return listRuleNamesByTarget(ListRuleNamesByTargetRequest.builder().applyMutation(listRuleNamesByTargetRequest).build());
}
/**
*
* Lists your EventBridge rules. You can either list all the rules or provide a prefix to match to the rule names.
*
*
* ListRules
doesn't 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.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalException This exception occurs due to unexpected causes.
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.ListRules
* @see AWS API
* Documentation
*/
default CompletableFuture listRules(ListRulesRequest listRulesRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Lists your EventBridge rules. You can either list all the rules or provide a prefix to match to the rule names.
*
*
* ListRules
doesn't list the targets of a rule. To see the targets associated with a rule, use
* ListTargetsByRule.
*
*
*
* This is a convenience which creates an instance of the {@link ListRulesRequest.Builder} avoiding the need to
* create one manually via {@link ListRulesRequest#builder()}
*
*
* @param listRulesRequest
* A {@link Consumer} that will call methods on {@link ListRulesRequest.Builder} to create a request.
* @return A Java Future containing the result of the ListRules operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalException This exception occurs due to unexpected causes.
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.ListRules
* @see AWS API
* Documentation
*/
default CompletableFuture listRules(Consumer listRulesRequest) {
return listRules(ListRulesRequest.builder().applyMutation(listRulesRequest).build());
}
/**
*
* Displays the tags associated with an EventBridge resource. In EventBridge, rules can be tagged.
*
*
* @param listTagsForResourceRequest
* @return A Java Future containing the result of the ListTagsForResource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.ListTagsForResource
* @see AWS API Documentation
*/
default CompletableFuture listTagsForResource(
ListTagsForResourceRequest listTagsForResourceRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Displays the tags associated with an EventBridge resource. In EventBridge, rules can be tagged.
*
*
*
* This is a convenience which creates an instance of the {@link ListTagsForResourceRequest.Builder} avoiding the
* need to create one manually via {@link ListTagsForResourceRequest#builder()}
*
*
* @param listTagsForResourceRequest
* A {@link Consumer} that will call methods on {@link ListTagsForResourceRequest.Builder} to create a
* request.
* @return A Java Future containing the result of the ListTagsForResource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.ListTagsForResource
* @see AWS API Documentation
*/
default CompletableFuture listTagsForResource(
Consumer listTagsForResourceRequest) {
return listTagsForResource(ListTagsForResourceRequest.builder().applyMutation(listTagsForResourceRequest).build());
}
/**
*
* 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.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.ListTargetsByRule
* @see AWS
* API Documentation
*/
default CompletableFuture listTargetsByRule(ListTargetsByRuleRequest listTargetsByRuleRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Lists the targets assigned to the specified rule.
*
*
*
* This is a convenience which creates an instance of the {@link ListTargetsByRuleRequest.Builder} avoiding the need
* to create one manually via {@link ListTargetsByRuleRequest#builder()}
*
*
* @param listTargetsByRuleRequest
* A {@link Consumer} that will call methods on {@link ListTargetsByRuleRequest.Builder} to create a request.
* @return A Java Future containing the result of the ListTargetsByRule operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.ListTargetsByRule
* @see AWS
* API Documentation
*/
default CompletableFuture listTargetsByRule(
Consumer listTargetsByRuleRequest) {
return listTargetsByRule(ListTargetsByRuleRequest.builder().applyMutation(listTargetsByRuleRequest).build());
}
/**
*
* Sends custom events to EventBridge so that they can be matched to rules. These events can be from your custom
* applications and services.
*
*
* @param putEventsRequest
* @return A Java Future containing the result of the PutEvents operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.PutEvents
* @see AWS API
* Documentation
*/
default CompletableFuture putEvents(PutEventsRequest putEventsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Sends custom events to EventBridge so that they can be matched to rules. These events can be from your custom
* applications and services.
*
*
*
* This is a convenience which creates an instance of the {@link PutEventsRequest.Builder} avoiding the need to
* create one manually via {@link PutEventsRequest#builder()}
*
*
* @param putEventsRequest
* A {@link Consumer} that will call methods on {@link PutEventsRequest.Builder} to create a request.
* @return A Java Future containing the result of the PutEvents operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.PutEvents
* @see AWS API
* Documentation
*/
default CompletableFuture putEvents(Consumer putEventsRequest) {
return putEvents(PutEventsRequest.builder().applyMutation(putEventsRequest).build());
}
/**
*
* This is used by SaaS partners to write events to a customer's partner event bus.
*
*
*
* AWS customers do not use this operation. Instead, AWS customers can use PutEvents to write custom events
* from their own applications to an event bus.
*
*
*
* @param putPartnerEventsRequest
* @return A Java Future containing the result of the PutPartnerEvents operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.PutPartnerEvents
* @see AWS
* API Documentation
*/
default CompletableFuture putPartnerEvents(PutPartnerEventsRequest putPartnerEventsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* This is used by SaaS partners to write events to a customer's partner event bus.
*
*
*
* AWS customers do not use this operation. Instead, AWS customers can use PutEvents to write custom events
* from their own applications to an event bus.
*
*
*
* This is a convenience which creates an instance of the {@link PutPartnerEventsRequest.Builder} avoiding the need
* to create one manually via {@link PutPartnerEventsRequest#builder()}
*
*
* @param putPartnerEventsRequest
* A {@link Consumer} that will call methods on {@link PutPartnerEventsRequest.Builder} to create a request.
* @return A Java Future containing the result of the PutPartnerEvents operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.PutPartnerEvents
* @see AWS
* API Documentation
*/
default CompletableFuture putPartnerEvents(
Consumer putPartnerEventsRequest) {
return putPartnerEvents(PutPartnerEventsRequest.builder().applyMutation(putPartnerEventsRequest).build());
}
/**
*
* Running PutPermission
permits the specified AWS account or AWS organization to put events to the
* specified event bus. 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 a rule with your account's
* event bus as a target.
*
*
* To enable multiple AWS accounts to put events to an 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 an event bus can't exceed 10 KB in size.
*
*
* @param putPermissionRequest
* @return A Java Future containing the result of the PutPermission operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - PolicyLengthExceededException The event bus policy is too long. For more information, see the limits.
*
* - InternalException This exception occurs due to unexpected causes.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.PutPermission
* @see AWS API
* Documentation
*/
default CompletableFuture putPermission(PutPermissionRequest putPermissionRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Running PutPermission
permits the specified AWS account or AWS organization to put events to the
* specified event bus. 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 a rule with your account's
* event bus as a target.
*
*
* To enable multiple AWS accounts to put events to an 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 an event bus can't exceed 10 KB in size.
*
*
*
* This is a convenience which creates an instance of the {@link PutPermissionRequest.Builder} avoiding the need to
* create one manually via {@link PutPermissionRequest#builder()}
*
*
* @param putPermissionRequest
* A {@link Consumer} that will call methods on {@link PutPermissionRequest.Builder} to create a request.
* @return A Java Future containing the result of the PutPermission operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - PolicyLengthExceededException The event bus policy is too long. For more information, see the limits.
*
* - InternalException This exception occurs due to unexpected causes.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.PutPermission
* @see AWS API
* Documentation
*/
default CompletableFuture putPermission(Consumer putPermissionRequest) {
return putPermission(PutPermissionRequest.builder().applyMutation(putPermissionRequest).build());
}
/**
*
* 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're 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 aren't kept. Instead,
* they're 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 that you want to match.
*
*
* In EventBridge, you could 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 you don't write the rule 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 don't refire 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.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InvalidEventPatternException The event pattern isn't valid.
* - LimitExceededException You tried to create more resources than is allowed.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - ManagedRuleException An AWS service created this rule on behalf of your account. That service manages
* it. If you see this error in response to
DeleteRule
or RemoveTargets
, you can
* use the Force
parameter in those calls to delete the rule or remove targets from the rule.
* You can't modify these managed rules by using DisableRule
, EnableRule
,
* PutTargets
, PutRule
, TagResource
, or UntagResource
.
* - InternalException This exception occurs due to unexpected causes.
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.PutRule
* @see AWS API
* Documentation
*/
default CompletableFuture putRule(PutRuleRequest putRuleRequest) {
throw new UnsupportedOperationException();
}
/**
*
* 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're 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 aren't kept. Instead,
* they're 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 that you want to match.
*
*
* In EventBridge, you could 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 you don't write the rule 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 don't refire 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.
*
*
*
* This is a convenience which creates an instance of the {@link PutRuleRequest.Builder} avoiding the need to create
* one manually via {@link PutRuleRequest#builder()}
*
*
* @param putRuleRequest
* A {@link Consumer} that will call methods on {@link PutRuleRequest.Builder} to create a request.
* @return A Java Future containing the result of the PutRule operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InvalidEventPatternException The event pattern isn't valid.
* - LimitExceededException You tried to create more resources than is allowed.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - ManagedRuleException An AWS service created this rule on behalf of your account. That service manages
* it. If you see this error in response to
DeleteRule
or RemoveTargets
, you can
* use the Force
parameter in those calls to delete the rule or remove targets from the rule.
* You can't modify these managed rules by using DisableRule
, EnableRule
,
* PutTargets
, PutRule
, TagResource
, or UntagResource
.
* - InternalException This exception occurs due to unexpected causes.
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.PutRule
* @see AWS API
* Documentation
*/
default CompletableFuture putRule(Consumer putRuleRequest) {
return putRule(PutRuleRequest.builder().applyMutation(putRuleRequest).build());
}
/**
*
* Adds the specified targets to the specified rule, or updates the targets if they're already associated with the
* rule.
*
*
* Targets are the resources that are invoked when a rule is triggered.
*
*
* You can configure the following as targets in EventBridge:
*
*
* -
*
* 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
*
*
*
*
* Creating rules with built-in targets is supported only on 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 needs the appropriate
* permissions. For AWS Lambda and Amazon SNS resources, EventBridge relies on resource-based policies. For EC2
* instances, Kinesis data streams, and AWS Step Functions state machines, 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
* isn't charged. For more information, see Amazon EventBridge
* Pricing.
*
*
* If you're setting an event bus in another account as the target and that account granted permission to your
* account through an organization instead of directly by the account ID, 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, 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
), 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, 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 nonzero 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.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - LimitExceededException You tried to create more resources than is allowed.
* - ManagedRuleException An AWS service created this rule on behalf of your account. That service manages
* it. If you see this error in response to
DeleteRule
or RemoveTargets
, you can
* use the Force
parameter in those calls to delete the rule or remove targets from the rule.
* You can't modify these managed rules by using DisableRule
, EnableRule
,
* PutTargets
, PutRule
, TagResource
, or UntagResource
.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.PutTargets
* @see AWS API
* Documentation
*/
default CompletableFuture putTargets(PutTargetsRequest putTargetsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Adds the specified targets to the specified rule, or updates the targets if they're already associated with the
* rule.
*
*
* Targets are the resources that are invoked when a rule is triggered.
*
*
* You can configure the following as targets in EventBridge:
*
*
* -
*
* 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
*
*
*
*
* Creating rules with built-in targets is supported only on 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 needs the appropriate
* permissions. For AWS Lambda and Amazon SNS resources, EventBridge relies on resource-based policies. For EC2
* instances, Kinesis data streams, and AWS Step Functions state machines, 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
* isn't charged. For more information, see Amazon EventBridge
* Pricing.
*
*
* If you're setting an event bus in another account as the target and that account granted permission to your
* account through an organization instead of directly by the account ID, 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, 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
), 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, 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 nonzero in the response, and each entry in FailedEntries
provides
* the ID of the failed target and the error code.
*
*
*
* This is a convenience which creates an instance of the {@link PutTargetsRequest.Builder} avoiding the need to
* create one manually via {@link PutTargetsRequest#builder()}
*
*
* @param putTargetsRequest
* A {@link Consumer} that will call methods on {@link PutTargetsRequest.Builder} to create a request.
* @return A Java Future containing the result of the PutTargets operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - LimitExceededException You tried to create more resources than is allowed.
* - ManagedRuleException An AWS service created this rule on behalf of your account. That service manages
* it. If you see this error in response to
DeleteRule
or RemoveTargets
, you can
* use the Force
parameter in those calls to delete the rule or remove targets from the rule.
* You can't modify these managed rules by using DisableRule
, EnableRule
,
* PutTargets
, PutRule
, TagResource
, or UntagResource
.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.PutTargets
* @see AWS API
* Documentation
*/
default CompletableFuture putTargets(Consumer putTargetsRequest) {
return putTargets(PutTargetsRequest.builder().applyMutation(putTargetsRequest).build());
}
/**
*
* 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.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InternalException This exception occurs due to unexpected causes.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.RemovePermission
* @see AWS
* API Documentation
*/
default CompletableFuture removePermission(RemovePermissionRequest removePermissionRequest) {
throw new UnsupportedOperationException();
}
/**
*
* 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.
*
*
*
* This is a convenience which creates an instance of the {@link RemovePermissionRequest.Builder} avoiding the need
* to create one manually via {@link RemovePermissionRequest#builder()}
*
*
* @param removePermissionRequest
* A {@link Consumer} that will call methods on {@link RemovePermissionRequest.Builder} to create a request.
* @return A Java Future containing the result of the RemovePermission operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InternalException This exception occurs due to unexpected causes.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.RemovePermission
* @see AWS
* API Documentation
*/
default CompletableFuture removePermission(
Consumer removePermissionRequest) {
return removePermission(RemovePermissionRequest.builder().applyMutation(removePermissionRequest).build());
}
/**
*
* 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.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - ManagedRuleException An AWS service created this rule on behalf of your account. That service manages
* it. If you see this error in response to
DeleteRule
or RemoveTargets
, you can
* use the Force
parameter in those calls to delete the rule or remove targets from the rule.
* You can't modify these managed rules by using DisableRule
, EnableRule
,
* PutTargets
, PutRule
, TagResource
, or UntagResource
.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.RemoveTargets
* @see AWS API
* Documentation
*/
default CompletableFuture removeTargets(RemoveTargetsRequest removeTargetsRequest) {
throw new UnsupportedOperationException();
}
/**
*
* 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.
*
*
*
* This is a convenience which creates an instance of the {@link RemoveTargetsRequest.Builder} avoiding the need to
* create one manually via {@link RemoveTargetsRequest#builder()}
*
*
* @param removeTargetsRequest
* A {@link Consumer} that will call methods on {@link RemoveTargetsRequest.Builder} to create a request.
* @return A Java Future containing the result of the RemoveTargets operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - ManagedRuleException An AWS service created this rule on behalf of your account. That service manages
* it. If you see this error in response to
DeleteRule
or RemoveTargets
, you can
* use the Force
parameter in those calls to delete the rule or remove targets from the rule.
* You can't modify these managed rules by using DisableRule
, EnableRule
,
* PutTargets
, PutRule
, TagResource
, or UntagResource
.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.RemoveTargets
* @see AWS API
* Documentation
*/
default CompletableFuture removeTargets(Consumer removeTargetsRequest) {
return removeTargets(RemoveTargetsRequest.builder().applyMutation(removeTargetsRequest).build());
}
/**
*
* 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 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 rule that already has tags. If you specify a new tag key
* for the rule, this tag is appended to the list of tags associated with the rule. If you specify a tag key that is
* already associated with the rule, 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.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - InternalException This exception occurs due to unexpected causes.
* - ManagedRuleException An AWS service created this rule on behalf of your account. That service manages
* it. If you see this error in response to
DeleteRule
or RemoveTargets
, you can
* use the Force
parameter in those calls to delete the rule or remove targets from the rule.
* You can't modify these managed rules by using DisableRule
, EnableRule
,
* PutTargets
, PutRule
, TagResource
, or UntagResource
.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.TagResource
* @see AWS API
* Documentation
*/
default CompletableFuture tagResource(TagResourceRequest tagResourceRequest) {
throw new UnsupportedOperationException();
}
/**
*
* 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 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 rule that already has tags. If you specify a new tag key
* for the rule, this tag is appended to the list of tags associated with the rule. If you specify a tag key that is
* already associated with the rule, 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.
*
*
*
* This is a convenience which creates an instance of the {@link TagResourceRequest.Builder} avoiding the need to
* create one manually via {@link TagResourceRequest#builder()}
*
*
* @param tagResourceRequest
* A {@link Consumer} that will call methods on {@link TagResourceRequest.Builder} to create a request.
* @return A Java Future containing the result of the TagResource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - InternalException This exception occurs due to unexpected causes.
* - ManagedRuleException An AWS service created this rule on behalf of your account. That service manages
* it. If you see this error in response to
DeleteRule
or RemoveTargets
, you can
* use the Force
parameter in those calls to delete the rule or remove targets from the rule.
* You can't modify these managed rules by using DisableRule
, EnableRule
,
* PutTargets
, PutRule
, TagResource
, or UntagResource
.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.TagResource
* @see AWS API
* Documentation
*/
default CompletableFuture tagResource(Consumer tagResourceRequest) {
return tagResource(TagResourceRequest.builder().applyMutation(tagResourceRequest).build());
}
/**
*
* 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 that you want to match.
*
*
* @param testEventPatternRequest
* @return A Java Future containing the result of the TestEventPattern operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InvalidEventPatternException The event pattern isn't valid.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.TestEventPattern
* @see AWS
* API Documentation
*/
default CompletableFuture testEventPattern(TestEventPatternRequest testEventPatternRequest) {
throw new UnsupportedOperationException();
}
/**
*
* 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 that you want to match.
*
*
*
* This is a convenience which creates an instance of the {@link TestEventPatternRequest.Builder} avoiding the need
* to create one manually via {@link TestEventPatternRequest#builder()}
*
*
* @param testEventPatternRequest
* A {@link Consumer} that will call methods on {@link TestEventPatternRequest.Builder} to create a request.
* @return A Java Future containing the result of the TestEventPattern operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - InvalidEventPatternException The event pattern isn't valid.
* - InternalException This exception occurs due to unexpected causes.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.TestEventPattern
* @see AWS
* API Documentation
*/
default CompletableFuture testEventPattern(
Consumer testEventPatternRequest) {
return testEventPattern(TestEventPatternRequest.builder().applyMutation(testEventPatternRequest).build());
}
/**
*
* Removes one or more tags from the specified EventBridge resource. In EventBridge, rules can be tagged.
*
*
* @param untagResourceRequest
* @return A Java Future containing the result of the UntagResource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InternalException This exception occurs due to unexpected causes.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - ManagedRuleException An AWS service created this rule on behalf of your account. That service manages
* it. If you see this error in response to
DeleteRule
or RemoveTargets
, you can
* use the Force
parameter in those calls to delete the rule or remove targets from the rule.
* You can't modify these managed rules by using DisableRule
, EnableRule
,
* PutTargets
, PutRule
, TagResource
, or UntagResource
.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.UntagResource
* @see AWS API
* Documentation
*/
default CompletableFuture untagResource(UntagResourceRequest untagResourceRequest) {
throw new UnsupportedOperationException();
}
/**
*
* Removes one or more tags from the specified EventBridge resource. In EventBridge, rules can be tagged.
*
*
*
* This is a convenience which creates an instance of the {@link UntagResourceRequest.Builder} avoiding the need to
* create one manually via {@link UntagResourceRequest#builder()}
*
*
* @param untagResourceRequest
* A {@link Consumer} that will call methods on {@link UntagResourceRequest.Builder} to create a request.
* @return A Java Future containing the result of the UntagResource operation returned by the service.
* The CompletableFuture returned by this method can be completed exceptionally with the following
* exceptions.
*
* - ResourceNotFoundException An entity that you specified doesn't exist.
* - InternalException This exception occurs due to unexpected causes.
* - ConcurrentModificationException There is concurrent modification on a resource.
* - ManagedRuleException An AWS service created this rule on behalf of your account. That service manages
* it. If you see this error in response to
DeleteRule
or RemoveTargets
, you can
* use the Force
parameter in those calls to delete the rule or remove targets from the rule.
* You can't modify these managed rules by using DisableRule
, EnableRule
,
* PutTargets
, PutRule
, TagResource
, or UntagResource
.
* - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client).
* Can be used for catch all scenarios.
* - SdkClientException If any client side error occurs such as an IO related failure, failure to get
* credentials, etc.
* - EventBridgeException Base class for all service exceptions. Unknown exceptions will be thrown as an
* instance of this type.
*
* @sample EventBridgeAsyncClient.UntagResource
* @see AWS API
* Documentation
*/
default CompletableFuture untagResource(Consumer untagResourceRequest) {
return untagResource(UntagResourceRequest.builder().applyMutation(untagResourceRequest).build());
}
}