software.amazon.awscdk.services.lambda.eventsources

Class ApiEventSource.Builder

java.lang.Object

software.amazon.awscdk.services.lambda.eventsources.ApiEventSource.Builder

All Implemented Interfaces:

software.amazon.jsii.Builder<ApiEventSource>

Enclosing class:

ApiEventSource

@Stability(value=Experimental)
public static final class ApiEventSource.Builder
extends Object
implements software.amazon.jsii.Builder<ApiEventSource>

(experimental) A fluent builder for ApiEventSource.

Method Summary

Modifier and Type	Method and Description
ApiEventSource.Builder	apiKeyRequired(Boolean apiKeyRequired) (experimental) Indicates whether the method requires clients to submit a valid API key.
ApiEventSource.Builder	authorizationScopes(List<String> authorizationScopes) (experimental) A list of authorization scopes configured on the method.
ApiEventSource.Builder	authorizationType(AuthorizationType authorizationType) (experimental) Method authorization.
ApiEventSource.Builder	authorizer(IAuthorizer authorizer) (experimental) If `authorizationType` is `Custom`, this specifies the ID of the method authorizer resource.
ApiEventSource	build()
static ApiEventSource.Builder	create(String method, String path)
ApiEventSource.Builder	methodResponses(List<? extends MethodResponse> methodResponses) (experimental) The responses that can be sent to the client who calls the method.
ApiEventSource.Builder	operationName(String operationName) (experimental) A friendly operation name for the method.
ApiEventSource.Builder	requestModels(Map<String,? extends IModel> requestModels) (experimental) The models which describe data structure of request payload.
ApiEventSource.Builder	requestParameters(Map<String,? extends Boolean> requestParameters) (experimental) The request parameters that API Gateway accepts.
ApiEventSource.Builder	requestValidator(IRequestValidator requestValidator) (experimental) The ID of the associated request validator.
ApiEventSource.Builder	requestValidatorOptions(RequestValidatorOptions requestValidatorOptions) (experimental) Request validator options to create new validator Only one of `requestValidator` or `requestValidatorOptions` must be specified.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

@Stability(value=Experimental)
public static ApiEventSource.Builder create(String method,
                                                                           String path)

Parameters:

method - This parameter is required.

path - This parameter is required.

Returns:

a new instance of ApiEventSource.Builder.

apiKeyRequired

@Stability(value=Experimental)
public ApiEventSource.Builder apiKeyRequired(Boolean apiKeyRequired)

(experimental) Indicates whether the method requires clients to submit a valid API key.

Default: false

Parameters:

apiKeyRequired - Indicates whether the method requires clients to submit a valid API key. This parameter is required.

Returns:

this

authorizationScopes

@Stability(value=Experimental)
public ApiEventSource.Builder authorizationScopes(List<String> authorizationScopes)

(experimental) A list of authorization scopes configured on the method.

The scopes are used with a COGNITO_USER_POOLS authorizer to authorize the method invocation.

Default: - no authorization scopes

Parameters:

authorizationScopes - A list of authorization scopes configured on the method. This parameter is required.

Returns:

this

See Also:

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-method.html#cfn-apigateway-method-authorizationscopes

authorizationType

@Stability(value=Experimental)
public ApiEventSource.Builder authorizationType(AuthorizationType authorizationType)

(experimental) Method authorization. If the value is set of `Custom`, an `authorizer` must also be specified.

If you're using one of the authorizers that are available via the {@link Authorizer} class, such as {@link Authorizer#token()}, it is recommended that this option not be specified. The authorizer will take care of setting the correct authorization type. However, specifying an authorization type using this property that conflicts with what is expected by the {@link Authorizer} will result in an error.

Default: - open access unless `authorizer` is specified

Parameters:

authorizationType - Method authorization. If the value is set of `Custom`, an `authorizer` must also be specified. This parameter is required.

Returns:

this

authorizer

@Stability(value=Experimental)
public ApiEventSource.Builder authorizer(IAuthorizer authorizer)

