software.amazon.awscdk.services.events

Interface ApiDestinationProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

ApiDestinationProps.Jsii$Proxy

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

The event API Destination properties.

Example:

 Connection connection = Connection.Builder.create(this, "Connection")
         .authorization(Authorization.apiKey("x-api-key", SecretValue.secretsManager("ApiSecretName")))
         .description("Connection with API Key x-api-key")
         .build();
 ApiDestination destination = ApiDestination.Builder.create(this, "Destination")
         .connection(connection)
         .endpoint("https://example.com")
         .description("Calling example.com with API key x-api-key")
         .build();
 Rule rule = Rule.Builder.create(this, "Rule")
         .schedule(Schedule.rate(Duration.minutes(1)))
         .targets(List.of(new ApiDestination(destination)))
         .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 String	getApiDestinationName() The name for the API destination.
IConnection	getConnection() The ARN of the connection to use for the API destination.
default String	getDescription() A description for the API destination.
String	getEndpoint() The URL to the HTTP invocation endpoint for the API destination..
default HttpMethod	getHttpMethod() The method to use for the request to the HTTP invocation endpoint.
default Number	getRateLimitPerSecond() The maximum number of requests per second to send to the HTTP invocation endpoint.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getConnection

@Stability(value=Stable)
 @NotNull
IConnection getConnection()

The ARN of the connection to use for the API destination.

getEndpoint

@Stability(value=Stable)
 @NotNull
String getEndpoint()

The URL to the HTTP invocation endpoint for the API destination..

getApiDestinationName

@Stability(value=Stable)
 @Nullable
default String getApiDestinationName()

The name for the API destination.

Default: - A unique name will be generated

getDescription

@Stability(value=Stable)
 @Nullable
default String getDescription()

A description for the API destination.

Default: - none

getHttpMethod

@Stability(value=Stable)
 @Nullable
default HttpMethod getHttpMethod()

The method to use for the request to the HTTP invocation endpoint.

Default: HttpMethod.POST

getRateLimitPerSecond

@Stability(value=Stable)
 @Nullable
default Number getRateLimitPerSecond()

The maximum number of requests per second to send to the HTTP invocation endpoint.

Default: - Not rate limited

builder

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

Returns:

a ApiDestinationProps.Builder of ApiDestinationProps