software.amazon.awscdk.services.apigateway

Interface StepFunctionsExecutionIntegrationOptions

All Superinterfaces:

IntegrationOptions, software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

StepFunctionsExecutionIntegrationOptions.Jsii$Proxy

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

Options when configuring Step Functions synchronous integration with Rest API.

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.apigateway.*;
 import software.amazon.awscdk.services.iam.*;
 Role role;
 VpcLink vpcLink;
 StepFunctionsExecutionIntegrationOptions stepFunctionsExecutionIntegrationOptions = StepFunctionsExecutionIntegrationOptions.builder()
         .authorizer(false)
         .cacheKeyParameters(List.of("cacheKeyParameters"))
         .cacheNamespace("cacheNamespace")
         .connectionType(ConnectionType.INTERNET)
         .contentHandling(ContentHandling.CONVERT_TO_BINARY)
         .credentialsPassthrough(false)
         .credentialsRole(role)
         .headers(false)
         .integrationResponses(List.of(IntegrationResponse.builder()
                 .statusCode("statusCode")
                 // the properties below are optional
                 .contentHandling(ContentHandling.CONVERT_TO_BINARY)
                 .responseParameters(Map.of(
                         "responseParametersKey", "responseParameters"))
                 .responseTemplates(Map.of(
                         "responseTemplatesKey", "responseTemplates"))
                 .selectionPattern("selectionPattern")
                 .build()))
         .passthroughBehavior(PassthroughBehavior.WHEN_NO_MATCH)
         .path(false)
         .querystring(false)
         .requestContext(RequestContext.builder()
                 .accountId(false)
                 .apiId(false)
                 .apiKey(false)
                 .authorizerPrincipalId(false)
                 .caller(false)
                 .cognitoAuthenticationProvider(false)
                 .cognitoAuthenticationType(false)
                 .cognitoIdentityId(false)
                 .cognitoIdentityPoolId(false)
                 .httpMethod(false)
                 .requestId(false)
                 .resourceId(false)
                 .resourcePath(false)
                 .sourceIp(false)
                 .stage(false)
                 .user(false)
                 .userAgent(false)
                 .userArn(false)
                 .build())
         .requestParameters(Map.of(
                 "requestParametersKey", "requestParameters"))
         .requestTemplates(Map.of(
                 "requestTemplatesKey", "requestTemplates"))
         .timeout(Duration.minutes(30))
         .vpcLink(vpcLink)
         .build();
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method and Description
static StepFunctionsExecutionIntegrationOptions.Builder	builder()
default Boolean	getAuthorizer() If the whole authorizer object, including custom context values should be in the execution input.
default Boolean	getHeaders() Check if header is to be included inside the execution input.
default Boolean	getPath() Check if path is to be included inside the execution input.
default Boolean	getQuerystring() Check if querystring is to be included inside the execution input.
default RequestContext	getRequestContext() Which details of the incoming request must be passed onto the underlying state machine, such as, account id, user identity, request id, etc.

Methods inherited from interface software.amazon.awscdk.services.apigateway.IntegrationOptions

getCacheKeyParameters, getCacheNamespace, getConnectionType, getContentHandling, getCredentialsPassthrough, getCredentialsRole, getIntegrationResponses, getPassthroughBehavior, getRequestParameters, getRequestTemplates, getTimeout, getVpcLink

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getAuthorizer

@Stability(value=Stable)
 @Nullable
default Boolean getAuthorizer()

If the whole authorizer object, including custom context values should be in the execution input.

The execution input will include a new key authorizer:

{ "body": {}, "authorizer": { "key": "value" } }

Default: false

getHeaders

@Stability(value=Stable)
 @Nullable
default Boolean getHeaders()

Check if header is to be included inside the execution input.

The execution input will include a new key headers:

{ "body": {}, "headers": { "header1": "value", "header2": "value" } }

Default: false

getPath

@Stability(value=Stable)
 @Nullable
default Boolean getPath()

Check if path is to be included inside the execution input.

The execution input will include a new key path:

{ "body": {}, "path": { "resourceName": "resourceValue" } }

Default: true

getQuerystring

@Stability(value=Stable)
 @Nullable
default Boolean getQuerystring()

Check if querystring is to be included inside the execution input.

The execution input will include a new key queryString:

{ "body": {}, "querystring": { "key": "value" } }

Default: true

getRequestContext

@Stability(value=Stable)
 @Nullable
default RequestContext getRequestContext()

Which details of the incoming request must be passed onto the underlying state machine, such as, account id, user identity, request id, etc.

The execution input will include a new key requestContext:

{ "body": {}, "requestContext": { "key": "value" } }

Default: - all parameters within request context will be set as false

builder

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

Specified by:

builder in interface IntegrationOptions

Returns:

a StepFunctionsExecutionIntegrationOptions.Builder of StepFunctionsExecutionIntegrationOptions