software.amazon.awscdk.services.events.targets

Interface ApiDestinationProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable, TargetBaseProps

All Known Implementing Classes:

ApiDestinationProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:39.317Z")
 @Stability(value=Stable)
public interface ApiDestinationProps
extends software.amazon.jsii.JsiiSerializable, TargetBaseProps

Customize the EventBridge Api Destinations Target.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.*;
 import software.amazon.awscdk.services.events.*;
 import software.amazon.awscdk.services.events.targets.*;
 import software.amazon.awscdk.services.iam.*;
 import software.amazon.awscdk.services.sqs.*;
 Queue queue;
 Role role;
 RuleTargetInput ruleTargetInput;
 ApiDestinationProps apiDestinationProps = ApiDestinationProps.builder()
         .deadLetterQueue(queue)
         .event(ruleTargetInput)
         .eventRole(role)
         .headerParameters(Map.of(
                 "headerParametersKey", "headerParameters"))
         .maxEventAge(Duration.minutes(30))
         .pathParameterValues(List.of("pathParameterValues"))
         .queryStringParameters(Map.of(
                 "queryStringParametersKey", "queryStringParameters"))
         .retryAttempts(123)
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	ApiDestinationProps.Builder A builder for ApiDestinationProps
static class	ApiDestinationProps.Jsii$Proxy An implementation for ApiDestinationProps

Method Summary

Modifier and Type	Method and Description
static ApiDestinationProps.Builder	builder()
default RuleTargetInput	getEvent() The event to send.
default IRole	getEventRole() The role to assume before invoking the target.
default Map<String,String>	getHeaderParameters() Additional headers sent to the API Destination.
default List<String>	getPathParameterValues() Path parameters to insert in place of path wildcards (`*`).
default Map<String,String>	getQueryStringParameters() Additional query string parameters sent to the API Destination.

Methods inherited from interface software.amazon.awscdk.services.events.targets.TargetBaseProps

getDeadLetterQueue, getMaxEventAge, getRetryAttempts

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getEvent

@Stability(value=Stable)
 @Nullable
default RuleTargetInput getEvent()

The event to send.

Default: - the entire EventBridge event

getEventRole

@Stability(value=Stable)
 @Nullable
default IRole getEventRole()

The role to assume before invoking the target.

Default: - a new role will be created

getHeaderParameters

@Stability(value=Stable)
 @Nullable
default Map<String,String> getHeaderParameters()

Additional headers sent to the API Destination.

These are merged with headers specified on the Connection, with the headers on the Connection taking precedence.

You can only specify secret values on the Connection.

Default: - none

getPathParameterValues

@Stability(value=Stable)
 @Nullable
default List<String> getPathParameterValues()

Path parameters to insert in place of path wildcards (`*`).

If the API destination has a wilcard in the path, these path parts will be inserted in that place.

Default: - none

getQueryStringParameters

@Stability(value=Stable)
 @Nullable
default Map<String,String> getQueryStringParameters()

Additional query string parameters sent to the API Destination.

These are merged with headers specified on the Connection, with the headers on the Connection taking precedence.

You can only specify secret values on the Connection.

Default: - none

builder

@Stability(value=Stable)
static ApiDestinationProps.Builder builder()

Specified by:

builder in interface TargetBaseProps

Returns:

a ApiDestinationProps.Builder of ApiDestinationProps