(experimental) If `authorizationType` is `Custom`, this specifies the ID of the method authorizer resource.

If specified, the value of authorizationType must be set to Custom

Parameters:

authorizer - If `authorizationType` is `Custom`, this specifies the ID of the method authorizer resource. This parameter is required.

Returns:

this

methodResponses

@Stability(value=Experimental)
public ApiEventSource.Builder methodResponses(List<? extends MethodResponse> methodResponses)

(experimental) The responses that can be sent to the client who calls the method.

Default: None This property is not required, but if these are not supplied for a Lambda proxy integration, the Lambda function must return a value of the correct format, for the integration response to be correctly mapped to a response to the client.

Parameters:

methodResponses - The responses that can be sent to the client who calls the method. This parameter is required.

Returns:

this

See Also:

https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-method-settings-method-response.html

operationName

@Stability(value=Experimental)
public ApiEventSource.Builder operationName(String operationName)

(experimental) A friendly operation name for the method.

For example, you can assign the OperationName of ListPets for the GET /pets method.

Parameters:

operationName - A friendly operation name for the method. This parameter is required.

Returns:

this

requestModels

@Stability(value=Experimental)
public ApiEventSource.Builder requestModels(Map<String,? extends IModel> requestModels)

(experimental) The models which describe data structure of request payload.

When combined with requestValidator or requestValidatorOptions, the service will validate the API request payload before it reaches the API's Integration (including proxies). Specify requestModels as key-value pairs, with a content type (e.g. 'application/json') as the key and an API Gateway Model as the value.

Example:

 // Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
 Object userModel = api.addModel("UserModel", Map.of(
         "schema", Map.of(
                 "type", apigateway.JsonSchemaType.getOBJECT(),
                 "properties", Map.of(
                         "userId", Map.of(
                                 "type", apigateway.JsonSchema.getSTRING()),
                         "name", Map.of(
                                 "type", apigateway.JsonSchema.getSTRING())),
                 "required", asList("userId"))));
 api.root.addResource('user').addMethod("POST",
 new LambdaIntegration(userLambda), Map.of(
         "requestModels", Map.of(
                 "application/json", userModel)));

Parameters:

requestModels - The models which describe data structure of request payload. This parameter is required.

Returns:

this

See Also:

https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-method-settings-method-request.html#setup-method-request-model

requestParameters

@Stability(value=Experimental)
public ApiEventSource.Builder requestParameters(Map<String,? extends Boolean> requestParameters)

(experimental) The request parameters that API Gateway accepts.

Specify request parameters as key-value pairs (string-to-Boolean mapping), with a source as the key and a Boolean as the value. The Boolean specifies whether a parameter is required. A source must match the format method.request.location.name, where the location is querystring, path, or header, and name is a valid, unique parameter name.

Default: None

Parameters:

requestParameters - The request parameters that API Gateway accepts. This parameter is required.

Returns:

this

requestValidator

@Stability(value=Experimental)
public ApiEventSource.Builder requestValidator(IRequestValidator requestValidator)

(experimental) The ID of the associated request validator.

Only one of requestValidator or requestValidatorOptions must be specified. Works together with requestModels or requestParameters to validate the request before it reaches integration like Lambda Proxy Integration.

Default: - No default validator

Parameters:

requestValidator - The ID of the associated request validator. This parameter is required.

Returns:

this

requestValidatorOptions

@Stability(value=Experimental)
public ApiEventSource.Builder requestValidatorOptions(RequestValidatorOptions requestValidatorOptions)

(experimental) Request validator options to create new validator Only one of `requestValidator` or `requestValidatorOptions` must be specified.

Works together with requestModels or requestParameters to validate the request before it reaches integration like Lambda Proxy Integration.

Default: - No default validator

Parameters:

requestValidatorOptions - Request validator options to create new validator Only one of `requestValidator` or `requestValidatorOptions` must be specified. This parameter is required.

Returns:

this

build

@Stability(value=Experimental)
public ApiEventSource build()

Specified by:

build in interface software.amazon.jsii.Builder<ApiEventSource>