software.amazon.awscdk.services.events.targets

Interface ApiGatewayProps

All Superinterfaces:

TargetBaseProps

All Known Implementing Classes:

ApiGatewayProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.63.2 (build a8a8833)",
           date="2022-08-09T19:16:44.189Z")
public interface ApiGatewayProps
extends TargetBaseProps

Customize the API Gateway Event Target.

Example:

 import software.amazon.awscdk.services.apigateway.*;
 import software.amazon.awscdk.services.lambda.*;
 Rule rule = Rule.Builder.create(this, "Rule")
         .schedule(Schedule.rate(Duration.minutes(1)))
         .build();
 Function fn = Function.Builder.create(this, "MyFunc")
         .handler("index.handler")
         .runtime(Runtime.NODEJS_12_X)
         .code(Code.fromInline("exports.handler = e => {}"))
         .build();
 LambdaRestApi restApi = LambdaRestApi.Builder.create(this, "MyRestAPI").handler(fn).build();
 Queue dlq = new Queue(this, "DeadLetterQueue");
 rule.addTarget(
 ApiGateway.Builder.create(restApi)
         .path("/*/test")
         .method("GET")
         .stage("prod")
         .pathParameterValues(List.of("path-value"))
         .headerParameters(Map.of(
                 "Header1", "header1"))
         .queryStringParameters(Map.of(
                 "QueryParam1", "query-param-1"))
         .deadLetterQueue(dlq)
         .build());
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method and Description
static ApiGatewayProps.Builder	builder()
default IRole	getEventRole() The role to assume before invoking the target (i.e., the pipeline) when the given rule is triggered.
default java.util.Map<java.lang.String,java.lang.String>	getHeaderParameters() The headers to be set when requesting API.
default java.lang.String	getMethod() The method for api resource invoked by the rule.
default java.lang.String	getPath() The api resource invoked by the rule.
default java.util.List<java.lang.String>	getPathParameterValues() The path parameter values to be used to populate to wildcards("*") of requesting api path.
default RuleTargetInput	getPostBody() This will be the post request body send to the API.
default java.util.Map<java.lang.String,java.lang.String>	getQueryStringParameters() The query parameters to be set when requesting API.
default java.lang.String	getStage() The deploy stage of api gateway invoked by the rule.

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

getDeadLetterQueue, getMaxEventAge, getRetryAttempts

Method Detail

getEventRole

default IRole getEventRole()

The role to assume before invoking the target (i.e., the pipeline) when the given rule is triggered.

Default: - a new role will be created

getHeaderParameters

default java.util.Map<java.lang.String,java.lang.String> getHeaderParameters()

The headers to be set when requesting API.

Default: no header parameters

getMethod

default java.lang.String getMethod()

The method for api resource invoked by the rule.

Default: '*' that treated as ANY

getPath

default java.lang.String getPath()

The api resource invoked by the rule.

We can use wildcards('*') to specify the path. In that case, an equal number of real values must be specified for pathParameterValues.

Default: '/'

getPathParameterValues

default java.util.List<java.lang.String> getPathParameterValues()

The path parameter values to be used to populate to wildcards("*") of requesting api path.

Default: no path parameters

getPostBody

default RuleTargetInput getPostBody()

This will be the post request body send to the API.

Default: the entire EventBridge event

getQueryStringParameters

default java.util.Map<java.lang.String,java.lang.String> getQueryStringParameters()

The query parameters to be set when requesting API.

Default: no querystring parameters

getStage

default java.lang.String getStage()

The deploy stage of api gateway invoked by the rule.

Default: the value of deploymentStage.stageName of target api gateway.

builder

static ApiGatewayProps.Builder builder()

Specified by:

builder in interface TargetBaseProps

Returns:

a ApiGatewayProps.Builder of ApiGatewayProps